Compartilhar via


Metafunções 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 metafunções compatíveis com o Azure Data Factory e o Azure Synapse Analytics no mapeamento de fluxos de dados.

Lista de metafunções

Metafunções operam principalmente sobre metadados em seu fluxo de dados.

Metafunção Tarefa
byItem Localiza um subitem dentro de uma estrutura ou uma matriz de uma estrutura. Se houver várias correspondências, a primeira correspondência será retornada. Se não houver correspondências, um NULL valor será retornado. O valor retornado deve ser o tipo convertido por uma das ações de conversão de tipo (como ? date e ? string). Referencie os nomes de colunas conhecidos em tempo de design apenas pelos nomes. Não há suporte para entradas computadas, mas você pode usar substituições de parâmetro
byOrigin Seleciona um valor de coluna pelo nome no fluxo de origem. O segundo argumento é o nome do fluxo de origem. Se houver várias correspondências, a primeira correspondência será retornada. Se não houver correspondências, um NULL valor será retornado. O valor retornado deve ser o tipo convertido por uma das funções de conversão de tipo (como TO_DATE e TO_STRING). Referencie os nomes de colunas conhecidos em tempo de design apenas pelos nomes. Não há suporte para entradas computadas, mas você pode usar substituições de parâmetro.
byOrigins Selecione uma matriz de colunas de acordo com o nome no fluxo. O segundo argumento é o fluxo de origem. Se houver várias correspondências, a primeira correspondência será retornada. Se não houver correspondências, um NULL valor será retornado. O valor retornado deve ser o tipo convertido por uma das funções de conversão de tipo (como TO_DATE e TO_STRING). Referencie os nomes de colunas conhecidos em tempo de design apenas pelos nomes. Não há suporte para entradas computadas, mas você pode usar substituições de parâmetro.
byName Seleciona um valor de coluna de acordo com o nome no fluxo. Você pode transmitir um nome de fluxo opcional como o segundo argumento. Se houver várias correspondências, a primeira correspondência será retornada. Se não houver correspondências, um NULL valor será retornado. O valor retornado deve ser o tipo convertido por uma das funções de conversão de tipo (como TO_DATE e TO_STRING). Referencie os nomes de colunas conhecidos em tempo de design apenas pelos nomes. Não há suporte para entradas computadas, mas você pode usar substituições de parâmetro.
byNames Selecione uma matriz de colunas de acordo com o nome no fluxo. Você pode transmitir um nome de fluxo opcional como o segundo argumento. Se houver várias correspondências, a primeira correspondência será retornada. Se não houver correspondências para uma coluna, a saída inteira será um valor NULL. O valor retornado requer uma função de conversão de tipo (como toDate e toString). Referencie os nomes de colunas conhecidos em tempo de design apenas pelos nomes. Não há suporte para entradas computadas, mas você pode usar substituições de parâmetro.
byPath Localiza um caminho hierárquico por nome no fluxo. Você pode transmitir um nome de fluxo opcional como o segundo argumento. Se nenhum caminho desse tipo for encontrado, ele retornará um NULL valor. Referencie os nomes e os caminhos de coluna conhecidos em tempo de design apenas pelos nomes ou caminhos usando a notação de ponto. Não há suporte para entradas computadas, mas você pode usar substituições de parâmetro.
byPosition Seleciona um valor de coluna por sua posição relativa (com base em 1) no fluxo. Se a posição estiver fora dos limites, ela retornará um NULL valor. O valor retornado deve ser o tipo convertido por uma das funções de conversão de tipo (como TO_DATE e TO_STRING). Não há suporte para entradas computadas, mas você pode usar substituições de parâmetro.
hasPath Verifica se um determinado caminho hierárquico existe por nome no fluxo. Você pode transmitir um nome de fluxo opcional como o segundo argumento. Referencie os nomes e os caminhos de coluna conhecidos em tempo de design apenas pelos nomes ou caminhos usando a notação de ponto. Não há suporte para entradas computadas, mas você pode usar substituições de parâmetro.
originColumns Obtém todas as colunas de saída para um fluxo de origem em que as colunas foram criadas. Deve ser incluído em outra função.
hex Retorna uma representação de sequência hexadecimal de um valor binário.
unhex Cancela o hexa de um valor binário de sua representação de cadeia de caracteres. Você pode usá-lo com sha2 e md5 para converter de string para representação binária.