• Projects
  • Service
  • About
  • branding.bz
  • Podcast
  • Tips
  • FAQ
  • Recruit
  • Download
  • Contact
  • branding.bz（ブランド構築SaaS）
  • DESIGN NOW（デザインメディア）
  • X
  • LinkedIn
  • Spotify
  • Facebook

213-0011 神奈川県川崎市高津区久本3-6-7-303

© 2026 ID INC. All rights reserved

claude-skills/スキル
SKILLOfficialdevelopment

aidp-catalog-explore

プラグイン
oracle-ai-data-platform-workbench-engineer-agent
ソース
GitHub で見る ↗
説明

AIDP データカタログ（データ資源の総合的な目録）を直接閲覧する機能です。カタログ、スキーマ（データベースの構造定義）、テーブル、ボリュームの一覧表示、テーブルの列やプロパティの確認、人間が付けた名前からカタログキーへの変換などができます。 次のような場合に使用: - ユーザーが「どのカタログ/スキーマ/テーブルが存在するか」と尋ねるとき - 「テーブルXについて説明してほしい」と聞かれるとき - 「Yにはどのような列があるか」と質問されるとき - 他の操作のためにカタログ/スキーマ/テーブルのキー（識別子）が必要なとき

原文を表示

Browse the AIDP data catalog live — list catalogs, schemas, tables, and volumes, inspect a table's columns/properties, and resolve a human name to its catalog key. Use when the user asks "what catalogs/schemas/tables exist", "describe table X", "what columns does Y have", or needs a catalog/schema/table key for another operation.

ユースケース
  • 存在するカタログやスキーマを確認する
  • テーブルの説明を確認する
  • テーブルの列を確認する
  • カタログキーを取得する
本文（日本語訳）

aidp-catalog-explore — ライブカタログブラウジング

コントロールプレーン経由でAIDPカタログを直接ブラウズ・検査します。SQL不要、コンピュート不要、MCP不要。 aidp-catalog-init の補完スキルです。アドホックなライブ検索にはこのスキルを、キャッシュ済みグラウンディングファイルの構築には catalog-init を使用してください。

次のような場合に使用

  • 「どんなカタログ／スキーマ／テーブルがあるか？」・「<テーブル> のカラムを説明／表示して」・「Xに関するテーブルを探して」
  • 別のスキルに渡すためのカタログ／スキーマ／テーブルの キー が必要な場合

エンジン — 公式 aidp CLI（コントロールプレーン、読み取り専用）

推奨エンジンはOracle公式の aidp CLI です。CLIがインストールされていない場合のフォールバックとして oci raw-request を使用します。 どちらも同一のデータプレーンREST APIに同一の認証で接続します。 完全なコマンドマップは references/aidp-cli-map.md、 ベースURL・認証ラダーは references/oci-raw-request.md を参照してください。

目的 CLI（推奨） RESTフォールバック（確認済み）
カタログ一覧 aidp catalog list GET /catalogs
カタログの詳細 aidp catalog get --catalog-key <cat> （list出力に含まれる）
カタログ内スキーマ一覧 aidp schema list --catalog-key <cat> GET /schemas?catalogKey=<cat>
スキーマ内テーブル一覧 aidp schema list-tables --catalog-key <cat> --schema-key <cat.schema> GET /tables?catalogKey=<cat>&schemaKey=<cat.schema>
テーブル単体の詳細 aidp schema get-table --catalog-key <cat> --schema-key <cat.schema> --table-key <t> GET /tables?… → クライアント側でテーブルキーにより絞り込み
ボリューム一覧 aidp volume list --catalog-key <cat> GET /volumes?catalogKey=<cat>（パラメータ形式未確定 — 400 が返った場合、エラーメッセージに必須パラメータ名が示される）

すべてのCLI呼び出しには --instance-id <DATALAKE_OCID> --auth api_key --profile DEFAULT --region <r> を付与します。

# CLI（推奨）: cat.schema 内のテーブル一覧を取得
aidp schema list-tables --catalog-key default --schema-key default.default \
  --instance-id <DATALAKE_OCID> --auth api_key --profile DEFAULT --region us-ashburn-1

# フォールバック（CLIなし）: oci raw-request、--profile DEFAULT（api_key）
oci raw-request --http-method GET \
  --target-uri "https://aidp.us-ashburn-1.oci.oraclecloud.com/20240831/dataLakes/<OCID>/tables?catalogKey=default&schemaKey=default.default" \
  --profile DEFAULT

401/403/"Security Token" エラーが発生した場合は認証ラダーに従ってください。 エンドポイントごとのRESTパラメータは 必須 です。パスのみを指定すると 400 InvalidParameter: query param X must not be null が返され、不足しているパラメータ名が示されます。 RESTの出力はJSON形式です: { "data": …, "headers": …, "status": <int> }

