sf-datacloud-connect: Data Cloud Connect フェーズ

ユーザーがソース接続作業を必要とする場合、このスキルを使用してください。コネクタ発見、接続メタデータ、接続テスト、ソースオブジェクト参照、コネクタスキーマ検査、または外部ソース用のコネクタ固有セットアップペイロードです。

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

以下の作業に関わる場合は sf-datacloud-connect を使用してください：

• sf data360 connection *
• コネクタカタログ検査
• 接続の作成、更新、テスト、または削除
• ソースオブジェクト、フィールド、データベース、またはスキーマの参照
• 既に使用中のコネクタタイプの識別
• Snowflake、SharePoint Unstructured、または Ingestion API ソース用のコネクタ定義準備

以下の場合は他のスキルに委譲してください：

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

---

最初に収集すべき必須コンテキスト

以下を確認または推測します：

• ターゲット org エイリアス
• コネクタタイプまたはソースシステム
• ユーザーが検査のみを望むのか、それとも実際の変更を望むのか
• 既に存在する場合は接続名または ID
• 認証情報が既に CLI 外部で構成されているか
• 接続セットアップ直後にストリーム作成も期待しているか
• ソースがデータベース、非構造化ドキュメントソース、または Ingestion API フィードか

---

コア運用ルール

• プラグインランタイムを最初に検証します。../sf-datacloud/references/plugin-setup.md を参照してください。
• 接続を変更する前に共有の準備状況分類器を実行します: node ~/.claude/skills/sf-datacloud/scripts/diagnose-org.mjs -o <org> --phase connect --json。
• 接続作成前に読み取り専用発見を優先します。
• 標準使用時に 2>/dev/null でリンクプラグイン警告ノイズを抑制します。
• connection list には --connector-type が必要なことを覚えておいてください。
• connection test の場合、Salesforce 以外の接続を名前で解決するときに --connector-type を渡します。
• org に不慣れな場合は、最初にストリームから既存のコネクタタイプを発見します。
• コネクタ固有の認証情報またはパラメータを発明する前に、キュレーション済みのサンプルペイロードを使用します。
• キュレーション済み例の外にあるコネクタタイプの場合、JSON を構築する前に REST 経由で既知の良好な UI 作成接続を検査します。
• 接続作成が成功したからといって、すべてのコネクタタイプで API ベースのストリーム作成が可能と約束しないでください。

---

推奨ワークフロー

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

node ~/.claude/skills/sf-datacloud/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 で 1 つ作成してから、直接検査します：

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

---

注意すべきポイント

• connection list には真のグローバル「すべてリスト」モードがありません。コネクタタイプで検索します。
• コネクタカタログ名と接続コネクタタイプは常に同じラベルとは限りません。
• connection test は、ソースがデフォルト Salesforce コネクタでない場合、名前解決に --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 側の構成または外部システムの権限に依存しています。

---

出力形式

接続タスク: <inspect / create / test / update>
コネクタタイプ: <SalesforceDotCom / REDSHIFT / SNOWFLAKE / SPUnstructuredDocument / IngestApi / ...>
ターゲット org: <alias>
コマンド: <実行した主要コマンド>
検証: <passed / partial / blocked>
次のステップ: <prepare フェーズまたはコネクタのフォローアップ>

---

参考資料

• README.md
• 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
• ../sf-datacloud/references/plugin-setup.md
• ../sf-datacloud/references/feature-readiness.md
• ../sf-datacloud/UPSTREAM.md