SuperAPI AI 工具集

mz-adapter-guide

编程与开发

查看项目

更新于 10-16 00:06

技能介绍

用途:面向 Materialize 代码库中适配层(adapter)及其相关 crate 的开发工作,帮助开发者遵循既有的正确性不变量与架构约定。

主要能力:要求在改动适配层相关代码前,先阅读并遵循 doc/developer/guide-adapter.md;该文档包含正确性不变量、架构说明,以及因正确性原因被尝试过又否决的优化列表。涉及 timestamp oracle(src/timestamp-oracle/)时,还需阅读 src/timestamp-oracle/src/lib.rs 与 src/timestamp-oracle/src/batching_oracle.rs 的模块级文档,了解 TimestampOracle trait 契约以及批处理与线性一致性不变量。

使用方式:技能触发条件是关于这些子系统的问题,例如“how does…”;开始工作时应立即阅读 doc/developer/guide-adapter.md。当发现某种做法不正确或方向错误时,建议把经验提炼进 doc/developer/guide-adapter.md,可新增正确性不变量、在现有不变量下加子节、加入被否决的优化,或按需新增顶层章节,并说明尝试了什么、为何错误及相关背景。

适用场景:适配层、coordinator、pgwire、peek 路径、timestamp oracle 等子系统的开发与问题排查。

限制:资料未提供具体函数、接口或安装命令等细节,相关实现细节暂未提供。