105 lines
3.9 KiB
Markdown
105 lines
3.9 KiB
Markdown
# 统一身份认证用户数据同步
|
||
|
||
将校园管理系统用户/组织数据定时同步到认证中间库，供第三方统一身份认证平台拉取。
|
||
|
||
## 目录结构
|
||
|
||
```
|
||
用户信息同步统一身份认证/
|
||
├── 3.在认证中间库建立表.sql # 第三方原始 Oracle 建表脚本（勿修改）
|
||
├── 建表脚本_mysql.sql # MySQL 适配建表脚本（本地测试用）
|
||
├── data.conf # 研发环境配置
|
||
├── data.conf.prod # 生产环境配置（Oracle 目标库）
|
||
├── create_tables.sh # 创建中间表
|
||
├── sync_user_to_sso.sh # 主同步脚本
|
||
├── verify_sync.sh # 同步结果校验（支持 MySQL / Oracle）
|
||
├── db_helper.py # MySQL 辅助
|
||
├── oracle_gen_merge.py # 从 MySQL 生成 Oracle MERGE SQL（生产）
|
||
├── sync_sql/sync_all_mysql.sql # MySQL 同步 SQL
|
||
├── sync_oracle/merge_all.sql # Oracle 说明（实际由 gen 脚本生成）
|
||
├── 字段映射说明.md
|
||
└── logs/ # 运行日志（自动创建）
|
||
```
|
||
|
||
## 快速开始（研发环境）
|
||
|
||
```bash
|
||
cd 用户信息同步统一身份认证
|
||
|
||
# 1. 创建中间表（仅新增6张表，不修改已有表）
|
||
chmod +x *.sh
|
||
./create_tables.sh
|
||
|
||
# 2. 执行一次全量同步
|
||
./sync_user_to_sso.sh --full --once
|
||
|
||
# 3. 校验同步结果
|
||
./verify_sync.sh
|
||
```
|
||
|
||
## 定时运行（推荐：守护进程 + 时间窗，无需 crontab）
|
||
|
||
生产配置 `SYNC_WINDOW_ENABLED=true` 时：脚本每小时醒来一次，**仅在 0 点～1 点之间**真正执行同步，其余时段跳过。手动 `--once` / `--full --once` 不受时间窗限制。
|
||
|
||
```bash
|
||
# 后台常驻（服务器重启后需重新拉起，或配合 systemd）
|
||
source /etc/profile.d/oracle.sh
|
||
cd /path/to/用户信息同步统一身份认证
|
||
nohup ./sync_user_to_sso.sh >> logs/daemon.log 2>&1 &
|
||
|
||
# 查看
|
||
ps -ef | grep sync_user_to_sso | grep -v grep
|
||
tail -f logs/daemon.log
|
||
```
|
||
|
||
相关配置（`data.conf` / `data.conf.prod`）：
|
||
|
||
| 配置项 | 说明 |
|
||
|--------|------|
|
||
| `CYCLE_INTERVAL` | 醒来间隔秒数，默认 3600 |
|
||
| `SYNC_WINDOW_ENABLED` | `true` 开启时间窗 |
|
||
| `SYNC_WINDOW_START_HOUR` | 开始小时（含），默认 0 |
|
||
| `SYNC_WINDOW_END_HOUR` | 结束小时（不含），默认 1，即 00:00~00:59 |
|
||
|
||
也可改用 crontab（可选）：
|
||
|
||
```bash
|
||
10 0 * * * source /etc/profile.d/oracle.sh; /path/to/sync_user_to_sso.sh --once >> /path/to/logs/cron.log 2>&1
|
||
```
|
||
|
||
## 生产部署
|
||
|
||
1. 复制 `data.conf.prod` 为 `data.conf` 或指定 `--config=data.conf.prod`
|
||
2. 填写源库（校园系统 MySQL）和目标库（认证中间库 Oracle）连接信息
|
||
3. 目标库使用第三方提供的 `3.在认证中间库建立表.sql` 在 Oracle 中建表
|
||
4. 确保服务器已安装 Instant Client（`basic` + `sqlplus`），并配置：
|
||
```bash
|
||
export ORACLE_HOME=/usr/lib/oracle/23/client64
|
||
export PATH=$ORACLE_HOME/bin:$PATH
|
||
export LD_LIBRARY_PATH=$ORACLE_HOME/lib:$LD_LIBRARY_PATH
|
||
```
|
||
5. 依赖：`python3` + `pymysql`（`pip3 install pymysql`）
|
||
6. 全量同步一次并校验：
|
||
```bash
|
||
source /etc/profile.d/oracle.sh
|
||
./sync_user_to_sso.sh --full --once
|
||
./verify_sync.sh
|
||
```
|
||
7. 后台常驻（时间窗内每天自动同步一次）：
|
||
```bash
|
||
source /etc/profile.d/oracle.sh
|
||
nohup ./sync_user_to_sso.sh >> logs/daemon.log 2>&1 &
|
||
```
|
||
|
||
## 配置说明
|
||
|
||
| 配置项 | 说明 |
|
||
|--------|------|
|
||
| SOURCE_DB_* | 源库（校园管理系统，只读） |
|
||
| TARGET_DB_* | 目标库（认证中间库，读写） |
|
||
| TARGET_DB_TYPE | `mysql`（测试）或 `oracle`（生产） |
|
||
| SYNC_MODE | `full` 全量 / `incremental` 增量 |
|
||
| CYCLE_INTERVAL | 守护进程醒来间隔秒数，默认 3600 |
|
||
| SYNC_WINDOW_ENABLED | 是否仅在指定小时段同步（守护模式） |
|
||
| SYNC_WINDOW_START_HOUR / END_HOUR | 时间窗，默认 0~1（每天 0 点档） |
|