关于 spanner-data
spanner-data 是用于查询 Google Spanner 数据和检查用户自建架构的技能,提供 SQL 执行以及表和图架构列表脚本,并使用 GoogleSQL 接口。
主要功能
- 01执行 DML SQL
- 02执行 DQL SQL
- 03列出图架构
- 04列出表架构
- 05按名称筛选架构列表
适用场景
- 01在 Spanner 中执行数据修改 SQL
- 02使用 DQL 查询 Spanner 数据
- 03检查图的标签和属性
- 04查看表的列、约束和索引
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ cline/ skills --skill spanner-data安装后在 Claude Code 中输入/spanner-data确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
scripts/execute_sql_dql.jsexecute_sql.jslist_graphs.jslist_tables.js详细介绍
用法
所有脚本都可以使用 Node.js 执行。将 <param_name> 和 <param_value> 替换为实际值。
Bash:
node <skill_dir>/scripts/<script_name>.js '{"<param_name>": "<param_value>"}'
PowerShell:
node <skill_dir>/scripts/<script_name>.js '{\"<param_name>\": \"<param_value>\"}'
注意:脚本会自动从各种 .env 文件加载环境变量。除非技能执行因缺少环境变量而失败,否则不要要求用户设置变量。
脚本
execute_sql
使用此工具执行 DML SQL。对于 Spanner,请使用 googlesql 接口。
参数
| 名称 | 类型 | 描述 | 必填 | 默认值 |
|---|---|---|---|---|
| sql | string | 要执行的 sql。 | 是 |
execute_sql_dql
使用此工具执行 DQL SQL。对于 Spanner,请使用 googlesql 接口。
参数
| 名称 | 类型 | 描述 | 必填 | 默认值 |
|---|---|---|---|---|
| sql | string | 要执行的 sql。 | 是 |
list_graphs
以 JSON 格式列出用户创建的图的详细架构信息(节点表、边表、标签和属性声明)。按逗号分隔的图名称列表进行筛选。如果未指定名称,则列出所有图。输出可以是“simple”(仅图名称)或“detailed”(完整架构)。
参数
| 名称 | 类型 | 描述 | 必填 | 默认值 |
|---|---|---|---|---|
| graph_names | string | 可选:逗号分隔的图名称列表。如果为空,则列出用户可访问架构中的所有图的详细信息。 | 否 | `` |
| output_format | string | 可选:使用 'simple' 仅返回图名称,或使用 'detailed' 返回完整信息架构。 | 否 | detailed |
list_tables
以 JSON 格式列出用户创建的表(普通表或分区表)的详细架构信息(对象类型、列、约束、索引)。按逗号分隔的名称列表进行筛选。如果未指定名称,则列出用户架构中的所有表。输出可以是“simple”(仅表名称)或“detailed”(完整架构)。
参数
| 名称 | 类型 | 描述 | 必填 | 默认值 |
|---|---|---|---|---|
| table_names | string | 可选:逗号分隔的表名称列表。如果为空,则列出用户可访问架构中的所有表的详细信息。 | 否 | `` |
| output_format | string | 可选:使用 'simple' 仅返回表名称,或使用 'detailed' 返回完整信息架构。 | 否 | detailed |