スキルOfficialdevelopment

📚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 による自動翻訳です。