创建与维护连接器¶

创建连接器以访问外部数据源，并在后续调用中查询、更新、验证或删除该连接器。本页不包含对连接器中数据库、表和文件的浏览；这些操作请参阅浏览连接器数据源和管理连接器文件。

前提条件¶

准备可访问目标工作区的凭据。有关服务地址、认证和通用请求格式，请参阅调用前准备。

更新、验证或删除已有连接器前，先从连接器列表或详情中取得目标连接器标识。

调用顺序¶

先查询连接器列表，确认已有连接器是否可复用，并取得需要维护的连接器标识。
需要新增外部数据源时，创建连接器；提交后保留返回的连接器标识，供后续浏览或任务调用使用。
在开始使用前验证连接器配置；如需调整配置，更新连接器后再次验证。
查询连接器详情确认当前配置。确定不再使用时，再执行删除操作。

API 操作¶

创建和检查连接器¶

要完成的事	API 操作	何时使用
查询连接器列表	查看连接器列表	创建前检查可复用的连接器，或取得目标标识。
创建连接器	创建连接器	需要接入新的外部数据源时使用。
验证连接器配置	校验连接器配置	创建或更新后检查配置能否用于连接。
查询连接器详情	查看连接器详情	确认目标连接器的当前信息时使用。

维护连接器¶

要完成的事	API 操作	何时使用
更新连接器	更新连接器	需要修改已有连接器配置时使用。
删除连接器	删除连接器	确认不再使用该连接器后使用。

结果确认¶

创建或更新后，使用查看连接器详情确认目标连接器；需要确认配置是否可连接时，查看校验连接器配置的结果。

限制和注意事项¶

删除前，先确认不会再有数据浏览、导入、导出或同步任务依赖该连接器。
验证连接器配置只用于检查连接条件；实际可访问的数据对象以浏览数据源或文件的结果为准。

下一步¶

最后更新于 2026 年 9 月 1 日