Partilhar via


Metafunções 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 metafunções suportadas pelo Azure Data Factory e pelo Azure Synapse Analytics no mapeamento de fluxos de dados.

Lista de metafunções

As metafunções funcionam principalmente em metadados no seu fluxo de dados

Metafunção Task
porItem Encontre um subitem dentro de uma estrutura ou matriz de estrutura. Se houver várias correspondências, a primeira partida será retornada. Se nenhuma correspondência, ele retorna um valor NULL. O valor retornado deve ser convertido por uma das ações de conversão do tipo(? date, ? string ...). Os nomes de colunas conhecidos em tempo de design devem ser endereçados apenas pelo nome. Não há suporte para entradas computadas, mas você pode usar substituições de parâmetros
porOrigem Seleciona um valor de coluna por nome no fluxo de origem. O segundo argumento é o nome do fluxo de origem. Se houver várias correspondências, a primeira partida será retornada. Se nenhuma correspondência, ele retorna um valor NULL. O valor retornado tem que ser tipo convertido por uma das funções de conversão de tipo (TO_DATE, TO_STRING ...). Os nomes de colunas conhecidos em tempo de design devem ser endereçados apenas pelo nome. Não há suporte para entradas computadas, mas você pode usar substituições de parâmetros.
porOrigens Seleciona uma matriz de colunas por nome no fluxo. O segundo argumento é o fluxo de onde se originou. Se houver várias correspondências, a primeira partida será retornada. Se nenhuma correspondência, ele retorna um valor NULL. O valor retornado tem que ser tipo convertido por uma das funções de conversão de tipo (TO_DATE, TO_STRING ...) Os nomes de colunas conhecidos em tempo de design devem ser endereçados apenas pelo nome. Não há suporte para entradas computadas, mas você pode usar substituições de parâmetros.
byNome Seleciona um valor de coluna por nome no fluxo. Você pode passar um nome de fluxo opcional como o segundo argumento. Se houver várias correspondências, a primeira partida será retornada. Se nenhuma correspondência, ele retorna um valor NULL. O valor retornado tem que ser tipo convertido por uma das funções de conversão de tipo (TO_DATE, TO_STRING ...). Os nomes de colunas conhecidos em tempo de design devem ser endereçados apenas pelo nome. Não há suporte para entradas computadas, mas você pode usar substituições de parâmetros.
porNomes Selecione uma matriz de colunas por nome no fluxo. Você pode passar um nome de fluxo opcional como o segundo argumento. Se houver várias correspondências, a primeira partida será retornada. Se não houver correspondências para uma coluna, toda a saída será um valor NULL. O valor retornado requer uma função de conversão de tipo (toDate, toString, ...). Os nomes de colunas conhecidos em tempo de design devem ser endereçados apenas pelo nome. Não há suporte para entradas computadas, mas você pode usar substituições de parâmetros.
byPath Localiza um caminho hierárquico pelo nome no fluxo. Você pode passar um nome de fluxo opcional como o segundo argumento. Se nenhum caminho for encontrado, ele retornará null. Os nomes/caminhos de colunas conhecidos em tempo de design devem ser abordados apenas pelo nome ou caminho de notação de pontos. Não há suporte para entradas computadas, mas você pode usar substituições de parâmetros.
porPosição Seleciona um valor de coluna por sua posição relativa(1 baseada) no fluxo. Se a posição estiver fora dos limites, ela retornará um valor NULL. O valor retornado tem que ser tipo convertido por uma das funções de conversão de tipo (TO_DATE, TO_STRING ...) Não há suporte para entradas computadas, mas você pode usar substituições de parâmetros.
hasPath Verifica se um determinado caminho hierárquico existe por nome no fluxo. Você pode passar um nome de fluxo opcional como o segundo argumento. Os nomes/caminhos de colunas conhecidos em tempo de design devem ser abordados apenas pelo nome ou caminho de notação de pontos. Não há suporte para entradas computadas, mas você pode usar substituições de parâmetros.
originColunas Obtém todas as colunas de saída para um fluxo de origem onde as colunas foram criadas. Deve ser incluído em outra função.
hexadecimal Retorna uma representação de cadeia de caracteres hexadecimal de um valor binário
Unhex Unhexes um valor binário de sua representação de cadeia de caracteres. Isso pode ser usado com sha2, md5 para converter de string para representação binária