连接器

本页是连接器字典：有哪些数据源、每种连接字段填什么。创建、测试、权限、删除与载入/导出任务流程见指南 · 连接器。

必填以创建界面红色星号为准；带默认值的字段留空即用默认。界面字段名若有微调，以控制台为准。

是什么

连接器封装对某一数据源类型的：

  • 连通：地址、凭证、认证、超时等，可做连接测试。

  • 读写能力：怎么读、（在用途允许时）怎么写，供载入、导出、查询、知识库等复用。

配一次，处处用：同一实例可被多个载入任务、导出任务与查询引用。

用途

创建时通过 载入 / 导出 声明用途（默认双向，至少一项）：

用途

流向

说明

载入

外部 → MOI

载入任务、查询、知识库等读取场景

导出

MOI → 外部

导出任务

载入 + 导出

双向

同一连接既作来源也作目标

支持的数据源（9 大类 · 41 种）

类型

数据源

对象存储

阿里云 OSS、华为云 OBS、标准 S3 / MinIO、腾讯云 COS

分布式文件系统

HDFS

文件协议

FTP、SFTP、SharePoint、SMB / NAS

数据库

MySQL、PostgreSQL、MatrixOne、MongoDB、Oracle、SQL Server、ClickHouse、Doris、Hive

消息队列

Kafka、RabbitMQ、MQTT

企业应用

金蝶 K/3、Oracle ERP、用友 U8、SAP S/4HANA、Salesforce

邮件

Gmail、Outlook、IMAP / SMTP、Microsoft 365 Graph、QQ 邮箱、企业微信邮箱、自有邮箱 API

协作

钉钉、飞书、企业微信 API、语雀、GitHub、Slack

API

REST API、GraphQL

选型可从数据形态反推：文件在哪（对象存储 / 文件协议 / HDFS）→ 记录在哪（数据库 / 企业应用 / 协作）→ 流从哪来（消息队列）→ 无现成类型时用 REST / GraphQL。

通用规则

  1. 连接器只定义连接：数据库类一般不强制在连接器里钉死库名；具体库、表、Collection 在载入或查询时再选。

  2. Oracle 例外：Service Name / SID 是连接目标本身，必填；库内 Schema 仍可选。

  3. 邮件：连接器管授权与连通；时间范围、文件夹等在载入任务中配。

  4. 敏感凭证：用最小权限账号；测试通过只说明能连通，正式任务前仍应用小范围数据验证路径与权限。

对象存储

共性：凭证 + 桶 / 路径。

阿里云 OSS

字段

必填

说明

地区

是

如下拉：华东 1（杭州）、华东 2（上海）、华北 2（北京）、华南 1（深圳）等

AccessKey ID / AccessKey Secret

是

阿里云访问凭证；Secret 以密码框输入

文件路径

是

<桶名>/<文件夹路径> 或仅 <桶名>

标准 S3 / MinIO

字段

必填

说明

Endpoint

是

如 https://s3.amazonaws.com；MinIO 填自建地址

Access Key / Secret Key

是

访问凭证

Bucket

是

桶名称

Region

是

如 us-east-1

腾讯云 COS

字段

必填

说明

地区

是

如华南（广州）、华东（上海）、华北（北京）、西南（成都）、亚太（香港）等

SecretId / SecretKey

是

腾讯云访问凭证

Bucket

是

须含 appid 后缀：<bucket-name>-<appid>

文件路径

是

<bucket>/<文件夹路径> 或仅 <bucket>

华为云 OBS

字段

必填

说明

地区

是

如华北-北京四、华东-上海一、华南-广州、亚太-香港等

AK / SK

是

华为云访问凭证

Bucket

是

桶名

文件路径

是

<bucket>/<文件夹路径>

分布式文件系统

HDFS

字段

必填

说明

NameNode 地址

是

如 hdfs://namenode:8020

用户名

是

访问 HDFS 的用户

文件协议

FTP

字段

必填

说明

主机 / 端口

是

默认端口 21

用户名

是

匿名访问填 anonymous

密码

否

—

基础路径

否

读写根路径；留空用登录默认目录

传输模式

是

被动 PASV（推荐）/ 主动 PORT

SFTP

字段

必填

说明

主机 / 端口

是

默认端口 22

用户名

是

—

认证方式

是

密码，或私钥（PEM；加密私钥另填口令）

基础路径

否

如 /home/user/data

SharePoint

字段

必填

说明

站点 URL

是

含 /sites/<name> 的 Online 站点地址

Tenant ID

是

Microsoft Entra 租户标识

Client ID / Client Secret

是

Entra 应用凭证；需 Sites.Read.All 等权限

