Usa Common Expression Language

Avanzado

Vista previa — Eventarc Advanced

Esta función está sujeta a las "Condiciones de las Ofertas de Fase Previa a la DG" de la sección Condiciones Generales del Servicio de las Condiciones Específicas del Servicio. Las funciones de fase previa a la DG están disponibles “tal cual” y podrían tener asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

Common Expression Language (CEL) es un lenguaje de código abierto que no es Turing-completo y que se puede usar para evaluar expresiones. Cada inscripción en Eventarc Advanced incluye una expresión condicional escrita en CEL que se usa para evaluar y filtrar mensajes. También puedes transformar el contenido de tus datos de eventos escribiendo expresiones de transformación con CEL.

En general, una expresión de condición consiste en una o más declaraciones que se unen a través de operadores lógicos (&&, || o !). Cada declaración expresa una regla basada en atributos que se aplica a los datos. Por lo general, los operadores se usan para comparar el valor que contiene una variable con un valor literal.

Por ejemplo, si el valor de message.type es google.cloud.dataflow.job.v1beta3.statusChanged, la expresión message.type == "google.cloud.dataflow.job.v1beta3.statusChanged" se evalúa como True.

Para obtener más información, consulta lo siguiente:

• Cómo crear una inscripción para recibir eventos
• Cómo transformar los eventos recibidos
• Definición del lenguaje de CEL

Atributos disponibles

Se puede acceder a todos los atributos del contexto del evento como variables a través de un objeto message predefinido. Estas variables se propagan con valores en función de los atributos del contexto del evento en el entorno de ejecución. Una inscripción puede usar una variable para expresar un atributo determinado. Por ejemplo, message.type muestra el valor del atributo type.

Ten en cuenta lo siguiente:

• Los eventos pueden incluir, y las inscripciones pueden usar, cualquier cantidad de atributos personalizados adicionales de CloudEvents con nombres distintos (también conocidos como atributos de extensión). Sin embargo, se representan como tipos String en expresiones CEL, independientemente de su formato real. Puedes usar una expresión en CEL para transmitir sus valores a otros tipos.

• No puedes evaluar las inscripciones en función del contenido de la carga útil del evento. message.data y message.data_base64 son variables reservadas y no se pueden usar en expresiones. Sin embargo, CEL es compatible cuando se transforman los datos de eventos, lo que te permite modificar el contenido de la carga útil del evento (por ejemplo, para satisfacer el contrato de la API de un destino específico).

Se puede acceder a los siguientes atributos cuando se evalúan las expresiones de condición para una inscripción:

Atributo	Tipo de atributo	Descripción
message.datacontenttype	String	Es el tipo de contenido del valor data.
message.dataschema	URI	Identifica el esquema al que se adhiere data.
message.id	String	Identifica el evento. Los productores deben asegurarse de que source + id sea único para cada evento distinto.
message.source	URI-reference	Identifica el contexto en el que ocurrió un evento
message.specversion	String	La versión de la especificación de CloudEvents que usa el evento
message.subject	String	Describe el asunto del evento en el contexto del productor del evento (identificado por source).
message.time	Timestamp	Es la marca de tiempo del momento en que ocurrió el evento. El productor de CloudEvents puede establecerla en otro momento (como la hora actual). Sin embargo, todos los productores del mismo source deben ser coherentes.
message.type	String	Describe el tipo de evento relacionado con el evento de origen.

Operadores y funciones

Puedes usar operadores y funciones para crear expresiones lógicas complejas.

Los operadores lógicos, como &&, ||, y !, te permiten verificar varias variables en una expresión condicional. Por ejemplo, message.time.getFullYear() < 2020 && message.type == "google.cloud.dataflow.job.v1beta3.statusChanged" une dos sentencias y requiere que ambas sean True para producir un resultado general de True.

Nota: Se hace una distinción entre un atributo que no está configurado y uno con un valor vacío. Puedes usar la macro has para probar la existencia de un campo. Por ejemplo, has(message.bucket) muestra True si se establece el atributo de extensión bucket. Si no se establece un atributo, las operaciones lógicas que lo usan siempre se evalúan como False, independientemente del valor literal.

Los operadores de manipulación de cadenas, como x.contains('y'), coinciden con cadenas o subcadenas que defines y te permiten desarrollar reglas para que coincidan con los mensajes sin enumerar todas las combinaciones posibles.

Eventarc Advanced también admite funciones de extensión, como merge y flatten, que se pueden usar para transformar datos y simplificar la modificación de eventos recibidos de un bus.

Consulta la lista de operadores y funciones predefinidos de CEL y macros predefinidas de CEL.

Operadores lógicos

En la siguiente tabla, se describen los operadores lógicos que admite Eventarc Advanced.

