spanner-data について
spanner-dataは、Google Spannerのデータ照会とユーザー作成スキーマの確認に使うスキルです。GoogleSQLインターフェースによるSQL実行と、テーブルやグラフのスキーマ一覧を提供します。
主な機能
- 01DML SQLの実行
- 02DQL SQLの実行
- 03グラフスキーマの一覧表示
- 04テーブルスキーマの一覧表示
- 05名前によるスキーマ一覧の絞り込み
活用シーン
- 01Spannerでデータ変更SQLを実行する
- 02DQLで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 |