Funções de matriz no mapeamento do fluxo de dados

APLICA-SE A: Azure Data Factory Azure Synapse Analytics

Gorjeta

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

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

Os artigos a seguir fornecem detalhes sobre funções de matriz suportadas pelo Azure Data Factory e pelo 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. Estes incluem palavras-chave especiais para abordar elementos de matriz e índices:

  • #acc representa um valor que você deseja incluir em sua saída única ao reduzir uma matriz
  • #index representa o índice de matriz atual, juntamente com os números de índice de matriz #index2, #index3 ...
  • #item representa o valor do elemento atual na matriz
Função de matriz Task
matriz Cria uma matriz de itens. Todos os itens devem ser do mesmo tipo. Se nenhum item for especificado, uma matriz de cadeia de caracteres vazia será o padrão. O mesmo que um operador de criação [].
em 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 dado uma chave. Se a chave não for encontrada, ela retornará null.
contém: Retorna true se qualquer elemento na matriz fornecida for avaliado como true no predicado fornecido. Contém espera uma referência a um elemento na função de predicado como #item.
distinto Retorna um conjunto distinto de itens de uma matriz.
exceto Retorna um conjunto de diferenças de uma matriz de outra descartando duplicatas.
filter Filtra elementos fora da matriz que não atendem ao predicado fornecido. Filter espera uma referência a um elemento na função de predicado como #item.
find Encontre o primeiro item de uma matriz que corresponda à condição. Ele usa uma função de filtro onde você pode endereçar o item na matriz como #item. Para mapas profundamente aninhados, você pode consultar os mapas pai usando a notação #item_n(#item_1, #item_2...).
achatar Nivela a matriz ou matrizes em uma única matriz. Matrizes de itens atômicos são retornadas inalteradas. O último argumento é opcional e o padrão é false para achatar recursivamente mais de um nível de profundidade.
presente em Verifica se um item está na matriz.
cruzamento Retorna um conjunto de interseções de itens distintos de 2 matrizes.
mapa Mapeia cada elemento da matriz para um novo elemento usando a expressão fornecida. Map espera uma referência a um elemento na função de expressão como #item.
mapaSe Mapeia condicionalmente uma matriz para outra matriz de comprimento igual ou menor. Os valores podem ser de qualquer tipo de dados, incluindo structTypes. Ele usa uma função de mapeamento onde você pode endereçar o item na matriz como #item e o índice atual como #index. Para mapas profundamente aninhados, você pode consultar os mapas pai usando a #item_[n](#item_1, #index_1...) notação.
mapIndex Mapeia cada elemento da matriz para um novo elemento usando a expressão fornecida. 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 loops de 1 até o comprimento para criar uma matriz desse comprimento. Ele usa uma função de mapeamento onde você pode abordar o índice na matriz como #index. Para mapas profundamente aninhados, você pode consultar os mapas pai usando a notação #index_n(#index_1, #index_2...).
reduzir Acumula elementos em uma matriz. Reduce espera uma referência a um acumulador e um elemento na primeira função de expressão como #acc e #item e espera que o valor resultante como #result seja usado na segunda função de expressão.
tamanho Localiza o tamanho de uma matriz ou tipo de mapa
slice Extrai um subconjunto de uma matriz de uma posição. A posição é baseada em 1. Se o comprimento for omitido, o padrão será o fim da cadeia de caracteres.
sort Classifica a matriz usando a função de predicado fornecida. Sort espera uma referência a dois elementos consecutivos na função de expressão como #item1 e #item2.
desdobrar Desdobra uma matriz em um conjunto de linhas e repete os valores das colunas restantes em cada linha.
União Retorna um conjunto de união de itens distintos de 2 matrizes.