ODI---->Variables

一、变量简介

变量存储的是一个单一的值，既可以是数字，也可以是字符或者日期。不能为数组。

ODI的变量分为两种，全局变量和项目变量。顾名思义，项目变量定义的变量只可以在本项目中使用，其它项目无法调用此变量。而全局变量定义的变量可被任何项目所引用。

变量可设置为一个单一的缺省值，或者由SQL赋值，在每次调用的时候刷新，生成最新的值。

二、变量的创建

先创建一个项目（ODI），打开后可看见”变量”标签。

在上面右键选择新建后，弹出窗口如下：

定义页中填入变量的名字，数值类型，保留历史记录有三种选项：缺省是最新值，还有所有值、无历史记录

最新值表示ODI将变量的最新值存入ODI元数据管理库中。
所与值表示ODI将变量的所有值变化存入元数据管理库中，可用于跟踪和调试。
无历史记录表示变量的最新值只存在与内存中，ODI不进行存储。

安全值：选中时，变量不会被记录。对于包含密码或者敏感数据的变量，选中时保留历史记录自动变为无历史记录

默认值定义了变量的缺省值。

切换到刷新页，可定义变量的刷新语句，从而在每次调用时，可获取不同的数值。

如上所示，在刷新页，首先要选择取变量的查询语句的数据源，例如ODI_TAG

然后编写select语句，

SELECT MAX(LAST_UPDATE_TIME) FROM "ODI_TAG"."DEPT"

完成后应用、保存。

点击验证按钮

点击刷新，会立即执行查询，历史记录标签页，根据保留历史记录2种选项不同，保存了最新值或者所有的历史记录。

这样，一个项目变量就已经创建完成。

三、变量使用

变量可用的地方很多，包括接口（Interface），程序（Procedure），包（Package）甚至模型（module）中的数据源等等。

3.1 变量作用域(scope)

使用变量MY_VAR的例子

· #MY_VAR: 必须在一个项目中

· #MY_PROJECT_CODE.MY_VAR: 明确指定项目名称前缀，避免有同名的全局变量

· #GLOBAL.MY_VAR: 参照全局变量.

· 使用 ":"代替"#"

You can use the variable as a SQL bind variable by prefixing it with a colon rather than a hash. However this syntax is subject to restrictions as it only applies to SQL DML statements, not for OS commands or ODI API calls and using the bind variable may result in performance loss. It is advised to use ODI variables prefixed with the '#'character to ensure optimal performance at runtime.

区别：

1. 冒号(:)只适用于SQL DML，不适用于OS命令 or ODI API，而使用#(井号)适用于OS commands, SQL, and ODI API calls.

2. 使用冒号(:)可能会损失性能。

3. 使用方法的不同：TOWN_NAME = :GLOBAL.VAR_TOWN_NAME，不需要引号括起来 TOWN = '#GLOBAL.VAR_TOWN' 需要引号括起来

When you reference an ODI Variable prefixed with the ':' character, the name of the Variable is NOT substituted when the RDBMS engine determines the execution plan. The variable is substituted when the RDBMS executes the request. This mechanism is called Binding. If using the binding mechanism, it is not necessary to enclose the variables which store strings between delimiters (such as quotes) because the RDBMS is expecting the same type of data as specified by the definition of the column for which the variable is used.

For example, if you use the variable TOWN_NAME=:GLOBAL.VAR_TOWN_NAME the VARCHAR type is expected.

When you reference an ODI variable prefixed with the "#" character, ODI substitutes the name of the variable by the value before the code is executed by the technology. The variable reference needs to be enclosed in single quote characters, for example TOWN = '#GLOBAL.VAR_TOWN'. This reference mode of the variable works for OS commands, SQL, and ODI API calls.