Rill 数据导入与原生指标¶
先完成公共连接准备和数据集初始化。下述按版本记录的观察使用概览中标明的 MatrixOne 二进制。
创建项目¶
安装 Rill,被测版本为 0.90.5。项目目录包含 rill.yaml、connectors/、models/ 和 metrics/。rill.yaml 内容为:
compiler: rillv1
创建 connectors/mysql.yaml,下例为本地测试配置。实际配置请私密保存,远程部署应选择合适的 SSL 模式及证书。
type: connector
driver: mysql
host: MO_HOST
port: 6001
database: bi_tutorial
user: MO_USER
password: REPLACE_WITH_PASSWORD
ssl-mode: DISABLED
创建 models/order_metrics.yaml:
type: model
connector: mysql
sql: SELECT * FROM bi_tutorial.order_metrics
创建 metrics/order_metrics_metrics.yaml:
type: metrics_view
model: order_metrics
timeseries: ordered_at
dimensions:
- name: category
column: category
- name: region
column: region
measures:
- name: paid_orders
expression: COUNT(*)
- name: net_amount
expression: SUM(net_amount)
- name: buyers
expression: COUNT(DISTINCT customer_id)
- name: unit_price
expression: SUM(gross_amount)/NULLIF(SUM(quantity),0)
在父目录启动项目,将 PROJECT_DIR 替换为项目路径:
rill start PROJECT_DIR --no-open --port 33004 --port-grpc 49004 --pull-env=false
模型导入完成后再查询指标视图。限制本地开发服务访问,并将连接密码排除在版本控制之外。
查询原生指标¶
本地运行时接受 POST /v1/instances/default/queries/metrics-views/order_metrics_metrics/aggregation,JSON 请求体为:
{
"dimensions": [{"name": "category"}],
"measures": [{"name": "net_amount"}, {"name": "buyers"}],
"sort": [{"name": "category"}],
"limit": "10000",
"exact": true
}
公共数据集的分类 A 净额应为 130、客户数为 2;分类 B 净额为 280、客户数为 2。不带维度的聚合应返回整体客户数 3,不能将分类客户数相加。导入和 API 核对通过后再使用安装版本的 UI 查看指标视图;兼容性测试执行的是运行时 API,未覆盖浏览器仪表板。
执行位置与精度¶
此路径通过原生 MySQL 连接器导入行,再在 Rill 本地 DuckDB 引擎执行指标。它验证导入及 Rill 指标定义,不是将这些聚合下推到 MatrixOne 的测试。源数据变化后需要重新导入,公共物理快照也需刷新。
被测导入将源 Decimal 转成 DOUBLE。部分差异仅为低于六位小数尺度的浮点尾差,另一些大 Decimal 出现实质精度损失,应分别核对。exact: true 要求精确聚合行为,但不能恢复导入时已损失的精度。财务对账前请核对公共预期结果和高精度传输示例。