Compartir a través de


Funciones de expresiones en el flujo de datos de asignación

SE APLICA A: Azure Data Factory Azure Synapse Analytics

Sugerencia

Pruebe Data Factory en Microsoft Fabric, una solución de análisis todo en uno para empresas. Microsoft Fabric abarca todo, desde el movimiento de datos hasta la ciencia de datos, el análisis en tiempo real, la inteligencia empresarial y los informes. Obtenga información sobre cómo iniciar una nueva evaluación gratuita.

Los flujos de datos están disponibles en las canalizaciones Azure Data Factory y Azure Synapse. Este artículo se aplica a los flujos de datos de asignación. Si carece de experiencia con las transformaciones, consulte el artículo de introducción Transformación de datos mediante flujos de datos de asignación.

En los siguientes artículos se proporcionan detalles sobre las funciones de expresiones compatibles con Azure Data Factory y Azure Synapse Analytics en los flujos de datos de asignación.

Lista de funciones de expresiones

En las canalizaciones de Data Factory y Synapse, use el lenguaje de expresiones de la característica de flujo de datos de asignación para configurar transformaciones de datos.

Función de expresión Tarea
abs El valor absoluto de un número.
acos Calcula un valor inverso de coseno.
add Agrega un par de cadenas o números. Agrega una fecha a un número de días. Agrega una vigencia a una marca de tiempo. Anexa una matriz de tipo similar a otra. Igual que el operador +.
and Operador lógico AND. Igual que &&.
asin Calcula un valor inverso de seno.
assertErrorMessages Devuelve el mapa de todos los mensajes de aserción.
atan Calcula un valor inverso de tangente.
atan2 Devuelve el ángulo en radianes entre el eje X positivo de un plano y el punto que especificaron las coordenadas.
between Comprueba si el primer valor se encuentra entre otros dos valores, ambos inclusive. Se pueden comparar valores numéricos, de cadena y de fecha y hora
bitwiseAnd Operador AND bit a bit entre tipos enteros. Igual que y operador.
bitwiseOr Operador OR bit a bit entre tipos enteros. Igual que el operador |.
bitwiseXor Operador OR bit a bit entre tipos enteros. Igual que el operador |.
blake2b Calcula la síntesis del mensaje Blake2 del conjunto de columnas de distintos tipos de datos primitivos dada una longitud de bits. La longitud de bits solo pueden ser múltiplos de 8 entre 8 y 512. Se puede usar para calcular una huella digital de una fila.
blake2bBinary Calcula la síntesis de Blake2 del conjunto de columnas de distintos tipos de datos primitivos con una longitud de bits, que solo puede ser múltiplo de 8 entre 8 y 512. Se puede usar para calcular una huella digital de una fila.
case Basándose en una condición alternativa, aplica un valor o el otro. Si el número de entradas es par, el otro se establece de manera predeterminada en NULL para la última condición.
cbrt Calcula la raíz cúbica de un número.
ceil Devuelve el entero más pequeño no menor que el número.
coalesce Devuelve el primer valor no NULL de un conjunto de entradas. Todas las entradas deben ser del mismo tipo.
columnNames Obtiene los nombres de todas las columnas de salida de una secuencia. Puede pasar un nombre de secuencia opcional como primer argumento y un segundo argumento opcional para devolver solo columnas de desfase de esquema.
columns Obtiene los valores de todas las columnas de salida de una secuencia. Puede pasar un nombre de secuencia opcional como segundo argumento.
compare Compara dos valores del mismo tipo. Devuelve un entero negativo si value1 < value2, 0 si value1 == value2, un valor positivo si value1 > value2.
concat Concatena un número variable de cadenas. Igual que el operador + con cadenas.
concatWS Concatena un número variable de cadenas con un separador. El primer parámetro es el separador.
cos Calcula un valor de coseno.
cosh Calcula un coseno hiperbólico de un valor.
crc32 Calcula la síntesis del mensaje CRC32 del conjunto de columnas de diferentes tipos de datos primitivos dada una longitud en bits. La longitud del bit debe tener los valores 0 (256), 224, 256, 384 o 512. Se puede usar para calcular una huella digital de una fila.
degrees Convierte radianes en grados.
divide Divide dos números. Igual que el operador /.
dropLeft Quita los mismos caracteres de la izquierda de la cadena. Si la colocación solicitada supera la longitud de la cadena, se devuelve una cadena vacía.
dropRight Quita los mismos caracteres de la derecha de la cadena. Si la colocación solicitada supera la longitud de la cadena, se devuelve una cadena vacía.
endsWith Comprueba si la cadena finaliza con la cadena proporcionada.
equals Operador de comparación igual que. Igual que el operador ==.
equalsIgnoreCase Operador de comparación igual que sin distinción entre mayúsculas y minúsculas. Igual que el operador <=>.
escape Escapa una cadena según un formato. Los valores literales para el formato aceptable son "json", "xml", "ecmascript", "html", "java".
expr Da como resultado una expresión de una cadena. Equivale a escribir la expresión en un formato no literal y se puede usar para pasar parámetros como representaciones de cadena.
factorial Calcula el valor factorial de un número.
false Siempre devuelve un valor false. Utilice la función syntax(false()) si hay una columna denominada "false".
floor Devuelve el entero más grande no mayor que el número.
fromBase64 Descodifica la cadena con codificación base64 especificada.
greater Operador de comparación mayor que. Igual que el operador >.
greaterOrEqual Operador de comparación mayor que o igual que. Igual que el operador >=.
greatest Devuelve el valor mayor entre la lista de valores como entrada, omitiendo los valores NULL. Devuelve NULL si todas las entradas son NULL.
hasColumn Comprueba un valor de columna por el nombre en la secuencia. Puede pasar un nombre de secuencia opcional como segundo argumento. Los nombres de columna que se conocen en tiempo de diseño deben tratarse simplemente por su nombre. No se admiten entradas calculadas, pero se pueden usar sustituciones de parámetros.
hasError Comprueba si la aserción con el id. indicado está marcada como error.
iif Basándose en una condición, aplica un valor o el otro. Si "Otro" si no se especifica, se considera NULL. Ambos valores deben ser compatibles (numéricos, cadena...).
iifNull Dadas dos o más entradas, devuelve el primer elemento no NULL. Esta función es equivalente a fusionar.
initCap Convierte la primera letra de cada palabra en mayúsculas. Las palabras se identifican como separadas por espacios en blanco.
instr Busca la posición (basada en 1) de la subcadena dentro de una cadena. Se devuelve 0 si no se encuentra.
isDelete Comprueba si la fila está marcada para eliminar. En las transformaciones que toman más de un flujo de entrada, se puede pasar el índice (basado en 1) del flujo. El índice de flujo debe ser 1 o 2 y el valor predeterminado es 1.
isError Comprueba si la fila se marca como error. En las transformaciones que toman más de un flujo de entrada, se puede pasar el índice (basado en 1) del flujo. El índice de flujo debe ser 1 o 2 y el valor predeterminado es 1.
isIgnore Comprueba si la fila se marca para pasarse por alto. En las transformaciones que toman más de un flujo de entrada, se puede pasar el índice (basado en 1) del flujo. El índice de flujo debe ser 1 o 2 y el valor predeterminado es 1.
isInsert Comprueba si la fila está marcada para insertar. En las transformaciones que toman más de un flujo de entrada, se puede pasar el índice (basado en 1) del flujo. El índice de flujo debe ser 1 o 2 y el valor predeterminado es 1.
isMatch Comprueba si la fila cumplía los criterios de coincidencia en la búsqueda. En las transformaciones que toman más de un flujo de entrada, se puede pasar el índice (basado en 1) del flujo. El índice de flujo debe ser 1 o 2 y el valor predeterminado es 1.
isNull Comprueba si el valor es NULL.
isUpdate Comprueba si la fila está marcada para actualizar. En las transformaciones que toman más de un flujo de entrada, se puede pasar el índice (basado en 1) del flujo. El índice de flujo debe ser 1 o 2 y el valor predeterminado es 1.
isUpsert Comprueba si la fila está marcada para insertar. En las transformaciones que toman más de un flujo de entrada, se puede pasar el índice (basado en 1) del flujo. El índice de flujo debe ser 1 o 2 y el valor predeterminado es 1.
jaroWinkler Obtiene la distancia de JaroWrinkler entre dos cadenas.
least Operador de comparación menor que o igual que. Igual que el operador <=.
left Extrae un inicio de la subcadena en el índice 1 con el número de caracteres. Igual que SUBSTRING(str, 1, n).
length Devuelve la longitud de la cadena.
lesser Operador de comparación menor que. Igual que el operador <.
lesserOrEqual Operador de comparación menor que o igual que. Igual que el operador <=.
levenshtein Obtiene la distancia de edición entre dos cadenas.
like El patrón es una cadena que se hace coincidir literalmente. Las excepciones son los siguientes símbolos especiales: _ coincide con cualquier carácter en la entrada (similar a . en las expresiones regulares posix)
locate Busca la posición (basada en 1) de la subcadena dentro de una cadena a partir de una posición determinada. Si la posición se omite se considera desde el principio de la cadena. Se devuelve 0 si no se encuentra.
log Calcula el valor del logaritmo. Se puede suministrar una base opcional o un número de Euler si se usa.
log10 Calcula el valor del logaritmo en base 10.
lower Pone en minúsculas una cadena.
lpad Left rellena la cadena mediante el carácter de relleno proporcionado hasta que se alcanza una determinada longitud. Si la cadena es igual o mayor que la longitud, se recorta para cumplir con la longitud.
ltrim Left recorta una cadena de caracteres iniciales. Si no se especifica el segundo parámetro, recorta el espacio en blanco. Si no, recorta cualquier carácter especificado en el segundo parámetro.
md5 Calcula la síntesis del mensaje MD5 del conjunto de columnas de diferentes tipos de datos primitivos y devuelve una cadena hexadecimal de 32 caracteres. Se puede usar para calcular una huella digital de una fila.
minus Resta números. Restar el número de días a partir de una fecha. Resta la vigencia de una marca de tiempo. Resta dos marcas de tiempo para obtener la diferencia en milisegundos. Igual que el operador -.
mod Módulo de par de números. Igual que el operador %.
multiply Multiplica dos números. Igual que el operador *.
negate Niega un número. Convierte los números positivos en negativos y viceversa.
nextSequence Devuelve la siguiente secuencia única. El número es consecutivo solo dentro de una partición y viene precedido por el identificador de la partición.
normalize Normaliza el valor de la cadena para separar caracteres Unicode acentuados.
not Operador de negación lógica.
notEquals Operador de comparación no igual que. Igual que el operador !=.
null Devuelve un valor NULL. Use la función syntax(null()) si hay una columna denominada "null". Cualquier operación que use dará como resultado un valor NULL.
or Operador lógico OR. Igual que ||.
pMod Módulo positivo de par de números.
partitionId Devuelve el identificador de la partición actual en donde se encuentra la fila de entrada.
power Eleva un número a la potencia de otro.
radians Convierte grados en radianes.
random Devuelve un número aleatorio dado un valor de inicialización opcional dentro de una partición. El valor de inicialización debe ser un valor fijo y se usa con partitionId para generar valores aleatorios.
regexExtract Extrae una subcadena coincidente para un patrón de expresión regular especificado. El último parámetro identifica el grupo de coincidencia y, si se omite, se usa el valor predeterminado 1. Use `<regex>` (comilla inversa) para que coincida con una cadena sin escape.
regexMatch Comprueba si la cadena coincide con el patrón de expresión regular especificado. Use `<regex>` (comilla inversa) para que coincida con una cadena sin escape.
regexReplace Reemplaza todas las repeticiones de un patrón de expresión regular por otra subcadena en la cadena dada. Use `<regex>` (comilla inversa) para que coincida con una cadena sin escape.
regexSplit Divide una cadena según un delimitador basándose en la expresión regular y devuelve una matriz de cadenas.
replace Reemplaza todas las repeticiones de una subcadena por otra subcadena en la cadena dada. Si se omite el último parámetro, el valor predeterminado es una cadena vacía.
reverse Invierte una cadena.
right Extrae una subcadena con el número de caracteres de la derecha. Igual que SUBSTRING(str, LENGTH(str) - n, n).
rlike Comprueba si la cadena coincide con el patrón de expresión regular especificado.
round Redondea un número con una escala opcional y un modo de redondeo opcional dados. Si la escala se omite, se establece en 0 de manera predeterminada. Si el modo se omite, se establece en ROUND_HALF_UP(5) de manera predeterminada. Los valores de redondeo incluyen
rpad Right rellena la cadena mediante el carácter de relleno proporcionado hasta que se alcanza una determinada longitud. Si la cadena es igual o mayor que la longitud, se recorta para cumplir con la longitud.
rtrim Right recorta una cadena de caracteres finales. Si no se especifica el segundo parámetro, recorta el espacio en blanco. Si no, recorta cualquier carácter especificado en el segundo parámetro.
sha1 Calcula la síntesis del mensaje SHA-1 del conjunto de columnas de diferentes tipos de datos primitivos y devuelve una cadena hexadecimal de 40 caracteres. Se puede usar para calcular una huella digital de una fila.
sha2 Calcula la síntesis del mensaje SHA-2 del conjunto de columnas de diferentes tipos de datos primitivos dada una longitud en bits, que solo puede tener los valores 0(256), 224, 256, 384 y 512. Se puede usar para calcular una huella digital de una fila.
sin Calcula un valor de seno.
sinh Calcula un valor de seno hiperbólico.
soundex Obtiene el código soundex de la cadena.
split Divide una cadena según un delimitador y devuelve una matriz de cadenas.
sqrt Calcula la raíz cuadrada de un número.
startsWith Comprueba si la cadena comienza por la cadena proporcionada.
substring Extrae una subcadena de una determinada longitud de una posición. La posición se basa en 1. Si la longitud se omite, se establece el final de la cadena como valor predeterminado.
substringIndex Extrae la subcadena antes de count repeticiones del delimitador. Si count es positivo, se devuelve todo lo que se encuentra a la izquierda del delimitador final (contando desde la izquierda). Si count es negativo, se devuelve todo lo que se encuentra a la derecha del delimitador final (contando desde la derecha).
tan Calcula un valor de tangente.
tanh Calcula un valor de tangente hiperbólica.
translate Reemplaza un conjunto de caracteres por otro conjunto de caracteres de la cadena. Los caracteres tienen un reemplazo de 1 a 1.
trim Recorta una cadena de caracteres iniciales y finales. Si no se especifica el segundo parámetro, recorta el espacio en blanco. Si no, recorta cualquier carácter especificado en el segundo parámetro.
true Siempre devuelve un valor true. Use la función syntax(true()) si hay una columna denominada "true".
typeMatch Coincide con el tipo de la columna. Solo se puede usar en expresiones de patrón. "number" coincide con los tipos short, entero, long, double, float o decimal; "integral" coincide con los tipos short, entero y long; "fractional" coincide con los tipos double, float y decimal; "datetime" coincide con los tipos de date o timestamp.
unescape Elimina el escape de una cadena según un formato. Los valores literales para el formato aceptable son "json", "xml", "ecmascript", "html", "java".
upper Pone en mayúsculas una cadena.
uuid Devuelve el UUID generado.
xor Operador XOR lógico. Igual que el operador ^.