Evidence MySQL 数据源与兼容性核对¶
先完成公共连接准备和数据集初始化。下述按版本记录的观察使用概览中标明的 MatrixOne 二进制。
配置数据源¶
按照上游数据源文档创建 Evidence 项目并启用 MySQL 插件,被测包为 @evidence-dev/mysql 1.1.6。
创建 sources/matrixone/connection.yaml:
name: matrixone
type: mysql
options:
host: MO_HOST
port: 6001
database: bi_tutorial
user: MO_USER
password: REPLACE_WITH_PASSWORD
ssl: "false"
上述 SSL 设置仅复现本地无 TLS 测试。远程连接请按连接器支持的设置配置 TLS。凭证应保存在私有本地配置或部署密钥机制中,不要放进公开项目。
如果实际版本的原生连接通过,将公共分类 SQL 放入 sources/matrixone/category_net.sql。使用项目的数据源刷新命令,通常为 npm run sources,构建页面前先核对导入的两行数据。之后页面可按安装版本的查询语法读取 matrixone.category_net。数据抽取与页面本地查询不同于在 MatrixOne 上执行 SQL。
已知限制与数值传输¶
未修改的数据源连接器在被测 MatrixOne 上执行原生查询时出现 Can't add new command when connection is in closed state。诊断中替换 mysql2.createConnection 选项、改用 general 排序规则后,对照查询可执行;此操作改变了应用运行行为,不是正式配置步骤。
1.1.6 包转发用户、主机、数据库、密码、端口、套接字及 SSL 配置,但不会转发任意 charset 数据源选项。在 YAML 中添加 charset 尚不能作为已验证修复。独立排序规则对照及 #29206 可供参考,但不证明 Grafana 与 Evidence 的故障原因完全相同。
连接器还启用 decimalNumbers: true,将 Decimal 转为 JavaScript 数值。诊断查询路径中,部分大金额或高精度值发生实质精度损失,导入后请执行大 Decimal 核对。被测失败组合未验证原生 Evidence 报告构建和浏览器页面,不能把诊断结果当成端到端可用教程。