应用开发者指南¶
本指南面向使用 MatrixOne 构建应用的开发者,按 v4.2.5 的接口组织从连接到上线的路径。源码贡献者使用贡献指南。
第一条应用链路¶
从教程到真实应用¶
生产前检查¶
固定服务端/驱动/连接器/Operator 版本及开关。MySQL 接入兼容范围按兼容页逐项检查,包括 ORM 反射、生成 DDL、事务、时区和返回类型。连接成功不认证 binlog 源或所有生态操作。
查询优化先看正确结果、数据粒度和计划,再看扫描、连接分布、内存/Spill、缓存与 I/O。性能报告记录数据、硬件、并发、运行时间和错误率。
单机示例完成后,在目标拓扑验证断线、取消、节点重启和恢复。外部文件、模型服务及目标 connector 的副作用不自动由数据库事务回滚。部署和备份工具是独立版本,恢复需要真实演练。
驱动字符集与返回值探针¶
握手字符集与返回列元数据需要分别验证。2026-10-14 在 v4.2.5 和 mysql2 3.22.6 的最小查询中,空间😀 返回为 空间����,列字符集标记为 33,但服务端 HEX 值是正确 UTF-8 字节;PyMySQL 的 utf8mb4 路径能回读原值。这个记录只覆盖上述组合。
SELECT HEX('空间😀') AS utf8_bytes;
预期为 E7A9BAE997B4F09F9880。应用还应使用真实驱动查询原字符串并逐字符比较,同时保存字段元数据。为握手设置支持的 collation 不会自动纠正列解码。需要非 BMP 字符的应用应把该组合列为待修复/需适配验证项,并独立验证表示转换路径;不能仅以连接成功判定兼容。