Metafunções no fluxo 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 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 metafunções com suporte no Azure Data Factory e no Azure Synapse Analytics nos fluxos de dados de mapeamento.
Lista de metafunções
As metafunções funcionam principalmente em metadados em seu fluxo de dados
| Metafunção | Tarefa |
|---|---|
| byItem | Encontre um subitem dentro de uma estrutura ou matriz de estrutura. Se houver várias correspondências, a primeira correspondência será retornada. Se não houver correspondência, um valor NULL é retornado. O valor retornado deve ser do tipo convertido por uma das ações de conversão de tipo (? date, ? string ...). Os nomes de coluna conhecidos no tempo de design devem ser tratados apenas por seus nomes. Não há suporte a 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ência, um valor NULL é retornado. O valor retornado deve ser do tipo convertido por uma das funções de conversão de tipo (TO_DATE, TO_STRING...). Os nomes de coluna conhecidos no tempo de design devem ser tratados apenas por seus nomes. Não há suporte a 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ência, um valor NULL é retornado. O valor retornado deve ser do tipo convertido por uma das funções de conversão de tipo (TO_DATE, TO_STRING...). Os nomes de coluna conhecidos no tempo de design devem ser tratados apenas por seus nomes. Não há suporte a 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ência, um valor NULL é retornado. O valor retornado deve ser do tipo convertido por uma das funções de conversão de tipo (TO_DATE, TO_STRING...). Os nomes de coluna conhecidos no tempo de design devem ser tratados apenas por seus nomes. Não há suporte a 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ência para uma coluna, a saída inteira será um valor NULL. O valor retornado requer uma função de conversão de tipo (toDate, toString...). Os nomes de coluna conhecidos no tempo de design devem ser tratados apenas pelos próprios nomes. Não há suporte a 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á null. Os nomes de coluna/caminhos conhecidos no tempo de design devem ser tratados apenas por seus nomes ou caminho de notação de ponto. Não há suporte a entradas computadas, mas você pode usar substituições de parâmetro. |
| byPosition | Seleciona um valor de coluna de acordo com sua posição relativa (com base em 1) no fluxo. Se a posição estiver fora dos limites, ela retornará um valor NULL. O valor retornado deve ser do tipo convertido por uma das funções de conversão de tipo (TO_DATE, TO_STRING...) Não há suporte a 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. Os nomes de coluna/caminhos conhecidos no tempo de design devem ser tratados apenas por seus nomes ou caminho de notação de ponto. Não há suporte a 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 cadeia de caracteres hexa de um valor binário |
| unhex | Cancela o hexa de um valor binário de sua representação de cadeia de caracteres. Pode ser usado com sha2, md5 para converter de cadeia de caracteres em representação binária |
Conteúdo relacionado
- Lista todas as funções de agregação.
- Lista de todas as funções de matriz.
- Lista de todas as funções de pesquisa em cache.
- Lista de todas as funções de conversão.
- Lista de todas as funções de data e hora.
- Lista de todas as funções de expressão.
- Lista de todas as funções de mapa.
- Lista de todas as funções de janela.
- Detalhes de uso de todas as expressões de transformação de dados.
- Saiba como usar o Construtor de Expressões.