组织机构同步-同步第三方数据库（DB同步）

# 同步第三方数据库（DB同步）

同步通过配置可以将第三方数据库的部门和用户数据同步到平台中

## 配置方式：

在「组织机构」\-\>「组织同步」\-\>中进行相关配置：

![](/media/202507//1751877294.7451186.png)

### 同步方式

选择DB同步方式

### 基础设置

1、选择同步的数据库，所选数据库可在「数据源管理」\-\>「数据库连接」\-\>中进行新增和管理。关于同步所用到的部门和用户的数据库表或视图的规范，可查看下面的节点

2、点击测试可检查数据库配置是否正确，报错内容解释可查看下面的节点

3、点击“同步说明”可跳转到本页面，查看帮助

### 高级设置

1、设置自动同步时间可配置数据库同步时间

2、可添加多个自动同步时间

### 同步日志

每次同步都会留下一条同步日志，通过同步日志，可查看每次同步的具体内容，和成功失败等情况。

![](/media/202507//1751877294.7507157.png)

1、同步类型：DB同步只有一种同步类型，即自动同步

2、部门和成员：如例图所示的“8/0”即指，本次同步中，部门同步成功8个，失败0个；“4/0”指，本次同步中，成员同步成功4个，失败0个

3、查看详情：点击可查看本次同步详细情况，如下图所示

注意：若部门同步失败 ，则部门内的成员不会进行同步，此处也不会显示该部门内成员的同步情况

![](/media/202507//1751877294.7549524.png)

## 数据库表或视图规范

第三方可以提供**数据表或者视图**供平台调用。

数据库可以支持 \`SqlServer\`、\`Oracle\` 和 \`MySql\` 三大主流关系型数据库。三种数据库中对部门和用户的表或视图规范有些许差异，具体参见三种数据库的建表语句。

### 部门

表（视图）名称：SYNC\_DEPT

字段：

| 名称 | 类型 | 描述 | 是否必填 | 默认值 |
| --- | --- | --- | --- | --- |
| DeptCode | VARCHAR | 部门编码（唯一标示） | 是 |  |
| DeptName | VARCHAR | 部门名称 | 是 |  |
| ParentCode | VARCHAR | 部门父级编码 | 是 | 第一级部门的ParentCode给默认值：18f923a7\-5a5e\-426d\-94ae\-a55ad1a4b240 |
| SortKey | INT | 部门排序号 | 否 | 0 |
| LastUpdateTime | DATE | 最后修改时间 | 是 |  |

### 用户

表（视图）名称：SYNC\_USER

字段：

| 名称 | 类型 | 描述 | 是否必填 | 默认值 |
| --- | --- | --- | --- | --- |
| UserName | VARCHAR | 用户名称 | 是 |  |
| UserCode | VARCHAR | 用户编码（登录名） | 是 |  |
| DeptCode | VARCHAR | 用户所属部门编码 | 是 |  |
| Mobile | VARCHAR | 手机号 | 否 |  |
| Email | VARCHAR | 邮箱 | 否 |  |
| OfficePhone | VARCHAR | 办公电话 |  |  |
| IdCard | VARCHAR | 身份证号 | 否 |  |
| Birthday | DATE | 生日 | 否 |  |
| EmployeeNumber | VARCHAR | 员工编号 | 否 |  |
| SortKey | INT | 用户排序号 | 否 | 0 |
| State | INT | 状态 | 是 | 1：启用；0：禁用 |
| LastUpdateTime | DATE | 最后更新时间 | 是 |  |

==**注意：当需要同步数据到企业微信时，Mobile 和 Email 必须要填写一个。**==

### 建表语句

以下为三种数据库中，部门和用户的建表语句

```
Create Table If Not Exists `SYNC_DEPT`(
   `DeptCode` varchar(255)  NOT NULL,
   `DeptName` varchar(255)  NOT NULL,
   `ParentCode` varchar(255)  NOT NULL,
   `SortKey` int default (0),
   `LastUpdateTime` datetime NOT NULL
 );
```
 
  
```
CREATE TABLE SYNC_DEPT (
  DEPTCODE VARCHAR2(255 BYTE) NOT NULL ,
  DEPTNAME VARCHAR2(255 BYTE) NOT NULL ,
  PARENTCODE VARCHAR2(255 BYTE) NOT NULL ,
  SORTKEY NUMBER default (0),
  LASTUPDATETIME DATE NOT NULL 
)
TABLESPACE "USERS"
LOGGING
NOCOMPRESS
PCTFREE 10
INITRANS 1
STORAGE (
  INITIAL 65536 
  NEXT 1048576 
  MINEXTENTS 1
  MAXEXTENTS 2147483645
  BUFFER_POOL DEFAULT
)
PARALLEL 1
NOCACHE
DISABLE ROW MOVEMENT
;
```

```
IF not EXISTS (SELECT * FROM sys.all_objects WHERE object_id = OBJECT_ID(N'[dbo].[SYNC_DEPT]') AND type IN ('U'))

CREATE TABLE [dbo].[SYNC_DEPT] (
  [DeptCode] varchar(255) not NULL,
  [DeptName] varchar(255) not NULL,
  [ParentCode] varchar(255) not NULL,
  [SortKey] int  NULL default (0),
  [LastUpdateTime] datetime  not  NULL
)
GO
```

```
CREATE TABLE  IF not EXISTS `SYNC_USER`  (
  `UserName` varchar(255)  NOT NULL,
  `UserCode` varchar(255)  NOT NULL,
  `DeptCode` varchar(255)   NOT NULL,
  `Mobile` varchar(255)  NULL,
  `Email` varchar(255)   NULL,
  `OfficePhone` varchar(255)   NULL,
  `IdCard` varchar(255)  NULL,
  `Birthday` datetime  NULL,
  `EmployeeNumber` varchar(255)  NULL,
  `SortKey` int NULL default(0),
  `State` int NOT NULL,
  `LastUpdateTime` datetime  NOT NULL
);
```

```
CREATE TABLE "SYNC_USER" (
  "USERNAME" VARCHAR2(255 BYTE) NOT NULL ,
  "USERCODE" VARCHAR2(255 BYTE) NOT NULL ,
  "DEPTCODE" VARCHAR2(255 BYTE) NOT NULL ,
  "MOBILE" VARCHAR2(255 BYTE) ,
  "EMAIL" VARCHAR2(255 BYTE) ,
  "OFFICEPHONE" VARCHAR2(255 BYTE) ,
  "IDCARD" VARCHAR2(255 BYTE) ,
  "BIRTHDAY" DATE ,
  "EMPLOYEENUMBER" VARCHAR2(255 BYTE) ,
  "SORTKEY" NUMBER DEFAULT 0  ,
  "STATE" NUMBER  NOT NULL ,
  "LASTUPDATETIME" DATE NOT NULL 
)
TABLESPACE "USERS"
LOGGING
NOCOMPRESS
PCTFREE 10
INITRANS 1
STORAGE (
  INITIAL 65536 
  NEXT 1048576 
  MINEXTENTS 1
  MAXEXTENTS 2147483645a
  BUFFER_POOL DEFAULT
)
PARALLEL 1
NOCACHE
DISABLE ROW MOVEMENT
;
```

```
IF not  EXISTS (SELECT * FROM sys.all_objects WHERE object_id = OBJECT_ID(N'[dbo].[SYNC_USER]') AND type IN ('U'))

CREATE TABLE [dbo].[SYNC_USER] (
  [UserName] varchar(255)  NOT NULL,
  [UserCode] varchar(255)  NOT NULL,
  [DeptCode] varchar(255)   NOT NULL,
  [Mobile] varchar(255)  NULL,
  [Email] varchar(255)   NULL,
  [OfficePhone] varchar(255)   NULL,
  [IdCard] varchar(255)  NULL,
  [Birthday] datetime  NULL,
  [EmployeeNumber] varchar(255)  NULL,
  [SortKey] int NULL default 0,
  [State] int NOT NULL,
  [LastUpdateTime] datetime  NOT NULL
)
GO
```

## 测试报错示例

| 报错示例 | 处理建议 |
| --- | --- |
| 同步数据库不能为空 | 检查基础配置中的同步数据库是否有选择 |
| 获取数据库连接配置失败 | 检查数据库连接相关配置 |
| 数据库连接失败，请确认数据库连接字符串配置正确 | 检查数据库连接字符串配置 |
| 数据库连接异常 | 检查数据库连接是否正常 |
| 同步部门表，\[SYNC\_DEPT]表不存在 | 检查同步数据库中是否存在同步部门表 |
| 同步部门表，SORTKEY，DETPCODE字段不存在 | 检查同步数据库中部门表里是否存在相关字段 |
| 列DEPTNAME期望的数据类型为STRING，列DEPTCODE期望的数据类型为STRING | 检查同步数据库中部门表里相关字段类型是否合法 |
| 同步用户表表，SORTKEY，USERCODE字段不存在 | 检查同步数据库中是否存在同步用户表 |
| 列USERNAME期望的数据类型为STRING，列USERCODE期望的数据类型为STRING | 检查同步数据库中用户表里相关字段类型是否合法 |