AIDP のデータを Delta Sharing(クラウドプラットフォーム間でのデータ共有機能)を使って共有します。共有設定の作成・管理、データ資産の追加、共有相手の管理、アクセス権限の付与ができます。 次のような場合に使用: - テーブルやスキーマ(データベースの構造)を別のチームや組織と共有したい - Delta Sharing の設定をしたい - 共有相手を管理したい - 共有権限やアクセストークンの有効期限を制御したい 主に公式の `aidp` コマンドラインツール(`aidp delta-share …`コマンド)を使用します。コマンドラインツールが使えない場合は、同じ機能を持つ REST API(`oci raw-request` で実行)を代替手段として利用できます。
Share AIDP data via Delta Sharing — create/manage shares, add data assets, manage recipients, and grant access/permissions. Use when the user wants to share a table/schema with another team or org, set up Delta Sharing, manage recipients, or control share permissions/token expiry. Primary engine is the official `aidp` CLI (`aidp delta-share …`); the same GA REST API via `oci raw-request` is the no-CLI fallback.
aidp-data-sharing — Delta Sharing(共有とレシピエント)AIDP の DeltaShare API を通じて、Delta Sharing プロトコルによるオープンなデータ共有を提供します。
エージェントから主導するオープンプロトコル共有が差別化ポイントです。
CLI(推奨):
aidp delta-share <command> --instance-id <DATALAKE_OCID> --auth api_key --profile DEFAULT --region <r>
aidp delta-share create | get | list | update | delete | manage-access | manage-data-asset | manage-permission | list-data-assetsaidp delta-share create-recipient | get-recipient | list-recipients | update-recipient | delete-recipient | manage-recipient-permission | list-recipient-shares | list-recipient-permissionsフォールバック(CLI 未使用時): oci raw-request 経由で同一の DeltaShare REST API を使用
(エンドポイント・認証は同じ。詳細は references/oci-raw-request.md を参照)。
事前検証について:
GET /sharesおよびGET /recipientsは20240831/dataLakes(認証:--profile DEFAULT、api_key)で 本番環境での 200 応答確認済みです。aidp delta-share list/list-recipientsも同じパスを使用します。 このバージョン/プレフィックスをデフォルトとしてください。20260430は将来の GA 対象バージョンとして扱い、 テナンシーのアップグレード後にのみ検証してください。 破壊的な操作を行う前に、書き込みを伴う操作は必ず本番応答で確認し、references/rest-endpoint-map.mdに記録してください。
aidp delta-share list(CLI)または GET /shares(REST フォールバック。認証手順は
references/oci-raw-request.md を参照)で現状を確認する。manage-data-asset。aidp-catalog-explore から実際の
カタログテーブルを参照)→ レシピエントを作成・紐付け → アクセス/パーミッションを管理。update-recipient / manage-recipient-permission で
ローテーションする。レシピエントの Bearer トークンは絶対に表示しないこと。ミューテーション操作(共有/レシピエントの create、manage-access、manage-data-asset、
manage-permission、manage-recipient-permission):
リクエストボディを .aidp/payloads/ に保存し、実行前に確認すること
(references/payloads.md)。
20240831/dataLakes/<OCID>)POST|GET /shares · GET|PUT|DELETE /shares/{k}
· GET /shares/{k}/recipients|permissions|dataAssets
· POST /shares/{k}/actions/manageAccess|managePermission|manageDataAssetPOST|GET /recipients · GET|PUT|DELETE /recipients/{k}
· GET /recipients/{k}/shares|permissions
· POST /recipients/{k}/actions/managePermissionreferences/aidp-cli-map.md · references/payloads.md · references/oci-raw-request.md · references/rest-endpoint-map.md
aidp-data-sharing — Delta Sharing (shares & recipients)Open data sharing over the Delta Sharing protocol via the AIDP DeltaShare API. A differentiator:
open-protocol sharing driven from the agent.
CLI (preferred): aidp delta-share <command> --instance-id <DATALAKE_OCID> --auth api_key --profile DEFAULT --region <r>
aidp delta-share create | get | list | update | delete | manage-access | manage-data-asset | manage-permission | list-data-assetsaidp delta-share create-recipient | get-recipient | list-recipients | update-recipient | delete-recipient | manage-recipient-permission | list-recipient-shares | list-recipient-permissionsFallback (no CLI): same DeltaShare REST API via oci raw-request (identical endpoint + auth; see
references/oci-raw-request.md).
Verify-first:
GET /sharesandGET /recipientsare LIVE-VERIFIED 200 on20240831/dataLakes(auth--profile DEFAULT, api_key) —aidp delta-share list/list-recipientshit the same path. Default to that version/prefix; treat20260430as the future GA target and probe only after a tenancy upgrade. Confirm any write with a live response before destructive actions; record inreferences/rest-endpoint-map.md.
aidp delta-share list (CLI) — or GET /shares (REST fallback; auth ladder in
references/oci-raw-request.md).manage-data-asset, referencing real catalog tables from
aidp-catalog-explore) → create/attach recipients → manage access/permissions.update-recipient / manage-recipient-permission. Never
print the recipient bearer token.Mutating ops (share/recipient create, manage-access, manage-data-asset, manage-permission,
manage-recipient-permission): persist the body to .aidp/payloads/ and confirm first
(references/payloads.md).
20240831/dataLakes/<OCID>)POST|GET /shares · GET|PUT|DELETE /shares/{k} · GET /shares/{k}/recipients|permissions|dataAssets
· POST /shares/{k}/actions/manageAccess|managePermission|manageDataAssetPOST|GET /recipients · GET|PUT|DELETE /recipients/{k} · GET /recipients/{k}/shares|permissions
· POST /recipients/{k}/actions/managePermission原文・著作権は Anthropic および各プラグイン作者に帰属します。日本語訳は Claude API による自動翻訳です。