Funções definidas pelo usuário 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.
Uma função definida pelo usuário é uma expressão personalizada que você pode definir para poder reutilizar a lógica em vários fluxos de dados de mapeamento. As funções definidas pelo usuário residem em uma coleção chamada biblioteca de fluxo de dados que permite agrupar facilmente conjuntos comuns de funções personalizadas.
Sempre que estiver criando a mesma lógica em uma expressão em vários fluxos de dados de mapeamento, você poderá transformá-la em uma função definida pelo usuário.
Introdução
Para começar a usar funções definidas pelo usuário, primeiro você precisa criar uma biblioteca de fluxo de dados. Navegue até a página de gerenciamento e encontre bibliotecas de fluxo de dados na seção de autor.
Biblioteca de fluxos de dados
Daqui, você pode clicar no botão +Novo para criar uma biblioteca de fluxo de dados. Preencha o nome e a descrição e depois você poderá criar sua função definida pelo usuário.
Nova função definida pelo usuário
Para criar uma função definida pelo usuário, na biblioteca de fluxo de dados na qual você quer criar a função, clique no botão +Novo.
Preencha o nome da função definida pelo usuário.
Observação
Você não pode usar o nome de uma expressão de fluxo de dados de mapeamento existente. Para obter uma lista das expressões de fluxo de dados de mapeamento atuais, confira Expressões de transformação de dados no fluxo de dados de mapeamento | Microsoft Docs
As funções definidas pelo usuário podem ter zero ou mais argumentos. Os argumentos permitem que você passe valores quando a função é chamada e referencie esses argumentos na lógica da expressão. Os argumentos são nomeados automaticamente de i1, i2 em diante e você pode escolher o tipo de dados do argumento na lista suspensa.
O corpo da função definida pelo usuário é onde você especifica a lógica da função. O editor oferece uma experiência completa do Construtor de Expressões | Microsoft Docs e permite referenciar os argumentos criados e as expressões de transformação de dados no fluxo de dados de mapeamento | Microsoft Docs.
Observação
Uma função definida pelo usuário não pode se referir a outra função definida pelo usuário.
Usar uma função definida pelo usuário no Construtor de Expressões
As funções definidas pelo usuário aparecerão no Construtor de Expressões de fluxo de dados de mapeamento nas funções de biblioteca de fluxo de dados. Daqui, você pode usar as funções criadas personalizadas e passar os argumentos apropriados (caso haja) que você já definiu.
