连接 Metabase 并构建指标¶
先完成公共连接准备和数据集初始化。下述按版本记录的观察使用概览中标明的 MatrixOne 二进制。
配置连接¶
先安装并初始化 Metabase;被测版本为 v0.64.1.5,内置 MariaDB JDBC 驱动为 2.7.15。
在管理后台的数据库设置中新增 MySQL 数据库。
填写主机
MO_HOST、端口6001、数据库bi_tutorial,以及只读用户名和密码。对被测本地无 TLS 实例,添加以下 JDBC 连接选项:
usePipelineAuth=false&useBatchMultiSend=false&useSsl=false
前两个选项关闭 MariaDB 驱动的流水线认证及批量多次发送。SSL 请按部署情况单独配置。被测组合的默认流水线认证失败,见 MatrixOne #24161。
保存显式 SQL 模型¶
被测版本的自动元数据同步遇到 SHOW GRANTS FOR CURRENT_USER() 和字段同步错误,见 #29952。发现表列表为空不代表数据库无数据。遇到该情况时使用显式 SQL 模型:
在此连接上新建 SQL 查询,执行下列语句并核对四行结果。
SELECT order_id, customer_id, ordered_at, category, region, quantity,
gross_amount, refund_amount, net_amount, cost_amount
FROM bi_tutorial.order_metrics
保存为
Paid order metrics,转换成 Model(模型)。检查列元数据:ID 和数量为数值,ordered_at为日期时间,分类和地区为文本,金额列为 Decimal 数值。从保存的模型新建问题,汇总 net_amount 求和,结果应为
410.000000。按category分组应得到A=130.000000、B=280.000000。若安装版本提供指标编辑器,将定义保存成指标,源模型保留后续筛选所需维度。另建 customer_id 去重计数,整体结果应为
3。将保存的问题加入仪表板,将分类筛选器映射到模型的
category。选择A时,净额应为130.000000,购买客户数为2。保存、重新打开并刷新仪表板。
被测 API 流程先创建 type: "model" 的原生 SQL 卡片,再由查询构建器通过 card__<model-id> 引用。指标卡片使用 type: "metric"。这些是 Metabase 保存对象,不是 SQL CREATE VIEW。
验证边界¶
已验证此替代路径中的保存模型、查询构建器指标、带筛选的仪表板请求和浏览器实际渲染。该路径没有修复自动元数据同步。另观察到 Boolean 转 Number 的字段同步异常,不能假定修正授权查询即可解决全部同步错误。模型变更后请重新检查源 SQL 与指标预期结果。