Expresión	Descripción
x == "my_string"	Muestra True si x es igual al argumento de literal de cadena constante.
x == R"my_string\n"	Muestra True si x es igual al literal de cadena sin procesar determinado que no interpreta las secuencias de escape. Los literales de cadena sin procesar son convenientes para expresar cadenas que deben usar secuencias de escape, como expresiones regulares o texto de programa.
x == y	Muestra True si x es igual a y.
x != y	Muestra True si x no es igual a y.
x && y	Muestra True si x y y son True.
x || y	Muestra True si x, y o ambos son True.
!x	Muestra True si el valor booleano x es False o muestra False si el valor booleano x es True.
m['k']	Si la clave k está presente, muestra el valor de la clave k en el mapa de cadena a cadena m. Si la clave k no está presente, muestra un error que hace que la regla en evaluación no coincida.

Operadores de manipulación de cadenas

En la siguiente tabla, se describen los operadores de manipulación de cadenas que admite Eventarc Advanced.

Expresión	Descripción
double(x)	Convierte el resultado de la cadena de x en un tipo double. La cadena convertida se puede usar para comparar números de punto flotante con operadores aritméticos estándar, como > y <=. Esto solo funciona para valores que pueden ser números de punto flotante.
int(x)	Convierte el resultado de la cadena de x en un tipo de int. La cadena convertida se puede usar para comparar números enteros con operadores aritméticos estándar, como > y <=. Esto solo funciona para valores que pueden ser números enteros.
x + y	Muestra la cadena concatenada xy.
x.contains(y)	Muestra True si la cadena x contiene la substring y.
x.endsWith(y)	Muestra True si la cadena x termina con la substring y.
x.join()	Muestra una cadena nueva en la que se concatenan los elementos de una lista de cadenas. Acepta un separador opcional que se coloca entre los elementos de la cadena resultante. Por ejemplo, la siguiente expresión muestra 'hello world': ['hello', 'world'].join(' ')
x.lowerAscii()	Muestra una cadena nueva en la que todos los caracteres ASCII están en minúsculas.
x.matches(y)	Muestra True si la cadena x coincide con el patrón RE2 y especificado. El patrón RE2 se compila con la opción RE2::Latin1 que inhabilita las funciones de Unicode.
x.replace(y,z)	Muestra una cadena nueva en la que los casos de la substring y se reemplazan por la substring z. Acepta un argumento opcional que limita la cantidad de reemplazos que se deben realizar. Por ejemplo, la siguiente expresión muestra 'wello hello': 'hello hello'.replace('he', 'we', 1)
x.split(y)	Muestra una lista de cadenas divididas de la entrada por el separador y. Acepta un argumento opcional que limita la cantidad de subcadenas que se deben producir. Por ejemplo, la siguiente expresión muestra ['hello', 'hello hello']: 'hello hello hello'.split(' ', 2)
x.startsWith(y)	Muestra True si la cadena x comienza con la substring y.
x.upperAscii()	Muestra una cadena nueva en la que todos los caracteres ASCII están en mayúsculas.

Funciones de expresión regular

En la siguiente tabla, se describen las funciones de expresiones regulares que admite Eventarc Advanced.

Expresión	Descripción
re.capture(target,regex)	Usa regex para capturar el primer valor de grupo sin nombre o con nombre en la cadena target y muestra una cadena. Por ejemplo, la siguiente expresión muestra "o": re.capture("hello", R"hell(o)")
re.captureN(target,regex)	Usa regex para capturar el nombre y la cadena del grupo (para grupos con nombre) y el índice y la cadena del grupo (para grupos sin nombre) de la cadena target, y muestra un mapa de pares clave-valor. Por ejemplo, la siguiente expresión muestra {"1": "user", "Username": "testuser", "Domain": "testdomain"}: re.captureN("The user testuser belongs to testdomain", R"The (user|domain) (?P.*) belongs to (?P.*)")
re.extract(target,regex,rewrite)	Usa regex para extraer valores de grupo coincidentes de la cadena target y muestra una cadena de los valores extraídos con formato según el argumento rewrite. Por ejemplo, la siguiente expresión muestra "example.com": re.extract("[e-mail]", "(^.*@)(.*)", "\\2")
x.matches(regex)	Muestra True si la cadena x coincide con el patrón RE2 regex especificado. El patrón RE2 se compila con la opción RE2::Latin1 que inhabilita las funciones de Unicode.

Las expresiones regulares siguen la sintaxis RE2. Ten en cuenta que el R que precede a las expresiones regulares indica una cadena sin procesar que no requiere escape.

Funciones de extensión

Eventarc Advanced admite ciertas funciones de extensión que se pueden usar para transformar los datos de eventos recibidos a través de un bus. Para obtener más información y ejemplos, consulta Cómo transformar eventos recibidos.

¿Qué sigue?

• Ejemplos de transformación