mcpField
C
carto-explore-datawarehouse

carto-explore-datawarehouse

github.com/cartodbデータ・データベース656 回インストール1 週間前に更新
リポジトリ

carto-explore-datawarehouse について

carto-explore-datawarehouseは、クエリやマップ作成の前に接続、テーブル、列、名前付きソースを調べるスキルです。利用可能なCARTO MCPツールを優先し、権限が限られる場合やスクリプト実行ではCLIを代替として使います。

主な機能

  1. 01接続の一覧表示と確認
  2. 02プロジェクト・データセット・テーブル階層の参照
  3. 03テキストによるリソース検索
  4. 04テーブルの列と型の確認
  5. 05名前付きソースの検索と確認

活用シーン

  1. 01クエリ作成前にテーブルを検索
  2. 02SQL作成前に列型を確認
  3. 03名前で指定されたソースを特定
  4. 04スクリプトまたはヘッドレス環境でデータを調査

MCP 対応

接続やリソースの確認には、主に`explore_data`や`manage_named_sources`などのCARTO MCPツールを使います。MCPサーバーが利用できない場合や必要な権限範囲がない場合は、CARTO CLIが代替になります。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/cartodb/agent-skills --skill carto-explore-datawarehouse

インストール後、Claude Code で/carto-explore-datawarehouseを入力して読み込まれたか確認します。

同梱ファイルreferences/connection-browse.mdreferences/named-sources.md

詳細

carto-explore-datawarehouse

SQL を書いたりマップを作成したりする前に、エージェントは通常、データウェアハウスに何があるかを把握する必要があります。このスキルでは、MCP と CLI に対応したデータの探索方法を説明します。

タスクMCP（主な方法）CLI（代替手段）
接続の一覧表示／確認explore_data（list_connections、get_connection）carto connections list ／ get
階層をたどる（プロジェクト → データセット → テーブル）explore_data（list_resources）carto connections browse
リソースを全文検索するexplore_data（search）—
テーブルのカラムと型を確認するexplore_data（describe）carto connections describe
名前付きソースを検索／確認するmanage_named_sources（list、get）carto named-sources list ／ get

アクセス経路の振り分け。 explore_data はアタッチされた MCP セッションであれば利用できますが、トークンセッションではすべてのメソッドを利用できるわけではありません。list_connections、list_resources、search に必要なのは MCP Server スコープのみですが、describe にはトークンセッションで Maps API も必要です（OAuth では常に利用できます）。manage_named_sources はオーサリングツールのため、OAuth セッションが必要です（トークンセッションでは非表示になります）。サーバーがアタッチされていない場合、トークンに describe のスコープがない場合、または探索をスクリプトやヘッドレス環境で実行する場合は、carto connections ／ carto named-sources CLI を使用してください。判定シグナルと振り分けの全表については、carto-basics/references/access-paths.md を参照してください。

このスキルを使う場面

  • 接続内にどのテーブル／スキーマがあるかわからない場合。
  • SQL の作成やマップのオーサリングの前に、カラム一覧と型が必要な場合。
  • ユーザーが「X の名前付きソース」と言及し、それを見つける必要がある場合。

テーブルがすでにわかっていて、クエリを実行したいだけの場合は、carto-query-datawarehouse に進んでください。

エンジン別のパス構文

list_resources ／ describe（または connections browse ／ describe）に渡すパスは、エンジンによって異なります。

エンジンパスの形式
BigQueryproject.dataset.table
SnowflakeDATABASE.SCHEMA.TABLE
Postgres ／ Redshiftschema.table（先頭にプロジェクト／データベースは付けません）
Databrickscatalog.schema.table

CLI の例：

carto connections browse <name>                                  # top level
carto connections browse <name> "carto-demo-data.demo_tables"    # drill in
carto connections describe <name> "carto-demo-data.demo_tables.nyc_collisions"

このスキルの内容

トピックリファレンス
接続の詳細な参照と説明references/connection-browse.md
名前付きソース — その概要と一覧表示・確認方法references/named-sources.md

常に適用されるガイダンス

  • クエリの前に参照してください。 2 秒で済む list_resources により、「テーブルが見つからない」という 5 分間の試行錯誤を避けられることがよくあります。
  • describe はカラムの型を返します。 正しい SQL を書くために活用してください（たとえば、geom という名前を誤って付けられた STRING カラムに対して ST_DWithin を実行しないでください）。
  • 長い一覧はページネーションしてください。 CLI の browse はデフォルトで --page-size 30 です。テーブルが何百もあるデータセットでは、値を大きくしてください。
  • 名前付きソースはテーブルではありません。 名前付きソースはパラメーター化されたクエリです。ソースに見えるカラムがそのまま存在すると決めつける前に、基盤となるテーブルを確認してください。
  • carto-demo-data は CARTO が提供する公開 BigQuery データセットです。適切な IAM を持つ BigQuery 接続であれば参照できるため、顧客データに触れることなく、新しい接続を手早く検証できます。

コメント

Markdown 対応