Utilizar as Funções para adicionar mensagens a uma fila do Armazenamento do Azure

Nas Funções do Azure, os enlaces de entrada e saída proporcionam uma forma declarativa para tornar os dados dos serviços externos disponíveis para o seu código. Neste artigo, você usa uma associação de saída para criar uma mensagem em uma fila quando uma solicitação HTTP dispara uma função. Você usa o contêiner de armazenamento do Azure para exibir as mensagens de fila que sua função cria.

Pré-requisitos

• Uma subscrição do Azure. Se não tiver uma, crie uma conta gratuita antes de começar.

• Siga as instruções em Criar sua primeira função no portal do Azure, omitindo a etapa Limpar recursos , para criar o aplicativo de função e a função a ser usada neste artigo.

Adicionar um enlace de saída

Nesta seção, você usa a interface do usuário do portal para adicionar uma associação de saída do Armazenamento de Filas do Azure à função criada nos pré-requisitos. Essa associação torna possível escrever código mínimo para criar uma mensagem em uma fila. Você não precisa escrever código para tarefas como abrir uma conexão de armazenamento, criar uma fila ou obter uma referência a uma fila. O tempo de execução das Funções do Azure e o enlace de saída da fila tratam dessas tarefas por si.

1. No portal do Azure, procure e selecione o aplicativo de função que você criou em Criar sua primeira função a partir do portal do Azure.

2. No seu aplicativo de função, selecione a função que você criou.

3. Selecione Integração e, em seguida, selecione + Adicionar saída.

   

4. Selecione o tipo de associação Armazenamento de Filas do Azure e adicione as configurações conforme especificado na tabela a seguir a esta captura de tela:

   

   Definição	Valor sugerido	descrição
   Nome do parâmetro da mensagem	outputQueueItem	O nome do parâmetro de enlace de saída.
   Nome da fila	outqueue	O nome da fila à qual se conectar em sua conta de armazenamento.
   Ligação da conta de armazenamento	AzureWebJobsStorage	Você pode usar a conexão de conta de armazenamento existente usada pelo seu aplicativo de função ou criar uma nova.

5. Selecione OK para adicionar a ligação.

Agora que tem um enlace de saída definido, tem de atualizar o código para utilizar o enlace para adicionar mensagens a uma fila.

Adicione código que utiliza o enlace de saída

Nesta secção, adicione código que escreve uma mensagem para a fila de saída. A mensagem inclui o valor passado para o gatilho HTTP na cadeia de caracteres de consulta. Por exemplo, se a cadeia de caracteres de consulta incluir name=Azure, a mensagem da fila será Nome passado para a função: Azure.

1. Na sua função, selecione Código + Teste para exibir o código da função no editor.

2. Atualize o código da função, de acordo com o idioma da sua função:

   C#

   Adicione um parâmetro outputQueueItem à assinatura do método, conforme mostrado no exemplo a seguir:

   public static async Task<IActionResult> Run(HttpRequest req,
       ICollector<string> outputQueueItem, ILogger log)
   {
       ...
   }
   

   No corpo da função, imediatamente antes da return instrução, adicione o código que usa o parâmetro para criar uma mensagem de fila:

   outputQueueItem.Add("Name passed to the function: " + name);
   

   JavaScript

   Para criar uma mensagem de fila, adicione código que usa a associação de saída no context.bindings objeto:

   context.bindings.outputQueueItem = "Name passed to the function: " + 
               (req.query.name || req.body.name);
   

3. Selecione Guardar para guardar as alterações.

Testar a função

1. Depois que as alterações de código forem salvas, selecione Testar.

2. Confirme se o teste corresponde a esta captura de ecrã e, em seguida, selecione Executar.

   

   Tenha em atenção que o Corpo do pedido contém o valor nameAzure. Esse valor aparece na mensagem de fila criada quando a função é invocada.

   Como alternativa à seleção de Executar, você pode chamar a função inserindo uma URL em um navegador e especificando o name valor na cadeia de caracteres de consulta. Esse método de navegador é mostrado em Criar sua primeira função a partir do portal do Azure.

3. Verifique os registos para se certificar de que a função foi bem-sucedida.

   Uma nova fila chamada outqueue é criada em sua conta de armazenamento pelo tempo de execução do Functions quando a associação de saída é usada pela primeira vez. Use a conta de armazenamento para verificar se a fila e uma mensagem nela foram criadas.

Encontre a conta de armazenamento conectada ao AzureWebJobsStorage

1. Na sua aplicação de funções, expanda Definições e, em seguida, selecione Variáveis de ambiente.

2. Na guia Configurações do aplicativo, selecione AzureWebJobsStorage.

   

3. Localize e anote o nome da conta.

   

Examinar a fila de saída

1. No grupo de recursos do seu aplicativo de função, selecione a conta de armazenamento que você está usando.

2. Em Serviço de fila, selecione Filas e selecione a fila chamada outqueue.

   A fila contém a mensagem que a fila de enlace de saída da fila criou quando executou a função acionada por HTTP. Se invocou a função com o valor predefinido name do Azure, a mensagem de fila é Nome transmitido para a função: Azure.

3. Execute a função novamente.

   Uma nova mensagem aparece na fila.

Clean up resources (Limpar recursos)

Nos passos anteriores, criou os recursos do Azure num grupo de recursos. Se provavelmente não necessitar desses recursos no futuro, pode eliminá-los ao eliminar o grupo de recursos.

No menu do portal do Azure ou na página inicial , selecione Grupos de recursos. Em seguida, na página Grupos de recursos, selecione myResourceGroup.

Na página myResourceGroup, certifique-se de que os recursos listados são aqueles que você deseja excluir.

Selecione Excluir grupo de recursos, digite myResourceGroup na caixa de texto para confirmar e selecione Excluir.

Conteúdos relacionados

Neste artigo, você adicionou uma ligação de saída a uma função existente. Para obter mais informações sobre a associação ao Armazenamento de Filas, consulte Gatilho e ligações de Armazenamento em Fila.

• Conceitos dos acionadores e dos enlaces das Funções do Azure
  Saiba como o Functions se integra com outros serviços.
• Referência para programadores das Funções do Azure
  Fornece mais informações técnicas sobre o tempo de execução de funções e uma referência para funções de codificação e definição de gatilhos e associações.
• Criar código e testar as Funções do Azure localmente
  Descreve as opções para desenvolver suas funções localmente.