1. 集成连接器配置指南
专属集成平台
  • 快速开始
    • 集成平台概览
  • 身份与用户管理
    • 用户管理
      • 用户与组织架构管理
    • 角色管理
      • 角色管理配置说明
    • 属性管理
      • 属性管理配置说明
      • IDAAS 扩展物理字段使用说明
    • 上游身份数据集成
      • 通讯录身份集成概述
      • 集成连接器配置指南
        • 通讯录集成-泛微
        • 通讯录集成-飞书
        • 通讯录集成-企业微信
        • 通讯录集成-AD
        • 通讯录集成-睿人事
        • 通讯录集成-北森
        • 通讯录集成-SCIM
        • 通讯录集成-用友EHR
        • 通讯录集成-Azure AD
        • 通讯录集成-致远
        • 通讯录集成-LDAP
        • 通讯录集成-数据库
        • 通讯录集成-钉钉
          • 基础说明
          • 钉钉集成连接器如何配置属性映射
      • 通过连接流实现身份集成
        • 在连接流画布中完成身份集成配置
      • 身份集成常见问题
        • 常见问题 & 排错指南
    • 下游身份数据同步
      • 通讯录同步概述
      • 同步连接器配置指南
        • 通讯录同步-企业微信
        • 通讯录同步-AD
        • 通讯录同步-用友U8C
        • 通讯录同步-钉钉
          • 基础说明
          • 如何配置部门职位扩展字段
      • 通过连接流实现身份同步
        • 使用连接流实现身份下游同步
      • 身份同步常见问题
        • 常见问题 & 排错指南
        • 使用代理网关进行身份同步
  • 认证源管理
    • 认证源基础说明
      • 认证源选型说明
      • 认证源管理概述
    • 认证源配置指南
      • 基础协议配置
        • 认证源-CAS协议
        • 认证源-OIDC协议
        • 认证源-OAuth2协议
      • 三方认证源配置手册
        • 认证源-钉钉
        • 认证源-AD
        • 认证源-飞书
        • 认证源-LDAP
        • 认证源-微信
        • 认证源-微信公众号
        • 认证源-Google Workspace
        • 认证源-AD Azure
        • 认证源-美云智数
        • 认证源-企业微信
  • 应用管理
    • 基础说明
      • 应用管理概述
      • 应用创建与配置
    • 应用单点登录
      • 单点登录概述
      • 单点登录配置
      • 单点登出配置
      • 授权范围配置
      • 自定义集成单点登录配置说明
      • 应用密码代填
      • 应用网关
      • 单点登录配置指南
        • 单点登录-OIDC
        • 单点登录-SAML协议
        • 单点登录-OAuth2
        • 单点登录-CAS协议
        • 单点登录-钉钉SSO
        • 单点登录-分贝通
        • 单点登录-用友NCC
        • 单点登录-宜搭
        • 单点登录-泛微OA
        • 单点登录-致远OA
        • 单点登录-金蝶云星空
        • 单点登录-中国电子云邮箱
        • 单点登录-阿里云控制台(RAM)
        • 单点登录-纷享销客应用
        • 单点登录-纷享销客待办
        • 单点登录-Exchange
        • Exchange-双入口配置指南
    • 应用授权管理
      • 应用授权概述
      • 基于组织架构和用户授权
      • 基于角色授权(RBAC)
      • 基于用户属性授权(ABAC)
      • 用户自主申请应用(OA审批授权)权限
    • 应用分发
      • 企业应用分发
      • ABM应用分发
    • 使用应用调用集成平台 OPENAPI
      • M2M接口授权
      • 接口调用权限配置说明
  • 连接中心
    • 产品概述
      • 什么是 AI 连接流
      • AI 连接流的典型使用场景
    • 基础功能
      • 流程运行日志
      • 功能概览
      • 如何创建 AI 工作流
      • 授权凭证管理
      • 错误处理
    • 节点说明
      • 节点基础类型说明
      • 数据处理节点
        • 文本处理节点
        • 数组处理
        • 数据集合节点
      • 文件处理节点
        • 「Base64 转 URL」动作说明
        • 「PPT分页切割」动作说明
      • 应用节点
        • Teambition
        • 金蝶云 K3Cloud
      • 内置节点
        • 子流程调用
        • 缓存处理
        • 分支节点
        • 循环执行
        • MYSQL 触发动作说明
        • 数字签名
        • Webhook触发
        • 缓存列表处理
        • 条件分支
        • FTP
        • 延时节点
        • 模型子节点
        • MCP SERVER 工具
        • 邮件发送
        • 存储子节点
        • 工具子节点
        • HTTP 请求
        • 变量节点
        • 加解密节点
        • 返回变量
      • 运维管理节点
        • 数据校验节点
      • AI节点
        • 构建你的第一个 AI Agent
        • AI 浏览器操作节点
        • AI Agent节点使用指南
        • AI 消息对话节点 & 组件嵌入
  • 审计日志
    • 管理员行为日志
    • 用户变更日志
    • 接口调用日志
    • 用户行为日志
    • 消息发送日志
  • 权限中心
    • 管理员账号管理
    • 管理员角色管理
  • 品牌设置
    • 登录页设置
      • 登录页面配置
      • 登录页CSS自定义页面样式
      • CSS定制页面内容:样式修改指南及故障排除
    • 短信设置
      • 短信模板配置
      • 短信服务使用及签名修改使用指南
      • 短信服务-自定义连接流配置
      • 阿里云短信网关配置指引
    • 邮件设置
      • 邮件模板配置
      • 通过自定义连接流发送邮件
      • SMTP 配置与测试支持文档
    • 企业消息设置
      • 企业消息配置
      • 企业消息(钉钉_飞书)配置
    • 分发页面设置
      • 分发页面设置
  • 平台设置
    • 功能概述
    • 授权管理
    • 代理网关
    • 授权信息
    • 登录策略配置
      • 弱密码检测功能说明
      • 登录流程配置
      • 自动登录功能配置
    • MFA 配置
      • MFA基础配置
      • 使用连接流自定义 MFA 策略
    • 运维日志
      • 运维日志下载
  • 最佳实践
    • AD-LDAP接入指南
    • 第三方平台应用创建指南
      • 钉钉
        • 钉钉全套集成指南
        • 创建钉钉开放平台应用
      • 飞书
        • 飞书全套集成指南
        • 创建飞书开放平台应用
      • 企微
        • 企业微信全套集成指南
        • 创建企业微信开放平台应用
  • 开放接口
    • 鉴权认证
      • 获取access_token(请求体方式)
      • 获取access_token(Basic认证方式)
    • 用户管理
      • 查询用户
      • 创建用户
      • 根据多个条件过滤并查询用户信息
      • 根据用户帐号获取用户信息
      • 修改用户
      • 启用/禁用用户
      • 删除用户
      • 修改用户密码
    • 组织部门
      • 获取组/部门的列表
      • 创建组/部门
      • 根据组/部门ID获取组/部门的信息
      • 修改组/部门
      • 删除组/部门
      • 根据组/部门ID获取下级组/部门信息
      • 过滤部门信息
    • 角色管理
      • 创建角色
      • 获取单个角色详情
      • 修改角色
      • 删除角色
      • 查询角色列表
      • 根据应用ID和用户ID获取角色列表
      • 查看角色所对应的用户列表
      • 给多个用户添加静态角色
      • 删除用户静态角色
      • 获取用户的角色信息
    • 连接中心
      • Webhook启动连接流
    • 事件通知
      • 连接器事件通知
  1. 集成连接器配置指南

