Q：R2R（Row-to-Row）映射 XML 是数据同步“源表字段→目标表字段” 的转换规则基础教程。

R2R 映射 XML 语法速查表

一、核心节点层级（必记）

节点名称	层级关系	核心作用
<table-mappings>	根节点	统一管理所有表映射配置
<table-mapping>	根节点子级	关联单个源表，定义表级映射
<mappings>	表映射子级	存放具体字段映射规则集合
<mapping>	映射集合子级	绑定目标表和映射策略（如全量 / 增量）
<column>	映射规则子级	单个字段的转换逻辑（核心配置）

 

二、关键属性说明（常用必背）

1. 根节点 <table-mappings> 属性

属性名称	作用	示例值
xmlns:xsi	指定 XML Schema 实例命名空间	http://www.w3.org/2001/XMLSchema-instance
xsi:noNamespaceSchemaLocation	关联 XSD 约束文件（验证 XML 合法性）	../r2RMapping.xsd（相对路径）

2. 表映射 <table-mapping> 属性

属性名称	作用	示例值
src	指定数据来源表名称	pt_outhosp_order（门诊订单表）

3. 映射规则 <mapping> 属性

属性名称	作用	可选值 / 示例值
targ	指定数据目标表名称	yh_mz_yzmxjl（门诊医嘱明细记录表）
type	映射类型（同步策略）	all（全量）、delta（增量）

4. 字段映射 <column> 属性（核心）

属性名称	作用	可选值 / 示例值
src	源字段来源：源表字段名或无依赖标识	status（源表字段）、N/A（无依赖）
targ	目标表字段名（数据写入字段）	status_targ、xtsjgxsj
value	字段转换规则（固定值 / 表达式 / 函数）	'住院'、REPLACE(...)、$(sysdate)
pk	标记是否为目标表主键（匹配记录用）	true（是）、默认不写（否）

 

三、高频表达式模板（直接复用）

1. 空值替换（特定字符转 NULL）

<column src="字段名" targ="目标字段名" value="REPLACE($(src.字段名), '-', NULL)"/>

• 用途：将源表中 '-' 等无效字符转为 NULL，避免脏数据。

2. 固定值填充

<!-- 字符串常量（需单引号包裹） -->
<column src="N/A" targ="目标字段名" value="'固定值'"/>
<!-- 系统时间（适配 Oracle 等数据库） -->
<column src="N/A" targ="目标字段名" value="'$(sysdate)'"/>

3. 字符串拼接

<column src="N/A" targ="目标字段名" value="body['参数1']+'_'+body['参数2']"/>

• 用途：拼接接口参数或源表字段，生成唯一标识（如报告流水号）。

4. 条件判断（三元运算符）

<column src="N/A" targ="目标字段名" value="条件1? 结果1: 条件2? 结果2: 默认值"/>

• 示例：'1'.equals(body['age_unit'])? body['age']:'岁'.equals(body['age_unit'])? body['age']:null

5. 主键映射（匹配更新 / 删除记录）

<column src="源表主键字段" targ="目标表主键字段" pk="true"/>

• 用途：同步时通过主键定位目标表记录，确保更新 / 删除精准。

6. 一些实例

<?xml version="1.0" encoding="UTF-8"?>
<table-mappings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../r2RMapping.xsd"><table-mapping src="pt_outhosp_order"><mappings><mapping targ="yh_mz_yzmxjl" type="all"><!-- 1. 状态字段映射：将源表 status 字段值中的 '-' 替换为 NULL 后，存入目标表 status_targ 字段 --><column src="status" targ="status_targ" value="REPLACE($(src.status), '-', NULL)"><!-- 2. 系统更新时间：将目标表 xtsjgxsj 字段设置为当前系统日期时间 --><column src="N/A" targ="xtsjgxsj" value="'$(sysdate)'"/><!-- 3. 操作类型标识：将 dsql_optype 字段设置为 'update'，标识操作类型为更新 --><column src="N/A" targ="dsql_optype" value="'update'"/><!-- 4. 主键字段映射：将源表 system_source 字段作为主键，映射到目标表 hisbb 字段 --><column src="system_source" targ="hisbb" pk="true"/><!-- 5. 操作类型标识：将 dsql_optype 字段设置为 'delete'，标识操作类型为删除 --><column src="N/A" targ="dsql_optype" value="'delete'"/><!-- 6. 操作类型标识：将 dsql_optype 字段设置为 'batch_delete'，标识操作类型为批量删除 --><column src="N/A" targ="dsql_optype" value="'batch_delete'"/><!-- 7. 报告流水号构造：通过拼接 request_no 和 report_serial_no 构造目标表 bglsh 字段的值 --><column src="N/A" targ="bglsh" value="body['request_no']+'_'+body['report_serial_no']"/><!-- 8. 年龄字段处理：根据 age_unit 的值判断，若为 '1' 或 '岁'，则取 age 的值，否则为 null，存入 nls 字段 --><column src="N/A" targ="nls" value="'1'.equals(body['age_unit'])? body['age']:'岁'.equals(body['age_unit'])? body['age']:null"/><!-- 9. 就诊性质字段：将目标表 jzxzmc 字段固定设置为 '住院' --><column src="N/A" targ="jzxzmc" value="'住院'"/></mapping></mappings></table-mapping>
</table-mappings>

 

四、使用注意事项

1. 节点嵌套：<column> 必须是 <mapping> 的直接子节点，不可嵌套在其他 <column> 内。
2. 字符串格式：常量字符串需用单引号包裹（如 '住院'），避免语法错误。
3. 占位符：$(src.字段名) 用于取源表字段值，body['key'] 用于取外部参数（如接口请求体），需结合工具支持调整。
4. 兼容性：函数（如 REPLACE）和系统变量（如 sysdate）需适配目标数据库，不同数据库语法可能略有差异。