ae-metadata

ae-metadata

CLI ドメイン metadata は、認証ヘッダー cli-token を使用して、分析機能ゲートウェイ（/api/cli/analysis/v1/...）にルーティングします。

ゲートウェイ経由のデータテーブルおよびプロパティディメンションテーブルの操作には、このスキルを使用してください。

機能の仕様

• 責務：以下のコマンドを使用したデータテーブルの管理とディメンションテーブルのバインド。
• 入力：検証済みのプロジェクト、テーブル／プロパティ識別子、操作固有のパラメーター。ローカル CSV ワークフローには、有効なアップロード済み入力ファイル識別子と用途が必要です。
• 出力：テーブル／バインド操作の結果、リソース識別子、またはダウンロードの実行／成果物のステータス。非同期ダウンロードを送信した時点では、ファイルはまだ完成していません。
• 対象範囲外：ローカル入力ファイルのアップロード、イベント／プロパティの詳細情報と検索、メトリックの CRUD、仮想メタデータ、一括メタデータ、プロジェクト設定、トラッキングプランは、それぞれ別の機能です。
• 完了条件：要求されたテーブルまたはバインドの結果を検証するか、保留中／ブロック中の作業と残りの要件を報告します。

スキル間の連携

残りの作業がこのスキルの対象範囲外である場合、または必要な前提条件に別の機能が必要な場合は、連携プロトコルに従ってください。今回の実行で利用可能なスキルから機能に応じて選択し、検証済みのコンテキストを保持して、残りの作業を続けます。このプロトコルがすでに読み込まれている場合は、再利用してください。

グローバル AE CLI ルール

パラメーター	説明
--format <json|table>	出力形式です。デフォルトは JSON です。
--jq <expr>	JSON 出力に適用する jq フィルターです。
--host <url>	アクティブな AE ホストを上書きします。例：ae-cli metadata data-table list --host <url> ...
--validate	任意：パラメーターのみを修正します（/validate）。複雑な qp やペイロードを調整する際は、これだけを実行してから本番実行します。--dry-run と併用しないでください。
--dry-run	任意：実行可能な状態かを確認します（/dry-run）。リスクや出力をプレビューする場合に単独で実行します。--validate と併用しないでください。

出力とエラー：

• 成功：JSON エンベロープ（デフォルト）です。オプションで _notice.host_compat が含まれることがあります。
• 失敗：{ "ok": false, "error": { "type", "message", "hint" } }。終了コードはゼロ以外です。
• 重要 — ホスト互換性（最初に実施）： ae-cli の実行後は毎回、stderr と _notice.host_compat を確認してください。どちらかが存在する場合は、ユーザーへの返信の冒頭に短い ⚠️ バージョン警告を記載し、npm i -g / npx skills add（または update-cluster）の行をそのまま引用してから、業務上の結果を提示してください。これはソフトな注意喚起です。ok: true でも通知が含まれる場合があります。

安全性：