通讯录集成-数据库

概述#

本指南详细说明如何在专属集成平台中配置数据库通讯录集成连接器,通过 JDBC 方式连接数据库,实现从数据库表中读取组织架构和用户数据并与平台自动同步。

集成价值#

价值说明
灵活适配支持任意包含用户和组织数据的数据库表
自动化同步通过 SQL 查询实现用户数据自动同步
通用数据源适用于各类自定义存储用户身份的数据库系统

前提条件#

数据库要求#

要求说明
数据库类型支持 MySQL、Oracle、SQL Server、PostgreSQL 等主流关系型数据库
JDBC 连接信息数据库主机地址、端口、数据库名
数据库账号具备对用户表的 SELECT 权限的数据库账号
网络连通性专属集成平台能够访问数据库服务器
JDBC 驱动确保平台已安装对应数据库的 JDBC 驱动

专属集成平台要求#

要求说明
管理员权限拥有专属集成平台的管理员权限
通讯录集成权限具备创建和管理通讯录集成连接器的权限

操作步骤#

步骤 1:创建数据库集成连接器#

1.
使用管理员账号登录专属集成平台
2.
在左侧导航栏选择「用户中心 → 通讯录集成」
3.
点击页面右上角的「新建连接器」按钮
4.
在连接器类型选择界面,找到并选择「数据库」选项

