MatrixOne v26.4.2.2 发布说明

发布日期:2026年9月18日 MatrixOne 版本:v26.4.2.2(v4.2.2)

MatrixOne v26.4.2.2 引入了两个新的外部数据外部表引擎(ENGINE = SQL|ESQL 与 ENGINE = KAFKA)、文件型外部表逐行错误报告、FULLTEXT2 全文索引引擎、带会话缓存外部连接的 SQL_TVF()/ESQL_TVF() 表函数、LAST_KAFKA_MESSAGE_ID()、mo_rollback_txn_on_error 事务控制变量,以及 Starlark 存储过程的结构化错误码。

新功能

  • ENGINE = SQL|ESQL 外部表:CREATE EXTERNAL TABLE ... ENGINE = SQL|ESQL 将 MatrixOne 外部表映射到外部 SQL 数据库或 Elasticsearch ES|QL 源,其行数据由扫描时通过隐藏列 __mo_query 或 query 表选项提供的查询文本产生。config 选项携带连接(或回退到 @sql_tvf_config/@esql_tvf_config),pushdown(仅 SQL)让数据源应用 MatrixOne 能翻译的谓词。

  • ENGINE = KAFKA 外部表:CREATE EXTERNAL TABLE ... ENGINE = KAFKA 将 MatrixOne 外部表映射到 Apache Kafka 主题的单个分区,支持 brokers、topic、partition、autocommit、group、format、separator 选项、逐消息 __mo_* 元数据列以及由 WHERE 驱动的读取控制。

  • 外部表错误模式:External Table Error Mode 新增隐藏列 __mo_file_line、__mo_error_message 与 __mo_error_text,使 CSV 或 JSONLine 扫描能把正常记录与坏记录分别写入不同表,而不是在第一条坏记录处失败。

  • FULLTEXT2 索引:CREATE FULLTEXT2 INDEX 构建 WAND 位置式全文索引,支持精确短语自然语言检索、布尔与 BM25 模式,提供 ngram、gojieba、json、json_value 解析器,以及 INCLUDE 列与 AUTO_UPDATE 周期等索引选项。它受 experimental_fulltext2_index 控制。

  • SQL_TVF() 与 ESQL_TVF():SQL_TVF() 与 ESQL_TVF() 在 MatrixOne 查询中查询外部 SQL 数据库或 Elasticsearch 集群。Foreign Connection Functions 管理会话级连接缓存,上限为 16 个连接。

  • LAST_KAFKA_MESSAGE_ID():LAST_KAFKA_MESSAGE_ID() 返回已完成的 Kafka 扫描返回的最后一条消息的 offset,作为 __mo_read_start_id 回填时实现精确一次消费。

  • mo_rollback_txn_on_error:mo_rollback_txn_on_error 让会话选择把任何语句错误视为对整个打开事务的致命错误,而不是 MySQL 默认的仅回滚失败语句。

  • Starlark 存储过程错误码:Starlark Procedure Error Reporting 新增 mo.errno() 与 mo.sqlstate(),使 Starlark 存储过程能按失败 mo.sql() 调用的错误类别分支,而非匹配消息文本。

行为变更

  • FULLTEXT2 相关性:FULLTEXT2 引擎默认采用 BM25 排序,并可通过 ft2_relevancy_algorithm 配置(BM25 或 TF-IDF)。

关于本文档

本文档由文档同步 Agent 根据 MatrixOne 源码 diff 自动生成,并通过 PR 进行人工审核。

完整变更日志

v4.2.1…v4.2.2