Funciones de matriz 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 matriz compatibles con Azure Data Factory y Azure Synapse Analytics en los flujos de datos de asignación.

Lista de funciones de matriz

Las funciones de matriz realizan transformaciones sobre estructuras de datos que son matrices. Estas incluyen palabras clave especiales para direccionar elementos de matriz e índices:

  • #acc representa un valor que se desea incluir en la salida única al reducir una matriz.
  • #index representa el índice de la matriz actual, junto con los números de índice de la matriz #index2, #index3 ....
  • #item representa el valor del elemento actual de la matriz.
Función de matriz Tarea
array Crea una matriz de elementos. Todos los elementos deben ser del mismo tipo. Si no se especifica ningún elemento, una matriz de cadenas vacías es el valor predeterminado. Igual que un operador de creación [].
at Busca el elemento en un índice de matrices. El índice es de base 1. El índice fuera de los límites da como resultado un valor NULL. Busca un valor en una asignación dada una clave. Si no se encuentra la clave, devuelve NULL.
contains Devuelve true si algún elemento de la matriz proporcionada se evalúa como true en el predicado proporcionado. "Contains" espera una referencia a un elemento de la función de predicado como #item.
distinct Devuelve un conjunto distinto de elementos de una matriz.
except Devuelve un conjunto de diferencias de una matriz desde otros duplicados eliminados.
filter Filtra los elementos de la matriz que no cumplen el predicado proporcionado. "Filter" espera una referencia a un elemento de la función de predicado como #item.
find Find the first item from an array that match the condition. It takes a filter function where you can address the item in the array as #item. For deeply nested maps you can refer to the parent maps using the #item_n(#item_1, #item_2...) notation.
flatten Acopla una o varias matrices en una sola. Las matrices de elementos atómicos se devuelven sin modificar. El último argumento es opcional y su valor predeterminado es false para acoplar de manera recursiva más de un nivel de profundidad.
in Comprueba si un elemento está en la matriz.
intersect Devuelve un conjunto de intersección de elementos distintos de dos matrices.
map Asigna cada elemento de la matriz a un nuevo elemento mediante la expresión proporcionada. La asignación espera una referencia a un elemento de la función de expresión como #item.
mapIf Asigna de manera condicional una matriz a otra de la misma longitud o más corta. The values can be of any datatype including structTypes. It takes a mapping function where you can address the item in the array as #item and current index as #index. En el caso de asignaciones con anidaciones muy profundas, puede consultar las asignaciones primarias mediante la notación #item_[n](#item_1, #index_1...).
mapIndex Asigna cada elemento de la matriz a un nuevo elemento mediante la expresión proporcionada. Map espera una referencia a un elemento en la función de expresión como #item y una referencia al índice del elemento como #index.
mapLoop Produce un bucle desde 1 hasta la longitud para crear una matriz de esa longitud. It takes a mapping function where you can address the index in the array as #index. En el caso de asignaciones con anidaciones muy profundas, puede consultar las asignaciones primarias mediante la notación #index_n(#index_1, #index_2...).
reduce Acumula los elementos de una matriz. "Reduce" espera una referencia a un acumulador y a un elemento en la primera función de expresión, como #acc y #item, y espera que el valor resultante sea #result para poder usarlo en la segunda función de expresión.
size Busca el tamaño de una matriz o un tipo de asignación.
slice Extrae un subconjunto de una matriz 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.
sort Ordena la matriz mediante la función de predicado proporcionada. "Sort" espera una referencia a dos elementos consecutivos de la función de expresión, como #item1 y #item2.
unfold Despliega una matriz en un conjunto de filas y repite los valores de las columnas restantes en cada fila.
union Devuelve un conjunto de uniones de elementos distintos de dos matrices.