SuperAPI AI 工具集

data360-connect

数据与分析

查看项目

更新于 10-15 21:43

技能介绍

用途:data360-connect 属于 Salesforce Data Cloud 的 Connect 阶段,用于处理数据源连接相关工作,包括连接器发现、连接元数据查看、连接测试、源对象浏览、连接器 schema 检查,以及为外部源准备连接器专属的配置负载。

主要能力:围绕 sf data360 connection 系列命令,支持连接器目录检查,连接的新建、更新、测试与删除,浏览源对象、字段、数据库或 schema,识别 org 中已使用的连接器类型,并为 Snowflake、SharePoint Unstructured、Ingestion API 等来源准备连接器定义。若任务涉及创建数据流或 DLO,应交给 data360-prepare;涉及 DMO、映射、IR 规则集或数据图,应交给 data360-harmonize;涉及 Data Cloud SQL 或搜索索引,应交给 data360-query。

使用方式:先确认插件运行时,再运行就绪分类命令 node ../data360-orchestrate/scripts/diagnose-org.mjs -o <org> --phase connect --json。优先做只读发现。常用命令包括 sf data360 connection connector-list、sf data360 data-stream list、sf data360 connection list(需带 --connector-type)、connection get、connection objects、connection fields、connection schema-get、connection test、connection create。外部连接器建议先复用 examples/connections 下的示例负载,例如 heroku-postgres.json、redshift.json、sharepoint-unstructured.json、snowflake-connection.json、ingest-api-connection.json、ingest-api-schema.json。Ingestion API 流程需在 create 后执行 connection schema-upsert。

适用场景:为不熟悉的 org 先通过数据流发现已有连接器类型;查看或测试既有连接;在创建连接后再进入 prepare 阶段准备数据流。

限制与注意:connection list 没有真正的全局列出模式,需按连接器类型查询;连接器目录名称与连接的连接器类型标签可能不同;非默认 Salesforce 连接按名称测试时需提供 --connector-type;空的连接列表通常表示已启用但未配置;Snowflake 使用密钥对认证,API 可创建连接但下游数据流创建可能仍只能在 UI 完成;部分外部连接器的凭据设置仍依赖 UI 或外部系统权限;连接创建成功不保证所有连接器类型都能通过 API 创建数据流。其余未在资料中说明的事项暂未提供。