Partilhar via


Funções definidas pelo usuário no mapeamento do fluxo de dados

APLICA-SE A: Azure Data Factory Azure Synapse Analytics

Gorjeta

Data Factory em Microsoft Fabric é a próxima geração de Azure Data Factory, com uma arquitetura mais simples, IA incorporada e novas funcionalidades. Se és novo na integração de dados, começa pelo Fabric Data Factory. As cargas de trabalho existentes do ADF podem atualizar para o Fabric para aceder a novas capacidades em ciência de dados, análise em tempo real e relatórios.

Os fluxos de dados estão disponíveis tanto nos pipelines do Azure Data Factory como no do Azure Synapse Analytics. Este artigo aplica-se ao mapeamento de fluxos de dados. Se você é novo em transformações, consulte o artigo introdutório Transformar dados usando fluxos 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.

Começar

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.

Captura de tela mostrando o painel de gerenciamento A D F e bibliotecas de fluxo de dados.

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. Captura de tela mostrando o painel de criação de bibliotecas de fluxo de dados.

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. Captura de ecrã a mostrar o botão da nova função U D F.

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 uma lista das expressões atuais de fluxo de dados de mapeamento, veja Expressões de transformação de dados no mapeamento do fluxo de dados | Microsoft Docs

Captura de tela mostrando o painel de criação da nova função U D F.

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 a experiência completa do construtor de expressões | Microsoft Docs e permite-lhe referenciar os seus argumentos criados e quaisquer expressões de transformação de dados no fluxo de mapeamento de dados | Microsoft Docs.

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

No Construtor de Expressões de Mapeamento de Fluxo de Dados, as funções definidas pelo utilizador aparecerão 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.

Captura de tela mostrando a biblioteca de fluxo de dados no construtor de expressões de fluxo de dados de mapeamento.