SuperAPI AI 工具集

mz-developer-analysis

智能体与模型

查看项目

更新于 10-16 00:06

技能介绍

用途:分析 Materialize 环境的健康状况、性能与优化空间,通过 MCP Developer 端点的 query_system_catalog 工具查询系统目录表,输出结构化报告。

主要能力:盘点已部署对象(源、物化视图、视图、汇、索引、连接);分析新鲜度(mz_internal.mz_materialization_lag)、水合状态(mz_hydration_statuses)、集群副本利用率与内存指标;使用内置索引建议(mz_index_advice)识别可删除或可转为视图的对象;可选成本分析(mz_catalog.mz_cluster_replica_sizes 的信用费率)。

使用方式:先确认 MCP 连接,运行 query_system_catalog: SELECT mz_version()。查询约束为每次一条语句、只读(SELECT/SHOW/EXPLAIN)、仅系统表、不支持 SET。若存在 mz_ontology 模式,可用其发现表、列、连接路径与 ID 类型;否则用 SHOW COLUMNS FROM <schema>.<table> 校验列名。注意常见列名陷阱:mz_source_statuses/mz_sink_statuses 用 last_status_change_at 而非 updated_at;mz_cluster_replica_utilization 需经 replica_id 连接 mz_cluster_replicas 与 mz_clusters。禁止查询 mz_introspection.mz_dataflow_arrangement_sizes(集群作用域且 id 为 uint8 类型不匹配)。mz_introspection 视图的 ID 为 uint8,与 mz_catalog 连接需显式转换;mz_internal 视图使用文本 ID,可安全连接。

适用场景:物化视图为何过期、集群为何内存不足、源是否健康或快照是否完成、环境整体健康检查、可优化节省成本的对象。

限制:所有查询只读,仅限系统目录表,无法访问用户数据;访问受 RBAC 控制;新鲜度数值为时间点快照,需重复运行判断延迟是否稳定或增长。报告建议应包含具体 SQL 命令并量化信用影响。