文档库名

否

默认 Documents

子文件夹

否

进一步限定范围

SMB / NAS

字段

必填

说明

主机

是

域名或 IP

共享名

是

SMB/CIFS 共享名（不含前置反斜杠）

AD 域

否

工作组或域名；非域留空

用户名 / 密码

是

—

SMB 版本

否

自动协商（推荐）/ SMB 3.0+ / 2.x / 1.0（仅旧设备，不推荐）

数据库

统一原则：连接器定义连接，载入 / 查询时选库表。「数据库（库名）」对多数类型可选。全部支持连接测试。

MySQL / PostgreSQL / MatrixOne

字段

必填

说明

主机 / 端口

是

默认：MySQL 3306、PostgreSQL 5432、MatrixOne 6001

用户名 / 密码

是

—

数据库

否

留空则在载入 / 查询时选择

Schema（仅 PostgreSQL）

否

默认 public

MongoDB

字段

必填

说明

主机 / 端口

是

默认 27017

认证方式

是

用户名密码（可填认证库，默认 admin）/ 无认证

Replica Set

否

如 rs0

读取偏好

否

primary / primaryPreferred / secondary / secondaryPreferred（常用）/ nearest

库与 Collection 在载入时选择。

Oracle

Service Name / SID 为连接目标，必填。

字段

必填

说明

主机 / 端口

是

默认 1521

连接方式

是

Service Name（12c+ 推荐）/ SID（11g 及更早）

Service / SID

是

如 ORCLPDB1 或 orcl

用户名 / 密码

是

—

Schema

否

留空用用户默认 schema

SQL Server

字段

必填

说明

主机 / 端口

是

默认 1433

实例名

否

命名实例如 SQLEXPRESS；默认实例留空

用户名 / 密码

是

—

数据库

否

留空则在载入 / 查询时选择

加密连接

否

启用（推荐）/ 禁用

ClickHouse

字段

必填

说明

主机 / 端口

是

HTTP 默认 8123，Native 默认 9000

协议

是

HTTP / HTTPS / Native TCP

用户名

是

默认 default

密码

否

无密码留空

数据库

否

留空常用 default

Doris

字段

必填

说明

FE 主机

是

Frontend 地址；多 FE 填首选

Query 端口

是

默认 9030

HTTP 端口

否

默认 8030（Stream Load）；只读可留空

用户名 / 密码

是 / 否

用户名默认 root

数据库

否

留空则在载入 / 查询时选择

Hive

支持多主机端口（界面「+ 添加主机端口」）与 LDAP / Kerberos。

字段

必填

说明

主机 / 端口

是

HiveServer2；端口默认 10000

认证方式

是

LDAP 或 Kerberos

认证方式

需填写

LDAP

Hive 用户名、密码

Kerberos

Principal（user@REALM 或 service/host@REALM）、Keytab 文件、Krb5 配置文件

消息队列

Kafka

字段

必填

说明

Bootstrap Brokers

是

逗号分隔，如 broker1:9092,broker2:9092

安全协议

是

PLAINTEXT / SSL / SASL_PLAINTEXT / SASL_SSL（生产常用）

SASL 机制

视协议

SASL_* 时必填：PLAIN / SCRAM-SHA-256 / SCRAM-SHA-512 / GSSAPI

SASL 用户名 / 密码

视协议

SASL 启用时填写

消费者组

是

同组按 partition 负载均衡

Topic 模式

是

可通配，如 sensor.*

起始位移

是

latest / earliest

MQTT

字段

必填

说明

Broker URL

是

mqtt:// 或 mqtts://，如 mqtt://broker:1883

Client ID

是

唯一；重复连接会踢下线

用户名 / 密码

否

匿名留空

Topic 订阅

是

+ 单层、# 多层通配

QoS

是

0 / 1（常用）/ 2

RabbitMQ

字段

必填

说明

主机 / 端口

是

AMQP 5672 / AMQPS 5671

Virtual Host

是

默认 /

用户名 / 密码

是

—

队列名

是

—

Exchange / Routing Key

否

留空用默认 exchange

企业应用

SAP S/4HANA

字段

必填

说明

OData 服务根

是

OData V2/V4 根地址（白名单服务由 BASIS 开放）

Client

是

3 位客户端号，如 100 / 200

认证方式

是

Basic 或 OAuth 2.0（Client ID / Secret / Token URL）

CSRF 防护

是

自动获取（默认）/ 禁用（仅只读）

Oracle ERP

字段

必填

说明

服务 URL

是

ERP Cloud 实例根地址

用户名 / 密码

是

—

REST API 版本