• 読み取り専用コマンドは、ID／名前を確認した後であれば直接実行できます。
• 通常の書き込み（data-table *-write、property-bindings-update、ディメンションテーブルのバインド／作成）は、--yes なしで実行します。削除コマンドは high-risk-write です。まずドライランを行い、影響を要約して、明示的な確認を待ってから --yes を付けて実行してください。
• コマンドを実行する前に必ず、対応する references/<name>.md を読んでください（ファイル名は、コマンド内の空白をアンダースコアに置き換えたものです。例：metadata data-table list → metadata_data_table_list.md）。
• project_id、イベント／プロパティ名、input_file_id、data_table_id を決して推測しないでください。確認済みの名前を再利用するか、メタデータ検索機能を見つけてください。データテーブル ID は metadata data-table list で検索してください。
• metadata data-table download は非同期のアーティファクトコマンドです。通常の実行ではジョブを送信し、--wait は完了を待機し、--output <file> は完了を待ってからアトミックにストリーミングします。analysis run wait で再開できます。ローカルで処理が中断されても、リモート実行はキャンセルされません。
• メンバーの自然日ごとのクォータには、使用統計の対象となるすべての Gateway 機能の execute 呼び出しが含まれます（ユーザーを識別でき、統計が有効な場合）。メタデータのみの読み取り、プレビュー、テーブル／バインディングの書き込み、アセットのエクスポート、ジョブを送信するダウンロードも対象です。データベースエンジンや業務目的には左右されません。キャッシュヒット、繰り返しの呼び出し、再利用された実行、execute 内での失敗も対象で、スキーマエラー、権限拒否、不明な機能 ID も含まれます。Gateway 機能の検出（一覧表示／詳細確認）、validate／dry-run、および個別の実行ステータス／アーティファクトダウンロード用 HTTP エンドポイントは対象外です。ページネーションと、機能の実行によるキャンセルは対象です。QUERY_DAILY_LIMIT_EXCEEDED（HTTP 429）が発生した場合は、リセットまで待つか管理者に連絡してください。QUERY_QUOTA_UNAVAILABLE は明示的な失敗です。これらのエラーを回避するために、別の ID に切り替えないでください。サーバーのデフォルトを使用するには、ダウンロード時に --timeout-seconds を省略してください。現在のポリシーは、選択した機能を確認してください。

使用する場面

ユーザーが次の操作を必要としている場合に、このスキルを使用します。

• メタデータのデータテーブルの一覧表示／取得／作成／更新／削除／ダウンロード
• ローカルからアップロードする場合は、まず利用可能なアップロード機能を必須の目的とともに使用して入力ファイル識別子を取得し、その後テーブル操作を続けます。
• 既存のデータテーブルをプロパティにバインドする、または CSV ディメンションテーブルを作成してバインドする

対象範囲外の作業については、コラボレーションプロトコルを使用して利用可能な機能を見つけてください。

コマンド形式

ae-cli metadata <resource> <action> [options]
ae-cli metadata property <dimension-table-action> [options]

• コマンドとフラグにはケバブケースを使用します：data-table、dimension-table、--project-id、--data-table-id。
• Gateway の input 本文フィールドにはスネークケースを使用します（project_id、event_name など）。ae-cli がフラグを自動的にマッピングします。

PROJECT_ID_GATE

同じ会話内で確認済みのプロジェクトコンテキストを再利用してください。それ以外の場合は、プロジェクト検索機能を見つけて project_id を特定してください。返されたプロジェクトに実際の曖昧さが残る場合に限り、ユーザーに確認してください。

Commands (10)

User command	Capability id	Reference
metadata data-table list	metadata.data_table.list	metadata_data_table_list.md
metadata data-table get	metadata.data_table.get	metadata_data_table_get.md
metadata data-table csv-write	metadata.data_table.csv_write	metadata_data_table_csv_write.md
metadata data-table sql-write	metadata.data_table.sql_write	metadata_data_table_sql_write.md
metadata data-table csv-delete	metadata.data_table.csv_delete	metadata_data_table_csv_delete.md
metadata data-table sql-delete	metadata.data_table.sql_delete	metadata_data_table_sql_delete.md
metadata data-table download	metadata.data_table.download	metadata_data_table_download.md
metadata data-table property-bindings-update	metadata.data_table.property_bindings_update	metadata_data_table_property_bindings_update.md
metadata property bind-existing-dimension-table	metadata.property.bind_existing_dimension_table	metadata_property_dimension_table_bind_existing.md
metadata property create-and-bind-csv-dimension-table	metadata.property.create_and_bind_csv_dimension_table	metadata_property_dimension_table_create_and_bind_csv.md

Quick Verification

ae-cli metadata --help
ae-cli metadata data-table list --help
ae-cli metadata data-table list --project-id 1 --dry-run
ae-cli analysis input-file purpose list --project-id 1