# 创建与维护连接器

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

## 前提条件

准备可访问目标工作区的凭据。有关服务地址、认证和通用请求格式，请参阅[调用前准备](../../api-call-basics.md)。

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

## 调用顺序

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

## API 操作

### 创建和检查连接器

| 要完成的事 | API 操作 | 何时使用 |
| --- | --- | --- |
| 查询连接器列表 | [查看连接器列表](../../../../reference/api/ai-studio/data-connections/connectors/list-connectors.md) | 创建前检查可复用的连接器，或取得目标标识。 |
| 创建连接器 | [创建连接器](../../../../reference/api/ai-studio/data-connections/connectors/create-connector.md) | 需要接入新的外部数据源时使用。 |
| 验证连接器配置 | [校验连接器配置](../../../../reference/api/ai-studio/data-connections/connectors/validate-connector.md) | 创建或更新后检查配置能否用于连接。 |
| 查询连接器详情 | [查看连接器详情](../../../../reference/api/ai-studio/data-connections/connectors/get-connector.md) | 确认目标连接器的当前信息时使用。 |

### 维护连接器

| 要完成的事 | API 操作 | 何时使用 |
| --- | --- | --- |
| 更新连接器 | [更新连接器](../../../../reference/api/ai-studio/data-connections/connectors/update-connector.md) | 需要修改已有连接器配置时使用。 |
| 删除连接器 | [删除连接器](../../../../reference/api/ai-studio/data-connections/connectors/delete-connector.md) | 确认不再使用该连接器后使用。 |

## 结果确认

创建或更新后，使用[查看连接器详情](../../../../reference/api/ai-studio/data-connections/connectors/get-connector.md)确认目标连接器；需要确认配置是否可连接时，查看[校验连接器配置](../../../../reference/api/ai-studio/data-connections/connectors/validate-connector.md)的结果。

## 限制和注意事项

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

## 下一步

- [浏览连接器数据源](connector-data-sources.md)
- [管理连接器文件](connector-files.md)