通讯录集成-数据库
概述
集成价值
| 价值 | 说明 |
|---|---|
| 灵活适配 | 支持任意包含用户和组织数据的数据库表 |
| 自动化同步 | 通过 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 别名 | 平台属性 | 映射方式 | 说明 |
|---|---|---|---|
| username | username | 创建且更新 | 用户名（唯一标识） |
| display_name | display_name | 创建且更新 | 用户显示名称 |
| phone_number | phone_number | 创建且更新 | 手机号码 |
| 创建且更新 | 电子邮箱 | ||
| department | department | 创建且更新 | 部门名称 |
| title | title | 创建且更新 | 职位 |
| active | active | 创建且更新 | 用户状态 |
重要：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