Compartilhar via


Funções de matriz em fluxos de dados de mapeamento

APLICA-SE A: Azure Data Factory Azure Synapse Analytics

Dica

Experimente o Data Factory no Microsoft Fabric, uma solução de análise completa para empresas. O Microsoft Fabric abrange desde movimentação de dados até ciência de dados, análise em tempo real, business intelligence e relatórios. Saiba como iniciar uma nova avaliação gratuitamente!

Os fluxos de dados estão disponíveis em pipelines do Azure Data Factory e pipelines do Azure Synapse Analytics. Este artigo se aplica ao fluxo de dados de mapeamento. Se você for novo em transformações, consulte o artigo introdutório Transformar dados usando fluxos de dados de mapeamento.

Este artigo fornece detalhes sobre as funções de matriz compatíveis com o Azure Data Factory e o Azure Synapse Analytics no mapeamento de fluxos de dados.

Lista de funções de matriz

As funções de matriz executam transformações em estruturas de dados que são matrizes. Palavras-chave especiais abordam elementos e índices da matriz de endereços:

  • #acc representa um valor que você deseja incluir em sua única saída ao reduzir uma matriz.
  • #index representa o índice de matriz atual, juntamente com os números de índice #index2, #index3 ... da matriz.
  • #item representa o valor do elemento atual na matriz.
Função matriz Tarefa
array Cria uma matriz de itens. Todos os itens devem ser do mesmo tipo. Se nenhum item for especificado, o padrão será uma matriz de cadeia de caracteres vazia. O mesmo que um operador de criação [].
at Localiza o elemento em um índice de matriz. O índice é baseado em 1. O índice fora dos limites resulta em um valor nulo. Localiza um valor em um mapa quando uma chave é fornecida. Se a chave não for encontrada, ela retornará nulo.
contains Retornará true se algum elemento na matriz fornecida for avaliado como true no predicado fornecido. A função contains espera uma referência a um elemento, tal como na função de predicado #item.
distinct Retorna um conjunto distinto de itens de uma matriz.
except Retorna um conjunto de diferenças de uma matriz de outras duplicatas descartadas.
filter Filtra elementos da matriz que não atendem ao predicado fornecido. A função filter espera uma referência a um elemento na função de predicado, atuando como #item.
find Localiza o primeiro item de uma matriz que corresponde à condição. Ele usa uma filter função em que você pode abordar o item na matriz como #item. Para mapas profundamente aninhados, consulte os mapas pai usando a notação #item_n(#item_1, #item_2...).
flatten Nivela uma matriz ou matrizes em uma única matriz. Matrizes de itens atômicos são retornadas sem alteração. O último argumento é opcional e padronizado como falso para mesclar recursivamente mais do que um nível de profundidade.
Em Verifica se um item está na matriz.
intersect Retorna um conjunto de interseção de itens distintos de duas matrizes.
map Mapeia cada elemento da matriz para um novo elemento usando a expressão fornecida. A função map espera por uma referência a um elemento dentro da função de expressão identificado como #item.
mapIf Mapeia condicionalmente uma matriz para outra matriz do mesmo tamanho ou menor. Os valores podem ser de qualquer tipo de dados, incluindo structTypes. Ele usa uma função de mapeamento em que você pode abordar o item na matriz como #item e o índice atual como #index. Para mapas profundamente aninhados, consulte os mapas pai usando a notação #item_[n](#item_1, #index_1...).
mapIndex Mapeia cada elemento da matriz para um novo elemento usando a expressão fornecida. A função map espera uma referência a um elemento na função de expressão como #item e uma referência ao índice do elemento como #index.
mapLoop Faz um loop de 1 até o comprimento para criar uma matriz desse comprimento. Ele usa uma função de mapeamento em que você pode abordar o índice na matriz como #index. Para mapas profundamente aninhados, consulte os mapas pai usando a notação #index_n(#index_1, #index_2...).
reduce Acumula elementos em uma matriz. A função reduce espera uma referência a um acumulador e um elemento na primeira função de expressão, atuando como #acc e #item. Ele espera que o valor #result resultante seja usado na segunda função de expressão.
size Localiza o tamanho de uma matriz ou tipo de mapa.
slice Extrai um subconjunto de uma matriz a partir de uma posição. A posição é baseada em 1. Se o comprimento for omitido, ele usará como padrão o final da cadeia de caracteres.
sort Classifica a matriz usando a função de predicado fornecida. A função sort espera uma referência a dois elementos consecutivos na expressão da função como #item1 e #item2.
unfold Desdobra uma matriz em um conjunto de linhas e repete os valores para as colunas restantes em cada linha.
union Retorna um conjunto de união de itens distintos de duas matrizes.

Outras funções disponíveis