是

如 v11 / v10 / v9

用友 U8

字段

必填

说明

服务器地址

是

应用服务器地址（含端口）

账套号

是

3 位账套编号

会计年度

是

如 2026

用户名 / 密码

是

—

金蝶 K/3

字段

必填

说明

服务器地址

是

K/3 Cloud 站点地址

账套 ID

是

管理中心数据中心查看

用户名 / 密码

是

—

语言

否

简体中文（默认）/ English

Salesforce

字段

必填

说明

实例 URL

是

组织实例域名（Setup → My Domain）

Consumer Key / Consumer Secret

是

Connected App 凭证

Salesforce 用户名

是

—

密码 + Security Token

是

密码与 Security Token 直接拼接

API 版本

是

如 v60.0

邮件

连接器负责授权与连通；读哪些邮件（时间范围等）在载入任务中设置。

Gmail

字段

必填

说明

邮箱地址

是

Gmail / Google Workspace 邮箱

Client ID / Client Secret

是

Google Cloud OAuth 应用凭证

Refresh Token

是

授权后生成或粘贴，用于持续读取

Outlook

字段

必填

说明

Tenant ID

是

Microsoft 365 租户

邮箱地址

是

邮箱或共享邮箱

Client ID / Client Secret

是

Entra 应用凭证

Microsoft 365 Graph

字段

必填

说明

Tenant ID

是

Entra 管理中心查看

Client ID / Client Secret

是

应用凭证

邮箱白名单

否

留空 = 所有邮箱；多个逗号分隔

Scope

是

至少含 Mail.Read 等所需范围

QQ 邮箱 / 企业微信邮箱

字段

必填

说明

邮箱账号

是

完整邮箱

授权码

是

开启 IMAP/SMTP 后生成的客户端授权码（非登录密码）

IMAP / SMTP 通用

字段

必填

说明

IMAP 主机 / 端口

是

端口默认 993

SMTP 主机 / 端口

否

端口默认 465

加密方式

是

SSL/TLS / STARTTLS / 无加密

认证方式

是

用户名密码（或应用专用授权码），或 OAuth 2.0

自有邮箱 API

字段

必填

说明

Base URL

是

企业邮件 API 根地址

认证方式

是

API Key / Bearer / OAuth 2.0

邮件列表接口

是

如 /messages

邮件详情 / 发送接口

否

如 /messages/{id}、/messages/send

数据路径

否

JSON 中列表路径，如 data.items

协作

飞书

字段

必填

说明

App ID / App Secret

是

开放平台「凭证与基础信息」

应用类型

是

企业自建 / 商店应用（ISV）

权限范围

是

空格分隔 scope；最小化授权

钉钉

字段

必填

说明

AppKey / AppSecret

是

开放平台应用详情

CorpId

是

企业 ID

AgentId

否

微应用填；第三方企业应用可留空

企业微信 API

字段

必填

说明

CorpId

是

管理后台「我的企业」

AgentId / Secret

是

应用标识与密钥

回调 Token / EncodingAESKey

否

消息回调时填写

Slack

字段

必填

说明

Workspace URL

是

如 https://yourteam.slack.com

认证方式

是

Bot Token（xoxb-...；Socket Mode 另填 xapp-...）或 User Token（xoxp-...）

Signing Secret

否

事件回调验签

GitHub

字段

必填

说明

GitHub URL

是

公有云 https://api.github.com；企业版 https://<host>/api/v3

认证方式

是

PAT（建议 fine-grained）或 GitHub App（App ID / Installation ID / PEM）

组织 / 仓库范围

否

逗号分隔；留空 = 全部可访问

语雀

字段

必填

说明

服务地址

是

公有云 https://www.yuque.com 或私有部署

Token

是

个人设置或管理员签发

知识库 namespace

否

如 your-name/your-book；留空 = 全部可访问

API

REST API

字段

必填

说明

Base URL

是

API 根地址

认证方式

是

API Key（名称 / Header 或 Query / 值）、Bearer、OAuth 2.0 或无认证

超时时间

否

单次请求最大等待秒数，默认约 30

分页策略

否

offset+limit / cursor / page+per_page / 无分页

数据路径

否

如 data.items；根即为数组时留空

默认请求头

否

每次请求携带；多个换行分隔

具体 Endpoint、方法、参数与采样预览在载入任务中配置。

GraphQL

字段

必填

说明

GraphQL 端点

是

如 https://api.example.com/graphql

认证方式

是

Bearer / API Key（Header）/ 无认证

Schema Introspection

否

启用（推荐）/ 禁用

默认请求头

否

如 Content-Type: application/json

相关页面