# 连接器

连接器保存外部存储或数据库的连接参数，导入任务和导出任务按连接器类型及用途使用这些配置。不同类型可用用途不同；创建前应先按用途选择类型并测试当前参数。

## 新建连接器

1. 进入 **数据连接 > 连接器**。
2. 点击 **新建连接器**。
3. 输入连接器名称。
4. 选择数据源类型。
5. 按表单填写连接信息。
6. 按表单提供的选项选择用途。
7. 点击 **测试连接**。
8. 测试通过后，点击 **确定**。

测试连接会校验当前填写的连接参数是否可用。它不验证后续任务选择的源文件、源表、目标路径或目标表权限。

## 选择数据源类型

当前创建表单提供 11 种连接器。

| 类别 | 连接器 | 可用于 |
| --- | --- | --- |
| 对象存储 | 阿里云 OSS | 数据导入、数据导出 |
| 对象存储 | 标准 S3 | 数据导入、数据导出 |
| 分布式文件系统 | HDFS | 数据导入 |
| 数据库 | MatrixOne | 数据导出 |
| 数据库 | Hive | 结构化数据导入 |
| 数据库 | MySQL | 结构化数据导入 |
| 数据库 | SQL Server | 结构化数据导入 |
| 数据库 | Oracle | 结构化数据导入 |
| 数据库 | PostgreSQL | 结构化数据导入 |
| 数据库 | MongoDB | 结构化数据导入 |
| 可观测性 | Langfuse | Trace 同步 |

选择类型后，填写该类型的连接信息。对象存储表单包含访问地址和凭证；数据库表单包含主机、端口和认证信息；Langfuse 表单包含服务地址、Public Key、Secret Key 和拉取模式。必填字段带有必填标识。使用 API 创建、验证或更新连接器时，参照[创建连接器](../../../reference/api/ai-studio/data-connections/connectors/create-connector.md)页面中的完整配置字段表。

除 Langfuse 外，用途决定连接器能否在导入或导出任务中被选中，表单会隐藏或禁用不适用的用途。Langfuse 用于 Trace 同步，表单不显示用途选择。

## 查看和筛选连接器

连接器列表显示名称、类型、状态、创建者、创建时间、更新时间和用途。

你可以：

- 按名称搜索连接器；
- 按连接器类型、状态或用途筛选；
- 点击 **刷新** 获取最新列表；
- 打开连接器名称查看配置详情。

## 编辑、测试或删除连接器

在列表中找到目标连接器后，可以按权限执行相应操作。

| 任务 | 操作 |
| --- | --- |
| 修改连接配置 | 点击 **编辑**，修改名称、用途或连接信息；保存前再次执行 **测试连接**。 |
| 重新检查连通性 | 在创建或编辑表单中点击 **测试连接**。 |
| 删除连接器 | 点击 **删除**，在确认提示中确认操作。 |
| 配置对象权限 | 使用列表提供的权限入口，配置可查看或操作该连接器的成员或角色。 |

删除时，如果系统检测到连接器仍关联未完成的导入任务，会在确认提示中列出关联任务。删除前先处理这些任务，避免后续任务无法访问数据源。

## 连接测试通过但任务失败

| 现象 | 检查方式 |
| --- | --- |
| 任务找不到源文件或源表 | 检查任务选择的连接器、路径、数据库、Schema 和表。 |
| 任务无法写入目标 | 检查目标路径、目标数据库或表，以及对应的写入权限。 |
| 连接器不可见或操作不可用 | 检查当前工作区和连接器对象权限。 |