Atividade do Azure Function no Azure Data Factory

APLICA-SE A: Azure Data Factory Azure Synapse Analytics

A atividade do Azure Function permite executar o Azure Functions em um pipeline do Azure Data Factory ou Synapse. Para executar uma Função do Azure, você deve criar uma conexão de serviço vinculado. Em seguida, você pode usar o serviço vinculado com uma atividade que especifica a Função do Azure que você planeja executar.

Criar uma atividade do Azure Function com a interface do usuário

Para usar uma atividade do Azure Function em um pipeline, conclua as seguintes etapas:

1. Expanda a seção de Funções do Azure no painel de Atividades do pipeline e arraste uma atividade para a tela do pipeline.

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

   

3. Se ainda não tiver um serviço ligado a uma função Azure definido, selecione Novo para criar um novo. No novo painel de serviço vinculado do Azure Function, escolha a url existente do Aplicativo de Função do Azure e forneça uma Chave de Função.

   

4. Depois de selecionar o serviço vinculado da Função do Azure, forneça o nome da função e outros detalhes para concluir a configuração.

Serviço vinculado do Azure Function

O tipo de retorno da função do Azure deve ser um JObject válido. (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 do principal de serviço na aplicação cliente Permitida, e o ID do objeto do principal de serviço nas aplicações de objeto Permitidas. Se os pedidos forem permitidos apenas de inquilinos específicos, adicione o ID do inquilino da identidade gerida na última caixa.

     

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ção do Azure dá suporte ao encaminhamento. Por exemplo, se a sua Função do Azure tiver o ponto de extremidade https://functionAPP.azurewebsites.net/api/<functionName>/<value>?code=<secret>, então o functionName a ser usado na Atividade da Função do Azure será <functionName>/<value>. Você pode parametrizar esta função para fornecer o functionName desejado em tempo de execução.

A Atividade de Função do Azure também dá suporte a consultas. Uma consulta deve ser incluída como parte do functionName. Por exemplo, quando o nome da função é HttpTriggerCSharp e a consulta que você deseja incluir é name=hello, então você pode construir o functionName na Atividade de Função do 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

O Azure Functions expira após 230 segundos, functionTimeout independentemente da configuração que você definiu nas configurações. Para mais informações, consulte este artigo. Para contornar esse comportamento, siga um padrão assíncrono ou use funções duráveis. O benefício das Funções Duráveis é que elas oferecem o seu próprio mecanismo de rastreamento de estado, de modo que o utilizador não precise implementar o seu próprio rastreamento de estado.

Saiba mais sobre funções duráveis neste artigo. Você pode configurar uma Atividade de Função do Azure para chamar a Função Durável, que retornará 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

Você pode encontrar um exemplo que usa uma Função do Azure para extrair o conteúdo de um arquivo tar aqui.

Conteúdos relacionados

Saiba mais sobre as atividades apoiadas em Pipelines e atividades.