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

  • Artigo

APLICA-SE A: Azure Data Factory Azure Synapse Analytics

Dica

Experimente o Data Factory no Microsoft Fabric, uma solução de análise tudo-em-um 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 avaliação gratuita!

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

Os artigos a seguir fornecem detalhes sobre as funções de matriz com suporte no Azure Data Factory e no Azure Synapse Analytics nos fluxos de dados de mapeamento.

Lista de funções de matriz

As funções de matriz executam transformações em estruturas de dados que são matrizes. Inclui palavras-chave especiais para endereçar elementos e índices de matriz:

  • #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 de matriz #index2, #index3 ...
  • #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 de acordo com uma chave. Se a chave não for encontrada, ele retornará nulo.
contains Retornará true se algum elemento na matriz fornecida for avaliado como true no predicado fornecido. Contains espera uma referência a um elemento na função de predicado como #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. O filtro espera uma referência a um elemento na função de predicado como #item.
find Localize o primeiro item de uma matriz que corresponda à condição. Ela usa uma função de filtro na qual 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...).
flatten Mescla a matriz ou as 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 2 matrizes.
map 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.
mapIf Mapeia condicionalmente uma matriz a outra 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 notação #item_[n](#item_1, #index_1...).
mapIndex 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 e uma referência ao índice de 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 onde você pode endereçar 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...).
reduce Acumula elementos em uma matriz. A redução 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.
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 será padronizado como o final 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.
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 2 matrizes.

Conteúdo relacionado