步骤 2:配置连接信息#

参数名称说明填写指南
名称连接器显示名称自定义名称,如“数据库-HR系统”
数据库类型数据库产品类型选择 MySQL、Oracle、SQL Server、PostgreSQL 等
主机地址数据库服务器 IP 或域名如 192.168.1.100
端口数据库服务端口MySQL 默认 3306,Oracle 默认 1521,SQL Server 默认 1433
数据库名数据库名称如 hr_system
用户名数据库登录账号具备 SELECT 权限的账号
密码数据库登录密码对应账号的密码
提示:建议为集成平台创建专用的只读数据库账号,仅授予必要表的 SELECT 权限,确保安全性。

步骤 3:配置同步策略#

参数名称说明建议配置
同步范围同步的数据类型用户和部门
数据在本地挂载节点同步数据在平台的挂载位置数据库认证
挂载方式组织架构挂载方式通常选择“在选择节点下新建”
同步方式数据同步策略初次配置“手动全量同步”,验证后改为“自动增量同步”
同步周期自动同步的频率建议 6 小时
账号关联用户映射关系常用“数据库用户 ID 与平台用户名”
重要:首次配置建议选择「手动全量同步」,验证数据准确性后再改为「自动增量同步」。

步骤 4:配置 SQL 查询与属性映射#

用户查询 SQL#

编写查询用户的 SQL 语句,查询结果列的别名将用于属性映射:

部门查询 SQL#

属性映射#

SQL 别名平台属性映射方式说明
usernameusername创建且更新用户名(唯一标识)
display_namedisplay_name创建且更新用户显示名称
phone_numberphone_number创建且更新手机号码
emailemail创建且更新电子邮箱
departmentdepartment创建且更新部门名称
titletitle创建且更新职位
activeactive创建且更新用户状态
重要:SQL 查询结果中的别名(AS 后的字段名)必须与属性映射中的源字段名称一致。务必确保查询结果包含唯一标识字段(如 user_id),用于用户去重和关联。

步骤 5:执行同步并验证#

1.
点击「连接测试」验证数据库连接是否成功
2.
连接测试通过后,点击「保存」创建连接器
3.
在连接器列表页点击「立即同步」触发手动全量同步
4.
同步完成后,验证用户数据和组织架构是否正确

验证与测试#

验证项操作方法
连接测试点击连接测试按钮,验证数据库连接是否成功
SQL 查询验证可先在数据库客户端中执行 SQL 确认结果集正确
用户数据验证在「用户管理」页面筛选数据库连接器,抽查用户信息完整性
组织架构验证在「组织管理」页面检查部门结构是否正确
增量同步验证在数据库中修改数据后触发同步,验证变更是否同步

常见问题#

问题可能原因解决方案
连接测试失败主机地址/端口不正确、账号密码错误、网络不通检查数据库连接信息,确认网络和防火墙规则
SQL 执行错误SQL 语法错误、表名不存在在数据库客户端中验证 SQL,确认表和字段名正确
数据同步不完整SQL WHERE 条件过滤过多、别名不匹配检查 SQL 查询条件,确认别名与映射配置一致
JDBC 驱动缺失平台未安装对应数据库驱动联系管理员安装对应的 JDBC 驱动
修改于 2026-05-06 09:50:42
上一页
通讯录集成-LDAP
下一页
基础说明
Built with