bsp
HOS 数据迁移平台 — 实施操作手册
| 项目 | 说明 |
|---|---|
| 适用对象 | 实施、运维、数据迁移现场人员 |
| 适用系统 | HIS IHD 数据迁移模块（hisihd-mediway-boot + 前端 bsp/ihd） |
| 文档目的 | 按步骤完成「源库 → 临时表 → 正式业务表」迁移 |
| 版本说明 | 1.0 |
1. 业务概览
1.1 迁移两段式
源系统库（Cache/ IRIS / Oracle / 人大金仓等）
│ JDBC 查询（或 Excel 文件）
▼
HIS 临时/中间表（class_name 对应表，如 bsp_ihd_pa_pat）
│ 正式导入（按 ID 范围 / 字段分组等）
▼
HIS 正式业务表
| 阶段 | 做什么 | 主要入口 |
|---|---|---|
| 准备 | 配 JDBC、建任务、字段对照、字典对照 | 基础配置 / 导入任务配置 / 通用字典 / 字典对照 |
| 临时导入 | 从源库或 Excel 写入中间表 | 数据迁移平台 → 导入临时表 |
| 正式导入 | 从中间表写入正式业务 | 数据迁移平台 → 导入正式表 |
| 核查 | 看进度与错误明细 | 临时表进度 / 正式表进度 |
1.2 界面 Tab 一览
进入 数据迁移 菜单后，顶部 Tab：
| Tab | 页面 | 作用 |
|---|---|---|
| 数据迁移平台 | import-data.html |
选任务、写 SQL/选文件、导入临时/正式、看进度 |
| 基础配置 | config.html |
JDBC 等键值配置（驱动、URL、用户、密码） |
| 导入任务配置 | biz-config.html |
业务任务（cf_bsp_ihd_biz_config）、参数、字段对照入口 |
| 通用字典 | dictionary.html |
IHD 通用字典树 |
| 字典对照 | map.html |
内外码对照（旧码 → 新码） |
2. 前置条件（开干前确认）
- 服务已启动：IHD 后端（如
hisihd-mediway-server）可访问；前端已登录 HIS。 - 源库信息：IP/端口、库名（或命名空间）、账号密码、驱动类型已从现场获取。
- 中间表已存在：对应任务的
class_name表已在目标 HIS 库建好。 - 网络：应用服务器能访问源库端口（防火墙放行）。
3. 标准操作流程（推荐顺序）
flowchart TD
A[1.基础配置 JDBC] --> B[2.测试并应用 JDBC]
B --> C[3.新建/维护导入任务]
C --> D[4.表字段对照]
D --> E[5.字典与对照 按需]
E --> F[6.导入临时表]
F --> G[7.查临时进度与错误]
G --> H[8.导入正式表]
H --> I[9.查正式进度与验收]
4. 步骤一：基础配置（JDBC）
入口：数据迁移 → 基础配置
4.1 维护四条 JDBC 配置（均需「有效」）
| 配置代码 | 配置名称示例 | 配置值说明 |
|---|---|---|
jdbc.driverClassName |
JDBC驱动类 | 如 Cache：com.intersys.jdbc.CacheDriver；人大金仓：com.kingbase8.Driver；Oracle：oracle.jdbc.OracleDriver |
jdbc.url |
JDBC连接串 | 必须与驱动匹配（见下表） |
jdbc.username |
JDBC用户名 | 源库账号 |
jdbc.password |
JDBC密码 | 源库密码（列表显示为 ********） |
常见 URL 写法：
| 源库 | 驱动类 | URL 示例 |
|---|---|---|
| 老 Cache | com.intersys.jdbc.CacheDriver |
jdbc:Cache://主机:1972/命名空间 |
| 人大金仓 | com.kingbase8.Driver |
jdbc:kingbase8://主机:5432/库名 |
| Oracle | oracle.jdbc.OracleDriver |
jdbc:oracle:thin:@//主机:端口/服务名 |
注意：驱动与 URL 必须成对匹配。例如金仓驱动不要配
jdbc:Cache://，Oracle 不要用jdbc:orcl://非标准协议。
4.2 测试并应用
- 保存四条配置且均为 有效。
- 点击工具栏 测试JDBC连接 → 提示连接成功即可。
- 点击 应用JDBC配置 → 确认后生效（进程内切换目标库连接）。
- 服务重启后，一般会尝试从配置