Funções definidas pelo usuário 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.

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 vivem em uma coleção chamada biblioteca de fluxo de dados para poder agrupar facilmente conjuntos comuns de funções personalizadas.

Sempre que você estiver construindo a mesma lógica em uma expressão em vários fluxos de dados de mapeamento, essa seria uma boa oportunidade para transformar isso em uma função definida pelo usuário.

Introdução

Para começar a usar funções definidas pelo usuário, você deve primeiro criar uma biblioteca de fluxo de dados. Navegue até a página de gerenciamento e localize bibliotecas de fluxo de dados na seção autor.

Biblioteca de fluxo de dados

A partir daqui, você pode clicar no botão + Novo para criar uma nova biblioteca de fluxo de dados. Preencha o nome e a descrição e, em seguida, você estará pronto para criar sua função definida pelo usuário.

Nova função definida pelo utilizador

Para criar uma função definida pelo usuário, na biblioteca de fluxo de dados na qual você deseja criar a função, clique no botão +Novo.

Preencha o nome da função definida pelo usuário.

Nota

Não é possível 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, consulte Expressões de transformação de dados em mapeamento de fluxo de dados | Documentos Microsoft

As funções definidas pelo usuário podem ter zero ou mais argumentos. Os argumentos permitem que você passe valores quando sua função é chamada e se refira a esses argumentos em sua lógica de expressão. Os argumentos são nomeados automaticamente a partir de i1, i2, etc. 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 sua função. O editor fornece o construtor de expressões completas | Experiência do Microsoft Docs e permite que você faça referência aos argumentos criados e a quaisquer expressões de transformação de dados no mapeamento do fluxo de dados | Documentos Microsoft.

Nota

Uma função definida pelo usuário não pode se referir a outra função definida pelo usuário.

Usando 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 em Funções da biblioteca de fluxo de dados. A partir daqui, você pode usar suas funções personalizadas criadas e passar os argumentos apropriados (se houver) que você definiu.