hzdyjs/用户信息同步统一身份认证/README.md

统一身份认证用户数据同步

将校园管理系统用户/组织数据定时同步到认证中间库，供第三方统一身份认证平台拉取。

目录结构

用户信息同步统一身份认证/
├── 3.在认证中间库建立表.sql   # 第三方原始 Oracle 建表脚本（勿修改）
├── 建表脚本_mysql.sql          # MySQL 适配建表脚本（本地测试用）
├── data.conf                   # 研发环境配置
├── data.conf.prod              # 生产环境配置（Oracle 目标库）
├── create_tables.sh            # 创建中间表
├── sync_user_to_sso.sh         # 主同步脚本
├── verify_sync.sh              # 同步结果校验
├── sync_sql/sync_all_mysql.sql # MySQL 同步 SQL
├── sync_oracle/merge_all.sql   # Oracle MERGE 模板（生产）
├── 字段映射说明.md
└── logs/                       # 运行日志（自动创建）

快速开始（研发环境）

cd 用户信息同步统一身份认证

# 1. 创建中间表（仅新增6张表，不修改已有表）
chmod +x *.sh
./create_tables.sh

# 2. 执行一次全量同步
./sync_user_to_sso.sh --full --once

# 3. 校验同步结果
./verify_sync.sh

定时运行

# 守护进程模式，默认每 3600 秒（1小时）同步一次
./sync_user_to_sso.sh

# 修改同步频率：编辑 data.conf 中 CYCLE_INTERVAL（秒）

生产部署

1. 复制 data.conf.prod 为 data.conf 或指定 --config=data.conf.prod
2. 填写源库（校园系统 MySQL）和目标库（认证中间库 Oracle）连接信息
3. 目标库使用第三方提供的 3.在认证中间库建立表.sql 在 Oracle 中建表
4. 确保服务器已安装 sqlplus（Oracle 客户端）
5. 使用 crontab 或 systemd 定时执行：

# crontab 示例：每小时执行一次
0 * * * * /path/to/用户信息同步统一身份认证/sync_user_to_sso.sh --once >> /path/to/logs/cron.log 2>&1

配置说明

配置项	说明
SOURCE_DB_*	源库（校园管理系统，只读）
TARGET_DB_*	目标库（认证中间库，读写）
TARGET_DB_TYPE	mysql（测试）或 oracle（生产）
SYNC_MODE	full 全量 / incremental 增量
CYCLE_INTERVAL	循环间隔秒数，默认 3600