Crear expresiones

Última actualización: 28/10/2026

Utilice expresiones para calcular valores de columna o definir condiciones al añadir columnas, editar expresiones de columna, crear reglas de transformación o filtrar conjuntos de datos.

El generador de expresiones muestra los elementos disponibles para la tarea actual. Las referencias de tareas de movimiento abarcan las tareas de aterrizaje administrado por SaaS, aterrizaje en lago de datos y replicación. Las expresiones de almacenamiento, transformación y data mart dependen de la plataforma de datos o del motor de tareas. Para las funciones de CDC Storage y Transformación de streaming, consulte Funciones de transformación. Utilice las funciones y la sintaxis disponibles en su editor.

Crear o editar una expresión

1. Abra el generador de expresiones desde la columna, la regla de transformación o el filtro del conjunto de datos que esté configurando.

   Para una expresión de columna, haga clic en en la columna.

2. Seleccione un elemento y, a continuación, haga clic en para insertarlo.

   También puede escribir la expresión. Inserte los parámetros de columna para suministrar valores de cada fila de origen, conservando la sintaxis utilizada por su editor.

   Para insertar un operador desde la barra de herramientas, haga clic en el lugar donde corresponda en la expresión y, a continuación, haga clic en el operador.

3. Reemplace los marcadores de posición de los argumentos de función por parámetros de columna, constantes o expresiones anidadas.

   Incluya las constantes de texto y fecha entre comillas simples, como 'Unknown' y '2026-10-08'. Represente una comilla incrustada con dos comillas: 'O''Brien'. Inserte los números sin comillas, como 12 o 12.5. Utilice NULL para un valor ausente, no el texto 'NULL'.

4. Pruebe la expresión tal como se describe a continuación y, después, haga clic en Aceptar para guardarla.

Usar los elementos de expresión

• Columnas: las columnas del conjunto de datos de origen proporcionan valores de la fila que se está procesando.

  En las tareas de transformación de streaming, esta lista también incluye columnas de ubicación de destino/aterrizaje como hdr__kafka_partition y hdr__file_name, en el orden de origen. Estas son independientes de los encabezados Q_H_ en las expresiones de tareas de movimiento. Vea Tablas de destino.

• Funciones: calcular o convertir valores. Proporcione los argumentos en el orden indicado por la signatura de la función. Vea Funciones de expresión.

  Nota informativaPara las expresiones de Azure Synapse Analytics, $RTRIM y $LTRIM solo recortan espacios, independientemente del carácter de recorte especificado.

• Operadores: combine valores, compárelos o defina condiciones. Utilice paréntesis para controlar el orden de evaluación. Vea Operadores de expresión.

• Encabezados: use metadatos de cambios en tareas de aterrizaje gestionadas por SaaS, aterrizaje en lago de datos y replicación. Consulte Encabezados de expresión para conocer la aplicabilidad del punto de conexión de origen y los valores de la fase de procesamiento.

Ejemplo: Combinar valores de columna

La siguiente expresión une first_file_name y first_file_title con dos puntos:

${first_file_name} || ':' || ${first_file_title}

Para los valores de muestra sales y Sales June 2022, el resultado es sales:Sales June 2022.

Probar expresiones

Utilice valores de parámetros de muestra para comprobar el resultado calculado antes de guardar. La extracción de parámetros identifica las entradas de la expresión; la prueba evalúa la expresión con los valores que proporcione.

1. Haga clic en Extraer parámetros.

2. Introduzca un Valor para probar para cada parámetro, utilizando valores adecuados para el tipo de datos de la columna.

3. Haga clic en Probar expresión y compruebe el resultado.

Si la expresión no es válida, corrija su sintaxis y argumentos, y después vuelva a extraer los parámetros antes de repetir la prueba. Repita con valores representativos, incluidos los valores ausentes cuando proceda. Una prueba de muestra correcta no comprueba todas las filas de origen.