值转换规则（SQL）

1 简介

1.1 功能介绍

值转换规则类型中支持选择SQL类型。

1.2 应用场景

基于源对象输入值，通过SQL语句的方式，将输出值赋予目标对象。

1.3 系统路径

【集成管理】→【数据集成】→【值转换规则】

1.4 字段/按钮说明

字段说明：

按钮说明：

2 主要操作

2.1 新增SQL规则

步骤1：请进入值转换规则列表，点击“新增”按钮，规则类型选择“SQL”；

步骤2：选择和输入相关内容后保存。

2.2 SQL脚本说明

实现类：

kd.isc.iscb.platform.core.vc.SQLRule

基本思路：

• 用 $src, $tar, $this 分别代表 源系统、目标系统、本系统

• 用 param 表示“源值”变量名，用 result 表示“结果”变量名

以“源值”为初始条件，在源系统/目标系统/集成云系统上执行SQL，返回名为result变量值作为“目标值”

苍穹元数据：

使用 isc_value_conver_rule 的基本信息和“SQL脚本”

语法(1)： 

• 设置当前数据库，其中：{env} 取值可以是 $src（源系统）, $tar（目标系统）, 或 $this（本系统）

use {env};

• 执行查询SQL，使用执行该SQL的数据库的语法，使用#{name}引用变量，并且只允许返回0或1行

select field as var_name from table_name where field2 = #{param}

• 示例：

// 在源库执行
SQLuse $src;select fname_l2 as name from T_BD_Currency where fid = #{param};
// 在目标库执行
SQLuse $tar;select top 1 fid as result from t_bd_currency_l@BASEDATA where fname = #{name};

语法(2)： 

• 声明变量类型，当源库与目标库数据类型不一致，或参数值类型不是字符串时，应该声明类型，防止SQL参数无效，其中 data_type 的取值可以是：varchar, bigint, int, decimal, 或nvarchar。允许使用 // 作为开头添加单行注释。

declare name data_type;

• 示例：

// 声明输入值的数据类型
declare param varchar;
// 在源库执行
SQLuse $src;se