Partilhar via


Funções de array no mapeamento de fluxos de dados

APLICA-SE A: Azure Data Factory Azure Synapse Analytics

Tip

Experimente Data Factory no Microsoft Fabric, uma solução de análise completa para empresas. Microsoft Fabric abrange tudo, desde a movimentação de dados até à ciência de dados, análises em tempo real, inteligência empresarial e relatórios. Saiba como iniciar um novo teste gratuitamente!

Os fluxos de dados estão disponíveis nos pipelines do Azure Data Factory e no Azure Synapse Analytics. Este artigo aplica-se ao mapeamento de fluxos de dados. Se você é 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 array suportadas pelo Azure Data Factory e Azure Synapse Analytics no mapeamento de fluxos de dados.

Lista de funções do array

As funções do array realizam transformações em estruturas de dados que são arrays. Palavras-chave especiais que abordam elementos de array e índices:

  • #acc representa um valor que pretende incluir na sua única saída quando reduz um array.
  • #index representa o índice atual do array, e os números de índice do array #index2, #index3 ....
  • #item representa o valor atual do elemento no array.
Função do array Task
array Cria uma variedade de itens. Todos os itens devem ser do mesmo tipo. Se não forem especificados elementos, um array de strings vazio é o padrão. O mesmo que um operador de criação [].
at Encontra o elemento num índice de array. O índice é baseado em 1. O índice fora dos limites resulta num valor nulo. Encontra um valor num mapa quando é fornecida uma chave. Se a chave não for encontrada, devolve o valor nulo.
contains Retorna verdadeiro se qualquer elemento do array fornecido for avaliado como verdadeiro no predicado fornecido. A contains função espera uma referência a um elemento da função de predicado como #item.
distinct Devolve um conjunto distinto de itens de um array.
except Devolve um conjunto de diferenças de um array em relação a outro, eliminando duplicados.
filter Filtra elementos do array que não cumprem o predicado fornecido. A filter função espera uma referência a um elemento da função de predicado como #item.
find Encontra o primeiro item de um array que corresponde à condição. Utiliza uma filter função onde podes endereçar o item no array como #item. Para mapas profundamente aninhados, pode referir-se aos mapas pais usando a #item_n(#item_1, #item_2...) notação.
flatten Achata o(s) array(s) num único array. Conjuntos de itens atómicos são devolvidos inalterados. O último argumento é opcional e é predefinido como falso para efectuar o achatamento recursivo em mais de um nível de profundidade.
in Verifica se um item está no array.
intersect Devolve um conjunto de interseção de itens distintos de dois arrays.
map Mapeia cada elemento do array para um novo elemento usando a expressão fornecida. A map função espera uma referência a um elemento da função de expressão como #item.
mapIf Condicionalmente mapeia um array para outro array do mesmo comprimento ou menor. Os valores podem ser de qualquer tipo de dado, incluindo structTypes. Utiliza uma função de mapeamento onde podes endereçar o item no array como #item e o índice atual como #index. Para mapas profundamente aninhados, pode referir-se aos mapas de pais usando a notação #item_[n](#item_1, #index_1...).
mapIndex Mapeia cada elemento do array para um novo elemento usando a expressão fornecida. A map função 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 Executa ciclos de 1 até ao comprimento para criar uma matriz com esse comprimento. Utiliza uma função de mapeamento onde se pode endereçar o índice no array como #index. Para mapas profundamente aninhados, pode referir-se aos mapas pais usando a #index_n(#index_1, #index_2...) notação.
reduce Acumula elementos num array. A reduce função espera uma referência a um acumulador e um elemento na primeira função de expressão como #acc e #item. Espera-se que o valor resultante como #result seja usado na segunda função de expressão.
size Encontra o tamanho de um array ou tipo de mapa.
slice Extrai um subconjunto de um array a partir de uma posição. A posição é baseada no número 1. Se o comprimento for omitido, por padrão considera-se até ao final da string.
sort Ordena o array usando a função de predicado fornecida. A sort função espera uma referência a dois elementos consecutivos na expressão da função como #item1 e #item2.
unfold Transforma um array num conjunto de linhas e repete os valores das colunas restantes para cada linha.
union Devolve um conjunto união de itens distintos de dois arrays.

Outras funções disponíveis