操作パターン

  • ツリーを上から辿る: aidp catalog list → aidp schema list --catalog-key <cat> → aidp schema list-tables --catalog-key <cat> --schema-key <cat.schema> → aidp schema get-table （RESTフォールバックの場合: GET /catalogs → GET /schemas?catalogKey= → GET /tables?… → テーブルで絞り込み）

  • テーブルの詳細を確認する: スキーマのテーブル一覧を取得し、テーブルキーでレスポンスを絞り込む。 そのテーブルオブジェクトからカラム・型・プロパティ・宣言済みキーを提示する。

  • 概念からテーブルを探す: まず .aidp/catalog.md のクイックリファレンスを確認する（即時）。 見つからない場合は /tables の名前およびテーブルオブジェクトをスキャンしてフォールバックする。

  • 表示名→キーの解決: ダウンストリームのスキルは表示名ではなくキーを必要とします。上記のlist呼び出しを使って変換してください。

注意事項

  • ワークスペース／DataLakeスコープです。事前にリージョンとDataLake OCIDを確認してください。
  • 繰り返し参照する場合はキャッシュ済みの .aidp/catalog.md を優先してください。 このスキルはライブ／未キャッシュの検査、またはキャッシュが古くなっている可能性がある場合に使用します（その際は aidp-catalog-init --refresh の実行を提案してください）。
  • aidp MCPが設定されている場合、その list_catalogs / list_schemas / list_tables / get_table / list_volumes ツールはオプションのアクセラレータとして利用できますが、必須ではありません。

参考資料

  • references/aidp-cli-map.md — スキル → 公式 aidp CLIコマンドマップ（プライマリエンジン）
  • references/oci-raw-request.md · references/no-mcp-rest-map.md
原文（English）を表示

aidp-catalog-explore — live catalog browsing

Browse and inspect the AIDP catalog directly via the control-plane — no SQL, no compute, no MCP required. Complements aidp-catalog-init: use this for ad-hoc, live lookups; use catalog-init to build the cached grounding file.

When to use

  • "What catalogs/schemas/tables are there?" · "describe / show columns of <table>" · "find tables about X"
  • You need a catalog/schema/table key to feed another skill.

Engine — official aidp CLI (control-plane, read-only)

Preferred engine is the official Oracle aidp CLI; oci raw-request is the fallback when the CLI isn't installed. Both hit the same data-plane REST API with the same auth — see references/aidp-cli-map.md for the full command map and references/oci-raw-request.md for base URL + auth ladder.

Goal CLI (preferred) REST fallback (verified)
List catalogs aidp catalog list GET /catalogs
Describe a catalog aidp catalog get --catalog-key <cat> (in list output)
List schemas in a catalog aidp schema list --catalog-key <cat> GET /schemas?catalogKey=<cat>
List tables in a schema aidp schema list-tables --catalog-key <cat> --schema-key <cat.schema> GET /tables?catalogKey=<cat>&schemaKey=<cat.schema>
Describe a single table aidp schema get-table --catalog-key <cat> --schema-key <cat.schema> --table-key <t> GET /tables?… then filter by table key client-side
List volumes aidp volume list --catalog-key <cat> GET /volumes?catalogKey=<cat> (param shape TBD — if 400, the error names the required param)

All CLI calls take --instance-id <DATALAKE_OCID> --auth api_key --profile DEFAULT --region <r>.

# CLI (preferred): list tables in cat.schema
aidp schema list-tables --catalog-key default --schema-key default.default \
  --instance-id <DATALAKE_OCID> --auth api_key --profile DEFAULT --region us-ashburn-1

# Fallback (no CLI installed): oci raw-request, --profile DEFAULT (api_key)
oci raw-request --http-method GET \
  --target-uri "https://aidp.us-ashburn-1.oci.oraclecloud.com/20240831/dataLakes/<OCID>/tables?catalogKey=default&schemaKey=default.default" \
  --profile DEFAULT

On 401/403/"Security Token" follow the auth ladder. Per-endpoint REST params are required — a bare path returns 400 InvalidParameter: query param X must not be null, which names the missing param. REST output is JSON: { "data": …, "headers": …, "status": <int> }.

Patterns

  • Browse down the tree: aidp catalog list → aidp schema list --catalog-key <cat> → aidp schema list-tables --catalog-key <cat> --schema-key <cat.schema> → aidp schema get-table (or the REST fallback GET /catalogs → GET /schemas?catalogKey= → GET /tables?… → filter for the table).
  • Describe a table: list tables for the schema, then filter the response by table key; present columns, types, properties, and any declared keys from that table object.
  • Find by concept: check .aidp/catalog.md Quick Reference first (instant); fall back to scanning /tables names + table objects for the concept.
  • Resolve name→key: downstream skills need keys, not display names — use these list calls to translate.

Notes

  • Workspace/DataLake-scoped — confirm the region + DataLake OCID first.
  • Prefer the cached .aidp/catalog.md for repeated lookups; this skill is for live/uncached inspection or when the cache may be stale (then suggest aidp-catalog-init --refresh).
  • If an aidp MCP is configured, its list_catalogs / list_schemas / list_tables / get_table / list_volumes tools are an optional accelerator — not required.

References

  • references/aidp-cli-map.md — skill → official aidp CLI command map (primary engine)
  • references/oci-raw-request.md · references/no-mcp-rest-map.md

原文・著作権は Anthropic および各プラグイン作者に帰属します。日本語訳は Claude API による自動翻訳です。