相关名

相关名是标识逻辑消息树中已定义开始点的字段引用,且在字段引用中用于描述树格式的标准部件。

当您访问四个树(message、environment、local environment 或 exception list)中任意一个的数据时,可使用的相关名取决于您要对它进行 ESQL 编码和映射的节点,以及节点是否创建输出消息。例如,当消息通过 Trace 节点时,它不改变消息的内容,但 Compute 节点可以构造新的输出消息。

可通过 SELECT 表达式、定量谓词和 FOR 语句引入新的相关名。通过使用引用变量,您可以在节点中创建非相关名。

在不创建输出消息的节点中的相关名

大多消息流节点不会创建输出消息;因此您在这些节点的 ESQL 模块和映射中编写的 ESQL 表达式仅引用输入消息。可在 Database 和 Filter(ESQL 模块)节点中使用以下相关名。但不能在任何用于 Mapping、Extract、Warehouse、DataInsert、DataUpdate 或 DataDelete 节点的表达式中使用这些相关名。

Root
通过节点传递的消息的根。
Body
消息的根的最后一个子代,即消息体。 这是 Root.*[<] 的别名。

有关如何使用 * 的描述,请参阅使用匿名字段引用

DestinationList
它是包含对于节点可用的当前本地环境变量的结构。其首选名称是 LocalEnvironment,尽管 DestinationList 相关名可用于向后兼容性。
Properties
它是输入消息的标准属性。
ExceptionList
包含节点已访问的当前异常列表的结构。
Environment
它是包含对于节点可用的当前全局环境变量的结构。可从任何您为其创建 ESQL 代码和映射的节点读取和更新 Environment。
LocalEnvironment
它是包含对于节点可用的当前本地环境变量的结构。可从任何您为其创建 ESQL 代码和映射的节点读取和更新 LocalEnvironment。

在创建输出消息的节点中的相关名

如果您要对用于 Compute 节点的 ESQL 进行编码,则相关名是不同的,因为其中涉及两个消息树:输入消息和输出消息。这些节点中的 ESQL 中的相关名有:

Environment
它是包含对于节点可用的当前全局环境变量的结构。可读取和更新 Environment。
InputRoot
输入消息的根。
InputBody
输入消息的根的最后一个子代。这是 InputRoot.*[<] 的别名。

有关如何使用 * 的描述,请参阅使用匿名字段引用

InputProperties
它是输入消息的标准属性。
InputDestinationList
它是包含通过节点传递的消息的本地环境变量的结构。使用相关名 InputDestinationList 用于向后兼容性;如果兼容性不是必需的,则使用首选名称 InputLocalEnvironment。
InputExceptionList
包含通过节点传递的消息的异常列表的结构。
InputLocalEnvironment
它是包含通过节点传递的消息的本地环境变量的结构。
OutputRoot
输出消息的根。

在 Compute 节点中,没有相关名 OutputBody。

OutputDestinationList
它是包含从节点发送的本地环境变量的结构。使用相关名 OutputDestinationList 用于向后兼容性;如果兼容性不是必需的,则使用首选名称 OutputLocalEnvironment。
OutputExceptionList
包含节点正在生成的异常列表的结构。

虽然该相关名始终有效,但仅当 Compute 节点的计算方式属性表明 Compute 节点正在传播 ExceptionList 时,它才有意义。

OutputLocalEnvironment
它是包含从节点发送的本地环境变量的结构。

虽然该相关名始终有效,但仅当 Compute 节点的计算方式属性表明 Compute 节点正在传播 LocalEnvironment 时,它才有意义。

声明 | 商标 | 下载 | 书库 | 支持 | 反馈
Copyright IBM Corporation 1999, 2006 最后一次更新时间:2006/08/14
ac00510_