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 流程的支持认证。使用替代路径或判断问题已修复前,请重测实际部署组合。
工具 |
被测版本 |
验证范围 |
|---|---|---|
v0.64.1.5 |
已验证 SQL 模型、指标与仪表板;自动同步存在限制 |
|
6.1.0 |
部分类型的 SQL Lab / 图表 API 失败;视图反射失败 |
|
13.2.3 (MySQL plugin 13.1.2) |
被测组合的原生数据源连接失败 |
|
26.9.0 / mysqlclient 2.1.1 |
原生查询执行器已验证;Decimal JSON 精度存在限制 |
|
2.10.17 / Connector/J 8.2.0 |
已验证保存数据源与 SQL 预览 API;预览有行数限制 |
|
@evidence-dev/mysql 1.1.6 |
原生连接器失败;诊断补丁不是正式配置方法 |
|
0.90.5 |
已验证原生导入与指标;本地引擎与精度限制 |
|
0.12.0 / Connector/J 8.4.0 |
已验证保存 JDBC 笔记本执行;文本格式存在限制 |
|
7.5.7 |
已验证原生 REST 查询与保存 SQL;已归档的旧工具 |
|
2.573.1 |
没有原生 MySQL 仓库适配器;未直接查询 MatrixOne |
已有流程请参考 FineBI、永洪 BI 和 Superset 监控教程。新增 Superset 指南补充按版本的业务分析核对,保留原有历史教程。
集成验证顺序¶
执行
SELECT 1,记录 MatrixOne 和驱动版本。执行公共总计、分类及每日查询,核对完整结果、空值及 Decimal 小数位。
保存并重新打开查询或模型,筛选分类
A,净额应为130.000000。检查 BI 实际生成的 SQL。退款应先按订单聚合再关联;客户去重应按当前分组层级重新计算。
检查预览和导出行数限制,以及序列化后的 Decimal。小金额图表正确不代表大金额精度可靠。
确认聚合是在 MatrixOne 下推执行,还是像 Rill 一样导入后在本地引擎执行。核对时效性前先刷新导入数据。