Skip to main content
数据接入

数据连接

通过数据连接器接入企业数据库、文档系统和对象存储，在应用中实时查询和引用数据

数据连接是管理外部数据源的统一入口。通过创建连接器，应用可以安全地访问企业数据库、文档系统和对象存储中的数据，在对话中实时查询和引用。

连接器类型

连接器按数据的存储和访问方式分为平台托管和流处理两类：
联通格式连接器数据存储方式适用场景
平台托管文件平台存储上传和管理非结构化文档（PDF、Word、Markdown 等）
平台托管表格平台存储导入和查询结构化表格数据（CSV、Excel 等）
流处理MySQL数据保留在原数据库，实时访问连接 MySQL 数据库，执行 SQL 查询
流处理PostgreSQL数据保留在原数据库，实时访问连接 PostgreSQL 数据库，执行 SQL 查询
流处理PolarDB-X 2.0数据保留在原数据库，实时访问连接阿里云 PolarDB-X 2.0 分布式数据库
语雀和 OSS 不作为独立连接器类型创建，仅作为文件连接器的同步数据来源，详见同步数据规则。

前置条件

  • 账号权限：主账号或具有数据连接管理权限的 RAM 用户。
  • 数据源准备（按连接器类型）：
连接器需要准备
文件 / 表格待上传的文件，或已创建 OSS Bucket
MySQLMySQL 数据库实例（阿里云 RDS 或自建），网络可达（公网或私网）
PostgreSQLPostgreSQL 数据库实例，且已将 wal_level 参数设为 logical
PolarDB-X 2.0阿里云 PolarDB-X 2.0 实例，所在地域支持私网访问

创建连接器

进入控制台 数据接入 → 数据连接，点击 创建连接器，选择连接器类型后按以下说明填写配置。
  • 文件
  • 表格
  • MySQL
  • PostgreSQL
  • PolarDB-X 2.0
文件连接器用于管理非结构化文档（PDF、Word 等）。
1. 连接器类型选择 **文件**。
2. 填写**连接器名称**和**描述**。描述会用于指导应用调用的准确度，建议写明数据内容和用途。
3. **存储位置**选择**使用平台存储**：数据存储在平台提供的存储空间，最多 200,000 个文件 / 1 TB，限时免费。或选择**使用自有 OSS 存储**：数据存储在您自己的 OSS Bucket 中，首次使用需完成授权，目标 Bucket 需添加 `bailian-connector-access` 标签（值为 `ReadAndWrite`）。
填写完成后，点击确认完成创建。

导入数据

连接器创建完成后，需要向连接器中导入数据。

文件连接器

  1. 在数据连接列表页点击目标连接器的详情按钮，进入连接器详情页的文件标签。
  2. 在左侧类目树中选择现有类目，或点击 + 新建类目。
  3. 点击导入数据，选择本地导入，上传文件。也可选择 OSS 导入方式从 OSS 拉取文件。
  4. 选择解析方式（默认设置或自定义），系统自动完成文件解析。
  • 目前平台不支持直接导入 JSON、CSV、YAML 格式文件，请转换为 XLSX 或 XLS 格式再导入。
  • 文件导入后作为独立副本存储在平台中，与原始数据无关联。

数据库连接器

数据库连接器（MySQL / PostgreSQL / PolarDB-X 2.0）的数据保留在原数据库中，无需手动导入。连接器创建完成后即可在应用中实时查询数据。

同步数据规则

文件类型数据连接器支持创建同步规则，从外部数据源自动同步文件到平台。在连接器详情页的文件标签下，点击右上角 同步数据规则 → 创建同步规则。
  • OSS
  • 飞书
  • 钉钉
  • SharePoint
  • 语雀
通过阿里云服务关联角色（SLR）访问用户 Bucket，将 OSS 中的数据自动同步到平台。
  • OSS 同步基于 SLR 访问用户 Bucket，无需配置 AccessKey。首次使用前需完成授权。
    • 对象路径需包含 Bucket 名称，例如 my-bucket/docs/ 或 my-bucket/docs/foo.md。
    • 目标 Bucket 需添加 bailian-datahub-access 标签（值为 read）。
| 参数 | 必填 | 说明 |
|------|------|------|
OSS Region | 是 | 选择 OSS Bucket 所在的地域
OSS 对象路径 | 是 | 需同步的对象路径，含 Bucket 名（如 `my-bucket/docs/` 同步目录，或 `my-bucket/docs/foo.md` 同步单文件）
同步周期 | 是 | 自动同步频率
连接检测 | 是 | 验证 OSS 路径可访问
数据标签 | 否 | 分类管理标签，每个最多 32 字符
填写完成后点击连接检测验证连通性，通过后配置数据标签，点击确认创建规则。创建完成后显示在同步规则列表页，可对规则启用或禁用。

文件连接器工具

文件连接器创建成功后，系统自动生成以下工具，可在智能体应用或工作流中调用：
工具名称说明
searchFile按关键词搜索文件，返回匹配的文件列表和下载链接
getFile按 ID 获取文件，返回文件下载链接

管理连接器

在数据连接列表页可对已有连接器进行以下操作：
操作说明
编辑仅可修改连接器名称和描述
复制复制连接器配置，生成新的连接器
删除删除连接器，操作不可逆
连接器被知识库绑定为数据源后，该绑定关系不可更改。如需更换数据源，需创建新的知识库。

在智能体中使用数据连接器

  1. 在智能体编辑页面，进入技能 → 数据连接器。
  2. 点击 +，选择需要的数据连接器。
  3. 点击发布，智能体即可在对话中调用连接器的工具。

在工作流中使用数据连接器

  1. 在工作流编辑页面，添加数据连接器节点。
  2. 选择连接器和需要使用的工具（每个节点仅支持一个工具）。
  3. 工具输出为 result 对象，包含 content（Array）和 isError（Boolean）字段。

数据导入 API

除控制台操作外，也可通过 API 管理数据导入。详见 API 参考 — 数据导入。
数据导入 API（/api/v1/connector/dash/）与其他接口使用相同的 workspace 域名和鉴权方式，详见 API 概览。
连接器配置完成后，继续创建知识库将连接器中的数据构建为可检索的索引。
开始使用
Playground
数据接入
知识服务
Cookbook
应用集成
设置、计费与限制