Nombres de correlación

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

Cuando accedes a datos en cualquiera de los árboles (mensaje, entorno, entorno local, contexto o lista de excepciones), los nombres de correlación que puedes utilizar dependen del nodo para el que crees ESQL o mapeos, y de 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 correlación con expresiones SELECT, predicados cuantificados y sentencias FOR. Puede crear nombres que no sean de correlación en un nodo utilizando variables de referencia.

Nombres de correlación 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. Utilice los siguientes nombres de correlación en los módulos ESQL que escriba para nodos Database y Filter:

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. Este nombre es un alias para Root.*[<].
Properties: Las propiedades estándar del mensaje de entrada.
Environment: La estructura que contiene las variables de entorno globales actuales que están disponibles para el nodo. Environment puede leerse y actualizarse desde cualquier nodo para el que pueda crear correlaciones o código ESQL.
LocalEnvironment: La estructura que contiene las variables de entorno locales actuales que están disponibles para el nodo. LocalEnvironment puede leerse y actualizarse desde cualquier nodo para el que pueda crear correlaciones o código ESQL.
DestinationList: La estructura que contiene las variables de entorno locales actuales disponibles para el nodo. El nombre preferido es LocalEnvironment, aunque puede utilizarse el nombre de correlación DestinationList para compatibilidad con versiones anteriores.
ExceptionList: La estructura que contiene la lista de excepciones actual a la que tiene acceso el nodo.
Contexto: La estructura que contiene FlowDetails, InvocationDetails, y la carga útil de salida de cada nodo que se propaga a través de los nodos en el flujo. El árbol contextual es de sólo lectura.
Para más información, véase Árbol contextual.

No puede utilizar estos nombres de correlación en la expresión de una correlación para un nodo Mapping.

Nombres de correlación en nodos que crean un mensaje de salida

Si codifica ESQL para un nodo Compute, los nombres de correlación deben distinguir entre los dos árboles de mensaje implicados: el mensaje de entrada y el mensaje de salida. Los nombres de correlación en ESQL dentro de estos nodos son:

InputBody: El último hijo del elemento raíz del mensaje de entrada. Este nombre es un alias para InputRoot.*[<].
InputRoot: El elemento raíz del mensaje de entrada.
InputProperties: Las propiedades estándar del mensaje de entrada.
Environment: La estructura que contiene las variables de entorno globales actuales que están disponibles para el nodo. Environment puede leerse y actualizarse.
InputLocalEnvironment: La estructura que contiene las variables de entorno locales para el mensaje que pasa por el nodo.
InputDestinationList: La estructura que contiene las variables de entorno locales 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 el nombre preferido InputLocalEnvironment
InputExceptionList: La estructura que contiene la lista de excepciones para el mensaje que pasa por el nodo.
OutputRoot: El elemento raíz del mensaje de salida.
En un nodo Compute, el nombre de correlación OutputBody no es válido.
OutputLocalEnvironment: La estructura que contiene las variables de entorno locales 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.
OutputDestinationList: La estructura que contiene las variables de entorno locales 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 el nombre preferido OutputLocalEnvironment
OutputExceptionList: La estructura que contiene la lista de excepciones que está generando 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.
Contexto: La estructura que contiene FlowDetails, InvocationDetails, y la carga útil de salida de cada nodo que se propaga a través de los nodos en el flujo. El árbol contextual es de sólo lectura.
Para más información, véase Árbol contextual.

Para obtener una descripción de cómo utilizar *, consulte Utilización de referencias de campo anónimas.