BI 集成概览

上级索引:MatrixOne 生态工具总览。

选择下方教程连接 BI 工具,并用可复现的小型业务数据核对分析结果。连接测试成功并不代表元数据发现、保存指标、Decimal 序列化和仪表板全部可用。

前置准备

按照单机部署指南安装 MatrixOne,并按照上游说明安装所选 BI 工具。数据库地址必须能被 BI 服务进程访问,MatrixOne 的 MySQL 协议端口通常为 6001。容器中的 localhost 指向该容器,应使用 MatrixOne 服务名或可访问的主机地址。

管理员先准备公共数据集与指标核对示例,再用只读的 bi_reader 账号连接 BI。将 MO_HOST、MO_USER 和密码占位符替换为部署配置,URI 中的密码需要百分号编码。非默认账号请使用对应的 MatrixOne 账号限定用户名。

明确关闭 TLS 的配置仅用于复现本地隔离测试。远程连接请配置 MatrixOne TLS 及工具端的 CA 和主机名验证,并相应调整驱动选项。本轮兼容性验证未覆盖 TLS 配置。

按版本记录的兼容性观察

下表记录于 2026-10-13,使用 MatrixOne 提交 23d8f61252f3017dff218b530817a240206fd762 对应的二进制,版本字符串为 8.0.30-MatrixOne-v。MySQL 兼容版本字符串不能唯一标识 MatrixOne 发布版本。这些是特定二进制和工具版本的历史观察,不代表所有 MatrixOne 版本和全部 UI 流程的支持认证。使用替代路径或判断问题已修复前,请重测实际部署组合。

工具

被测版本

验证范围

Metabase

v0.64.1.5

已验证 SQL 模型、指标与仪表板;自动同步存在限制

Superset

6.1.0

部分类型的 SQL Lab / 图表 API 失败;视图反射失败

Grafana

13.2.3 (MySQL plugin 13.1.2)

被测组合的原生数据源连接失败

Redash

26.9.0 / mysqlclient 2.1.1

原生查询执行器已验证;Decimal JSON 精度存在限制

DataEase

2.10.17 / Connector/J 8.2.0

已验证保存数据源与 SQL 预览 API;预览有行数限制

Evidence

@evidence-dev/mysql 1.1.6

原生连接器失败;诊断补丁不是正式配置方法

Rill

0.90.5

已验证原生导入与指标;本地引擎与精度限制

Apache Zeppelin

0.12.0 / Connector/J 8.4.0

已验证保存 JDBC 笔记本执行;文本格式存在限制

SQLPad

7.5.7

已验证原生 REST 查询与保存 SQL;已归档的旧工具

Lightdash

2.573.1

没有原生 MySQL 仓库适配器;未直接查询 MatrixOne

已有流程请参考 FineBI、永洪 BI 和 Superset 监控教程。新增 Superset 指南补充按版本的业务分析核对,保留原有历史教程。

集成验证顺序

  1. 执行 SELECT 1,记录 MatrixOne 和驱动版本。

  2. 执行公共总计、分类及每日查询,核对完整结果、空值及 Decimal 小数位。

  3. 保存并重新打开查询或模型,筛选分类 A,净额应为 130.000000。

  4. 检查 BI 实际生成的 SQL。退款应先按订单聚合再关联;客户去重应按当前分组层级重新计算。

  5. 检查预览和导出行数限制,以及序列化后的 Decimal。小金额图表正确不代表大金额精度可靠。

  6. 确认聚合是在 MatrixOne 下推执行,还是像 Rill 一样导入后在本地引擎执行。核对时效性前先刷新导入数据。

工具教程