用途:这是 Salesforce Data Cloud 的 Connect 阶段技能,面向源系统连接工作。当任务涉及 sf data360 connection 相关命令、连接器目录查看、连接的创建与更新测试删除、浏览源对象/字段/数据库/schema、识别已用连接器类型,或为 Snowflake、SharePoint Unstructured、Ingestion API 准备连接器定义时使用。
主要能力:列出连接器类型与数据流;按连接器类型检查连接;获取单个连接、源对象与字段、已上传 schema;测试或创建连接;使用精选示例负载处理外部连接器。
必要用法:先确认插件运行时(见 ../orchestrating-datacloud/references/plugin-setup.md);变更连接前运行就绪分类器 node ../orchestrating-datacloud/scripts/diagnose-org.mjs -o <org> --phase connect --json;优先只读发现。常规命令如:sf data360 connection connector-list -o <org> 2>/dev/null、sf data360 connection list -o <org> --connector-type SNOWFLAKE 2>/dev/null、sf data360 connection get -o <org> --name <connection> 2>/dev/null、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。外部连接器建议从示例负载开始:examples/connections/ 下的 heroku-postgres.json、redshift.json、sharepoint-unstructured.json、snowflake-connection.json、ingest-api-connection.json、ingest-api-schema.json。已知连接的 REST 检查:sf api request rest "/services/data/v66.0/ssot/connections/<id>" -o <org>。
适用场景:数据源接入前的连接器发现与连接管理;Ingestion API 需连接创建后再执行 schema-upsert 才算配置完成;未知连接器类型可先在 UI 创建再通过 REST 检查字段。
限制:connection list 无全局列出模式,必须按连接器类型查询;connector 目录名与连接器类型标签未必一致;非 Salesforce 连接按名称解析时测试可能需 --connector-type;空连接列表通常表示已启用但未配置;不同连接器凭据与参数结构不同,不应臆测;Snowflake 下游数据流创建可能仍仅限 UI;部分外部连接器配置依赖 UI 或外部系统权限;连接创建成功不代表所有连接器类型都支持 API 创建数据流。创建数据流或 DLO、创建 DMO/映射/规则集、Data Cloud SQL 或搜索索引工作应交给对应阶段技能。