Nombres de correlaciones

Un nombre de correlación es una referencia de campo que identifica un punto de partida bien definido en el árbol lógico de mensaje y se utiliza en referencias de campo para describir una parte estándar del formato de árbol.

Cuando accede a datos en uno de los cuatro árboles (Mensaje, Entorno, Entorno local o Lista de excepciones), los nombres de correlaciones que puede utilizar dependen del nodo para el que crea ESQL o correlaciones, y si el nodo crea un mensaje de salida. Por ejemplo, un nodo Trace no altera el contenido del mensaje cuando pasa por el nodo, pero un nodo Compute puede crear un nuevo mensaje de salida.

Puede introducir nuevos nombres de correlaciones con expresiones SELECT, predicados cuantificados y sentencias FOR. Puede crear nombres que no sean de correlaciones en un nodo utilizando variables de referencia.

Nombres de correlaciones en nodos que no crean un mensaje de salida

La mayor parte de nodos de flujos de mensajes no crean un mensaje de salida; todas las expresiones ESQL que grabe en módulos ESQL o en correlaciones dentro de estos nodos hacen referencia sólo al mensaje de entrada. Puede utilizar los siguientes nombres de correlaciones en los nodos Database y Filter (módulos ESQL). No puede utilizar estos nombres de correlaciones en la expresión de una correlación para un nodo Mapping, Extract, Warehouse, DataInsert, DataUpdate o DataDelete.

Root
El elemento raíz del mensaje que pasa por el nodo.
Body
El último hijo del elemento raíz del mensaje, es decir, el cuerpo del mensaje. Es un alias para Root.*[<].

Para obtener una descripción de la utilización de *, consulte Utilización de referencias de campo anónimas.

DestinationList
La estructura que contiene las variables actuales de entorno local disponibles en el nodo. El nombre preferido es LocalEnvironment, aunque puede utilizarse el nombre de correlación DestinationList para compatibilidad con versiones anteriores.
Properties
Las propiedades estándar del mensaje de entrada.
ExceptionList
La estructura que contiene la lista de excepciones actual a la que tiene acceso el nodo.
Environment
La estructura que contiene las variables actuales de entorno global disponibles en el nodo. El entorno puede leerse y actualizarse desde cualquier nodo para el que pueda crear correlaciones o código ESQL.
LocalEnvironment
La estructura que contiene las variables actuales de entorno local disponibles en el nodo. LocalEnvironment puede leerse y actualizarse desde cualquier nodo para el que pueda crear correlaciones o código ESQL.

Nombres de correlaciones en nodos que crean un mensaje de salida

Si codifica ESQL para un nodo Compute, los nombres de correlaciones son distintos porque hay implicados dos árboles de mensaje: el mensaje de entrada y el mensaje de salida. Los nombres de correlaciones en ESQL dentro de estos nodos son:

Environment
La estructura que contiene las variables actuales de entorno global disponibles en el nodo. Environment puede leerse y actualizarse.
InputRoot
El elemento raíz del mensaje de entrada.
InputBody
El último hijo del elemento raíz del mensaje de entrada. Es un alias para InputRoot.*[<].

Para obtener una descripción de la utilización de *, consulte Utilización de referencias de campo anónimas.

InputProperties
Las propiedades estándar del mensaje de entrada.
InputDestinationList
La estructura que contiene las variables de entorno local para el mensaje que pasa por el nodo. Utilice el nombre de correlación InputDestinationList para compatibilidad con versiones anteriores; si no necesita esta compatibilidad, utilice preferentemente el nombre InputLocalEnvironment
InputExceptionList
La estructura que contiene la lista de excepciones para el mensaje que pasa por el nodo.
InputLocalEnvironment
La estructura que contiene las variables de entorno local para el mensaje que pasa por el nodo.
OutputRoot
El elemento raíz del mensaje de salida.

En un nodo Compute, no hay el nombre de correlación OutputBody.

OutputDestinationList
La estructura que contiene las variables de entorno local que se envían desde el nodo. Utilice el nombre de correlación OutputDestinationList para compatibilidad con versiones anteriores; si no necesita esta compatibilidad, utilice preferentemente el nombre OutputLocalEnvironment
OutputExceptionList
La estructura que contiene la lista de excepciones que genera el nodo.

Aunque este nombre de correlación siempre es válido, sólo tiene significado cuando la propiedad Modalidad de cálculo del nodo Compute indica que este nodo está propagando la lista de excepciones.

OutputLocalEnvironment
La estructura que contiene las variables de entorno local que se envían desde el nodo.

Aunque este nombre de correlación siempre es válido, sólo tiene significado cuando la propiedad Modalidad de cálculo del nodo Compute indica que este nodo está propagando el entorno local.

Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión
Copyright IBM Corporation 1999, 2006 Última actualización: 22/08/2006
ac00510_