data360-connect

data360-connect：Data Cloud 接続フェーズ

ユーザーがソース接続の作業（コネクターの調査、接続メタデータの確認、接続テスト、ソースオブジェクトの参照、コネクタースキーマの確認、外部ソース用のコネクター固有の設定ペイロードの準備）を必要としている場合は、このスキルを使用します。

このスキルが担当するタスク

次の作業には data360-connect を使用します。

• sf data360 connection *
• コネクターカタログの確認
• 接続の作成、更新、テスト、削除
• ソースオブジェクト、項目、データベース、スキーマの参照
• すでに使用されているコネクターの種類の特定
• Snowflake、SharePoint Unstructured、Ingestion API ソース用のコネクター定義の準備

次の場合は、ほかのスキルに委任します。

• データストリームまたは DLO の作成 → data360-prepare
• DMO、マッピング、IR ルールセット、データグラフの作成 → data360-harmonize
• Data Cloud SQL または検索インデックスのワークフローの作成 → data360-query

---

最初に収集する必要があるコンテキスト

次の情報を質問するか、推測します。

• 対象の組織エイリアス
• コネクターの種類またはソースシステム
• ユーザーが確認のみを希望しているか、実際の変更も希望しているか
• 既存の接続がある場合は、その接続名または ID
• CLI の外部ですでに認証情報が設定されているか
• 接続設定の直後にデータストリームの作成も期待されているか
• ソースがデータベース、非構造化ドキュメントソース、Ingestion API フィードのいずれか

---

基本的な運用ルール

• まずプラグインのランタイムを確認します。../data360-orchestrate/references/plugin-setup.md を参照してください。
• 接続を変更する前に、共有の準備状況分類を実行します。node ../data360-orchestrate/scripts/diagnose-org.mjs -o <org> --phase connect --json
• 接続を作成する前に、読み取り専用の調査を優先します。
• 標準的な使用では、2>/dev/null を使用してリンクされたプラグインの警告を抑制します。
• connection list には --connector-type が必要です。
• connection test で Salesforce 以外の接続を名前から特定する場合は、--connector-type を指定します。
• 組織の情報が不明な場合は、まずデータストリームから既存のコネクターの種類を調べます。
• コネクター固有の認証情報やパラメーターを独自に作る前に、厳選されたサンプルペイロードを使用します。
• 厳選されたサンプル以外のコネクターの種類では、JSON を作成する前に、REST 経由で UI から作成された正常な接続を調べます。
• 接続の作成が成功しても、あらゆるコネクターの種類で API によるデータストリーム作成が可能だと約束してはいけません。

---

推奨ワークフロー

1. 接続作業の準備状況を分類する

node ../data360-orchestrate/scripts/diagnose-org.mjs -o <org> --phase connect --json

2. コネクターの種類を調べる

sf data360 connection connector-list -o <org> 2>/dev/null
sf data360 data-stream list -o <org> 2>/dev/null

3. 種類ごとに接続を調べる

sf data360 connection list -o <org> --connector-type SalesforceDotCom 2>/dev/null
sf data360 connection list -o <org> --connector-type REDSHIFT 2>/dev/null
sf data360 connection list -o <org> --connector-type SNOWFLAKE 2>/dev/null

4. 特定の接続またはアップロード済みスキーマを調べる

sf data360 connection get -o <org> --name <connection> 2>/dev/null
sf data360 connection objects -o <org> --name <connection> 2>/dev/null
sf data360 connection fields -o <org> --name <connection> 2>/dev/null
sf data360 connection schema-get -o <org> --name <connection-id> 2>/dev/null

5. 調査を終えてからテストまたは作成する

sf data360 connection test -o <org> --name <connection> --connector-type <type> 2>/dev/null
sf data360 connection create -o <org> -f connection.json 2>/dev/null

6. 外部コネクターには厳選されたサンプルペイロードを使用する

ペイロードを一から作成する前に、このフェーズ専用のサンプルを使用します。

• examples/connections/heroku-postgres.json
• examples/connections/redshift.json
• examples/connections/sharepoint-unstructured.json
• examples/connections/snowflake-connection.json
• examples/connections/ingest-api-connection.json
• examples/connections/ingest-api-schema.json

Ingestion API の一般的な設定フロー：

sf data360 connection create -o <org> -f examples/connections/ingest-api-connection.json 2>/dev/null
sf data360 connection schema-upsert -o <org> --name <connector-id> -f examples/connections/ingest-api-schema.json 2>/dev/null
sf data360 connection schema-get -o <org> --name <connector-id> 2>/dev/null

7. 不明なコネクターの種類のペイロード項目を調べる

UI で接続を作成し、直接確認します。

sf api request rest "/services/data/v66.0/ssot/connections/<id>" -o <org>

---

重要な注意点

• connection list には真のグローバルな「すべてを一覧表示」モードはありません。コネクターの種類を指定して検索してください。
• コネクターカタログの名前と、接続で使うコネクターの種類は、必ずしも同じ表記ではありません。
• 接続元がデフォルトの Salesforce コネクターではない場合、名前の解決に connection test で --connector-type が必要になることがあります。
• 接続一覧が空の場合は、通常「有効だが、まだ設定されていない」という意味であり、「機能が無効」という意味ではありません。
• Heroku Postgres、Redshift、Snowflake、SharePoint Unstructured、Ingestion API は、それぞれ異なる認証情報とパラメーターの形式を使います。推測せず、厳選された例を再利用してください。
• SharePoint Unstructured では credentials 配列に clientId、clientSecret、tokenEndpoint を指定し、parameters 配列は不要です。
• Snowflake ではキーペア認証を使い、多くの場合 API 経由で作成できますが、後続のストリーム作成は引き続き UI のみで行える場合があります。
• Ingestion API コネクターのセットアップは、connection schema-upsert でオブジェクトスキーマをアップロードするまで完了しません。
• 一部の外部コネクターの認証情報の設定には、引き続き UI 側での設定や外部システムの権限が必要です。

---

出力形式

Connect task: <inspect / create / test / update>
Connector type: <SalesforceDotCom / REDSHIFT / SNOWFLAKE / SPUnstructuredDocument / IngestApi / ...>
Target org: <alias>
Commands: <key commands run>
Verification: <passed / partial / blocked>
Next step: <prepare phase or connector follow-up>

---

参考資料

• examples/connections/heroku-postgres.json
• examples/connections/redshift.json
• examples/connections/sharepoint-unstructured.json
• examples/connections/snowflake-connection.json
• examples/connections/ingest-api-connection.json
• examples/connections/ingest-api-schema.json
• ../data360-orchestrate/references/plugin-setup.md
• ../data360-orchestrate/references/feature-readiness.md