Compartir vía

Funciones de expresión en flujos de datos de mapeo

SE APLICA A: Azure Data Factory Azure Synapse Analytics

Sugerencia

Pruebe Data Factory en Microsoft Fabric, una solución de análisis integral 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 la creación de informes. Obtenga información sobre cómo iniciar una nueva evaluación gratuita.

Los flujos de datos están disponibles tanto en canalizaciones de Azure Data Factory como en canalizaciones de Azure Synapse Analytics. Este artículo se aplica a los flujos de datos de asignación. Si no está familiarizado con las transformaciones, consulte el artículo introductorio Transformación de datos mediante flujos de datos de asignación.

En este artículo se proporcionan detalles sobre las funciones de expresión compatibles con Azure Data Factory y Azure Synapse Analytics en flujos de datos de mapeo.

Lista de funciones de expresiones

En las canalizaciones de Azure Data Factory y Azure Synapse Analytics, use el lenguaje para expresiones del flujo de datos de asignación para configurar las transformaciones de datos.

Función de expresión Tarea
abs Proporciona 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 duración a una marca de tiempo. Anexa una matriz de tipo similar a otra. Igual que el operador +.
and Usa el operador lógico AND . Igual que &&.
asin Calcula un valor inverso de seno.
assertErrorMessages Devuelve un 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. Puede comparar valores numéricos, de cadena y datetime.
bitwiseAnd Usa el operador bitwise And en tipos enteros. Igual que el operador &.
bitwiseOr Usa el operador bitwise Or en tipos enteros. Igual que el operador |.
bitwiseXor Usa el operador bitwise Or en tipos enteros. Igual que el operador |.
blake2b Calcula la síntesis de Blake2 de un conjunto de columnas de distintos tipos de datos primitivos cuando se les asigna una longitud de bits. La longitud de bits solo pueden ser múltiplos de 8 entre 8 y 512. Puede usarlo para calcular una huella digital de una fila.
blake2bBinary Calcula la síntesis de Blake2 de un conjunto de columnas de distintos tipos de datos primitivos cuando se les da una longitud de bits, que solo puede ser múltiplo de 8 entre 8 y 512. Puede usarlo para calcular una huella digital de una fila.
case Aplica un valor u otro en función de las condiciones alternas. Si el número de entradas es par, el otro toma el valor predeterminado de 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 o 0 si value1 == value2 y devuelve 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 el hash CRC32 de un conjunto de columnas de distintos tipos de datos primitivos cuando se les asigna una longitud de bits. La longitud del bit debe ser de valores 0 (256), 224, 256, 384y 512. Puede usarlo para calcular una huella digital de una fila.
degrees Convierte radianes en grados.
divide Divide un par de números. Igual que el operador /.
dropLeft Quita tantos caracteres como se especifique a la izquierda de la cadena. Si la colocación solicitada supera la longitud de la cadena, se devuelve una cadena vacía.
dropRight Quita tantos caracteres como se especifique a 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 Usa el operador de comparación es igual que. Igual que el operador ==.
equalsIgnoreCase Usa el operador de igualdad de comparación e ignora la 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, htmly java.
expr Da como resultado una expresión de una cadena. Equivalente a escribir la expresión en un formato no literal. Puede usarlo para pasar parámetros como representaciones de cadena.
factorial Calcula el valor factorial de un número.
false Siempre devuelve un valor false. Use 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 codificada en base64 específica.
greater Usa el operador de comparación mayor que. Igual que el operador >.
greaterOrEqual Usa el 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 conocidos en tiempo de diseño deben abordarse solo con su nombre. No se admiten entradas calculadas, pero puede usar sustituciones de parámetros.
hasError Comprueba si la aserción con el identificador proporcionado se marca como un error.
iif Aplica un valor u otro en función de una condición. Si el otro no está especificado, el valor se considera NULL. Ambos valores deben ser compatibles (por ejemplo, numéricos o de cadena).
iifNull Devuelve el primer elemento no NULL cuando se proporcionan dos o más entradas. Esta función es equivalente a coalesce.
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. Si no se encuentra, 0 se devuelve.
isDelete Comprueba si la fila está marcada para eliminar. En el caso de las transformaciones que toman más de un flujo de entrada, puede pasar el índice (basado en 1) del flujo. El índice de flujo debe ser 1 o 2y el valor predeterminado es 1.
isError Comprueba si la fila se marca como error. En el caso de las transformaciones que toman más de un flujo de entrada, puede pasar el índice (basado en 1) del flujo. El índice de flujo debe ser 1 o 2. El valor predeterminado es 1.
isIgnore Comprueba si se debe omitir la fila. En el caso de las transformaciones que toman más de un flujo de entrada, puede pasar el índice (basado en 1) del flujo. El índice de flujo debe ser 1 o 2. El valor predeterminado es 1.
isInsert Comprueba si la fila está marcada para insertar. En el caso de las transformaciones que toman más de un flujo de entrada, puede pasar el índice (basado en 1) del flujo. El índice de flujo debe ser 1 o 2. El valor predeterminado es 1.
isMatch Comprueba si la fila cumplía los criterios de coincidencia en la búsqueda. En el caso de las transformaciones que toman más de un flujo de entrada, puede pasar el índice (basado en 1) del flujo. El índice de flujo debe ser 1 o 2. El valor predeterminado es 1.
isNull Comprueba si el valor es NULL.
isUpdate Comprueba si la fila está marcada para actualizar. En el caso de las transformaciones que toman más de un flujo de entrada, puede pasar el índice (basado en 1) del flujo. El índice de flujo debe ser 1 o 2. El valor predeterminado es 1.
isUpsert Comprueba si la fila está marcada para insertar. En el caso de las transformaciones que toman más de un flujo de entrada, puede pasar el índice (basado en 1) del flujo. El índice de flujo debe ser 1 o 2. El valor predeterminado es 1.
jaroWinkler Obtiene la distancia de JaroWrinkler entre dos cadenas.
least Usa el operador de comparación menor que o igual que. Igual que el operador <=.
left Extrae una subcadena que comienza en el índice 1 con el número de caracteres. Igual que SUBSTRING(str, 1, n).
length Devuelve la longitud de la cadena.
lesser Usa el operador de comparación menor. Igual que el operador <.
lesserOrEqual Usa el operador de comparación menor que o igual que. Igual que el operador <=.
levenshtein Obtiene la distancia de edición entre dos cadenas.
like Usa un patrón con una cadena que coincide literalmente. La excepción es el símbolo _ especial que coincide con cualquier carácter de la entrada (similar a .* en posix expresiones regulares).
locate Busca la posición (basada en 1) de la subcadena dentro de una cadena que inicia una determinada posición. Si se omite la posición, comience desde el principio de la cadena. Si no se encuentra, 0 se devuelve.
log Calcula el valor del logaritmo. Puede proporcionar una base opcional o, si se usa, un número de Euler.
log10 Calcula el valor del registro en función de una base de 10.
lower Pone en minúsculas una cadena.
lpad El lado izquierdo de la cadena se rellena con el relleno proporcionado hasta alcanzar una longitud determinada. Si la cadena es igual o mayor que la longitud, la cadena se recorta a la longitud.
ltrim Left recorta una cadena de caracteres iniciales. Si el segundo parámetro no está especificado, recorta el espacio en blanco. De lo contrario, recorta cualquier carácter especificado en el segundo parámetro.
md5 Calcula la síntesis MD5 de un conjunto de columnas de distintos tipos de datos primitivos y devuelve una cadena hexadecimal de 32 caracteres. Puede usarlo para calcular una huella digital de una fila.
minus Resta números. Resta el número de días a una fecha. Resta la duración a una marca de tiempo. Resta dos marcas de tiempo para obtener la diferencia en milisegundos. Igual que el operador -.
mod Proporciona el módulo de un par de números. Igual que el operador %.
multiply Multiplica un par de 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 solo es consecutivo dentro de una partición y tiene el prefijo id. de partición.
normalize Normaliza el valor de cadena para separar los caracteres Unicode acentuados.
not Usa el operador de negación lógica.
notEquals Usa el operador de comparación no es igual que. Igual que el operador !=.
null Devuelve un NULL valor. Use la función syntax(null()) si hay una columna denominada null. Cualquier operación que lo use da como resultado un NULL.
or Usa el operador lógico OR . Igual que ||.
pMod Proporciona el módulo positivo de un par de números.
partitionId Devuelve el identificador de partición actual en el que se encuentra la fila de entrada.
power Eleva un número a la potencia de otro.
radians Convierte los grados en radianes.
random Devuelve un número aleatorio cuando se proporciona una semilla opcional dentro de una partición. El valor de inicialización debe ser un valor fijo y se usa con el identificador de partición para generar valores aleatorios.
regexExtract Extrae una subcadena coincidente para un patrón regex específico. El último parámetro identifica el grupo de coincidencias y el valor predeterminado es 1 si se omite. Use `<regex>` para que coincida con una cadena sin escape.
regexMatch Comprueba si la cadena coincide con el patrón regex específico. Use `<regex>` para que coincida con una cadena sin escape.
regexReplace Reemplaza todas las apariciones de un patrón regex por otra subcadena en la cadena específica. Use `<regex>` 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 apariciones de una subcadena por otra subcadena de la cadena específica. 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 regex específico.
round Redondea un número cuando se proporciona una escala opcional y un modo de redondeo opcional. Si se omite la escala, el valor predeterminado es 0. Si se omite el modo, el valor predeterminado es ROUND_HALF_UP(5).
rpad Rellena la cadena a la derecha con el relleno proporcionado hasta que alcance una longitud determinada. Si la cadena es igual o mayor que la longitud, la cadena se recorta a la longitud.
rtrim Right recorta una cadena de caracteres finales. Si el segundo parámetro no está especificado, recorta el espacio en blanco. De lo contrario, recorta cualquier carácter especificado en el segundo parámetro.
sha1 Calcula la síntesis SHA-1 de un conjunto de columnas de distintos tipos de datos primitivos y devuelve una cadena hexadecimal de 40 caracteres. Puede usarlo para calcular una huella digital de una fila.
sha2 Calcula la síntesis SHA-2 de un conjunto de columnas de distintos tipos de datos primitivos cuando se da una longitud de bits, que solo puede ser de valores 0 (256), 224, 256, 384y 512. Puede usarlo 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 se omite la longitud, el valor predeterminado es el final de la cadena.
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 reemplazo uno a uno.
trim Recorta una cadena de caracteres iniciales y finales. Si el segundo parámetro no está especificado, recorta el espacio en blanco. De lo contrario, recorta cualquier carácter especificado en el segundo parámetro.
true Siempre devuelve un valor true. Use la función syntax(true()) si una columna se denomina true.
typeMatch Coincide con el tipo de la columna. Se usa solo en expresiones de patrones. El número puede coincidir con short, integer, long, double, float o decimal. Entero coincide con short, integer y long. Las fracciones son compatibles con los tipos double, float y decimal. Datetime coincide con el tipo de marca de fecha o hora.
unescape Elimina el escape de una cadena según un formato. Los valores literales para el formato aceptable son json, xml, ecmascript, htmly java.
upper Pone en mayúsculas una cadena.
uuid Devuelve el UUID generado.
xor Proporciona el operador lógico XOR . Igual que el operador ^.

Contenido relacionado

  • Last updated on