Atividade de função do Azure no Azure Data Factory

APLICA-SE A: Azure Data Factory Azure Synapse Analytics

A atividade Azure Function permite-lhe executar Funções do Azure numa pipeline Azure Data Factory ou Synapse. Para executar uma Função do Azure, deve criar uma conexão de serviço associado. Depois podes usar o serviço ligado com uma atividade que especifica a Função do Azure que planeias executar.

Criar uma atividade Azure Function com UI

Para usar uma atividade Azure Function num pipeline, complete os seguintes passos:

1. Expanda a secção da Função Azure do painel de Atividades do pipeline e arraste uma atividade da Função Azure para a canvas do pipeline.

2. Selecione a nova atividade Azure Function no painel, se ainda não estiver selecionada, e o seu separador Definições para editar os detalhes.

   

3. Se ainda não tiver um serviço ligado ao Azure Function definido, selecione Novo para criar um novo. No novo painel de serviços ligados ao Azure Function, escolha o URL existente da Azure Function App e forneça uma Function Key.

   

4. Após selecionar o serviço ligado à função Azure, forneça o nome da função e outros detalhes para completar a configuração.

Serviço ligado do Azure Function

O tipo de retorno da função Azure tem de ser válido JObject. (Lembra-te que o JArraynão é um JObject.) Qualquer tipo de retorno diferente de JObject falha e gera o erro do utilizador: Conteúdo de Resposta não é um JObject válido.

A tecla de função fornece acesso seguro ao nome da função, cada uma tem chaves únicas separadas ou uma chave mestra dentro de uma aplicação de funções. A identidade gerenciada fornece acesso seguro a todo o aplicativo de função. O usuário precisa fornecer a chave para acessar o nome da função. Para obter mais informações, consulte a documentação da função para obter mais detalhes sobre a tecla de acesso da função

/* A resourceId propriedade é necessária quando utiliza autenticação de identidade gerida atribuída pelo sistema.

Autenticação de identidade gerenciada atribuída pelo sistema

Pode utilizar a autenticação SAMI (Identidade Gerida Atribuída pelo Sistema) de duas maneiras:

• Defina o ID do recurso para https://management.azure.com. A Data Factory liga-se à Function App usando a sua identidade gerida atribuída pelo sistema e executa a function app com autenticação anónima.

• Para ambientes seguros onde não pretende usar autenticação anónima, configure um Nome Principal do Serviço (SPN) como ID de Recursos. O SPN deve ser configurado corretamente na Function App:

  1. Crie um novo registo de aplicação como identidade de entidade de serviço.

  2. Na tua aplicação de funções, vai à secção de Autenticação em Definições e cria um fornecedor de Identidade.

  3. Adicione o ID da Aplicação ADF na secção Pedidos Permitidos de Aplicações Cliente Específicas e o ID do Objeto na secção Permitir pedidos de identificações específicas . O ID da aplicação e o ID do Objeto podem ser encontrados seguindo estes passos:

     1. Abra o portal Azure
     2. Navegar para aplicações empresariais
     3. Procure o seu nome de identidade Azure Data Factory/Managed Identity.
     4. Copie os IDs do objeto e da aplicação encontrados na tabela.

     

Atividade do Azure Function

Consulte o esquema da carga útil da solicitação na seção Esquema da carga útil da solicitação.

Roteamento e consultas

A Atividade de Funções Azure suporta roteamento. Por exemplo, se a sua Função Azure tiver o endpoint https://functionAPP.azurewebsites.net/api/<functionName>/<value>?code=<secret>, então o functionName a usar na Atividade da Função Azure é <functionName>/<value>. Você pode parametrizar esta função para fornecer o functionName desejado em tempo de execução.

A Atividade de Funções Azure também suporta consultas. Uma consulta deve ser incluída como parte do functionName. Por exemplo, quando o nome da função é HttpTriggerCSharp e a consulta que pretende incluir é name=hello, pode construir o functionName na Atividade da Função Azure como HttpTriggerCSharp?name=hello. Esta função pode ser parametrizada para que o valor possa ser determinado em tempo de execução.

Funções de tempo de espera e de execução prolongada

Funções do Azure expira após 230 segundos, independentemente da definição functionTimeout que tenha configurado nas definições. Para mais informações, consulte este artigo. Para contornar este comportamento, siga um padrão assíncrono ou use Durable Functions. A vantagem das Durable Functions é que oferecem o seu próprio mecanismo de rastreamento de estado, logo não precisa de implementar o seu próprio rastreamento de estado.

Saiba mais sobre Durable Functions em este artigo. Pode configurar uma Atividade de Função Azure para chamar a Função Duradoura, que devolverá uma resposta com um URI diferente, como este exemplo. Como statusQueryGetUri retorna o status HTTP 202 enquanto a função está em execução, você pode sondar o status da função usando uma atividade da Web. Configure uma Atividade da Web com o url campo definido como @activity('<AzureFunctionActivityName>').output.statusQueryGetUri. Quando a Função Durável termina, a saída da função é a saída da Atividade Web.

Exemplo

Pode encontrar uma amostra que usa uma função Azure para extrair o conteúdo de um ficheiro tar aqui.

Conteúdos relacionados

Saiba mais sobre as atividades apoiadas em Pipelines e atividades.