SuperAPI AI 工具集

mz-sql-navigation

数据与分析

查看项目

更新于 10-16 00:07

技能介绍

用途:在 mz-deploy 项目(含 project.toml 的目录)中阅读或编辑 .sql 文件时,用语言服务器(LSP)解析对象图,而不是用文本搜索。grep 只能找到看起来像对象名的字符串,语言服务器能找到真正的对象。

主要能力:跳转定义,解析被引用的 view、table、source 或 index 定义位置,可跨 schema;悬停,查看对象的列及其类型,无需打开定义;文档符号,列出单个 .sql 文件定义的对象;工作区符号,在不知道文件时按名称定位对象。修改对象前,可用这些能力查找依赖它的对象。在 Materialize 中,view 的定义约束其下游所有内容,因此单独能通过类型检查的修改仍可能破坏依赖方。

诊断:每次编辑后自动显示解析错误,其语法判断具有权威性,来自 mz-deploy 构建项目所用的同一解析器。

要求与限制:mz-deploy 必须在 PATH 中(可用 which mz-deploy 检查)。若服务器看似正常但所有导航请求都返回空,通常是插件的 mz-deploy 项目目录设置指向了非 project.toml 所在目录;服务器以该目录为项目根,项目嵌套在子目录时需将设置指向该子目录。遇到此情况应报告,而不是退回 grep,过期的设置值得修复一次。资料未提供安装命令、收费与平台信息。