Criar uma função disparada pelo Armazenamento de Filas do AzureCreate a function triggered by Azure Queue storage

Saiba como criar uma função que é disparada quando as mensagens são enviadas para uma fila do Armazenamento do Azure.Learn how to create a function that is triggered when messages are submitted to an Azure Storage queue.

Exiba a mensagem nos logs.

Pré-requisitosPrerequisites

Criar um Aplicativo de funções do AzureCreate an Azure Function app

  1. Selecione o botão Criar um recurso no canto superior esquerdo do portal do Azure e selecione Computação > Aplicativo de funções.Select the Create a resource button found on the upper left-hand corner of the Azure portal, then select Compute > Function App.

    Criar um aplicativo de funções no portal do Azure

  2. Use as configurações do aplicativo de funções especificadas na tabela abaixo da imagem.Use the function app settings as specified in the table below the image.

    Definir novas configurações do aplicativo de funções

    ConfiguraçãoSetting Valor sugeridoSuggested value DESCRIÇÃODescription
    Nome do aplicativoApp name Nome globalmente exclusivoGlobally unique name Nome que identifica seu novo aplicativo de funções.Name that identifies your new function app. Os caracteres válidos são a-z, 0-9 e -.Valid characters are a-z, 0-9, and -.
    AssinaturaSubscription Sua assinaturaYour subscription A assinatura na qual este novo aplicativo de funções será criado.The subscription under which this new function app is created.
    Grupo de RecursosResource Group myResourceGroupmyResourceGroup Nome do novo grupo de recursos no qual criar o seu aplicativo de funções.Name for the new resource group in which to create your function app.
    SOOS WindowsWindows As opções de linguagem disponíveis dependem do sistema operacional do aplicativo de funções.The language options available depend on the OS of the function app. Por exemplo, o Python requer o Linux.For example, Python requires Linux.
    Plano de hospedagemHosting plan Plano de consumoConsumption plan Plano de hospedagem que define como os recursos são alocados para seu aplicativo de funções.Hosting plan that defines how resources are allocated to your function app. No Plano de Consumo padrão, os recursos são adicionados dinamicamente conforme exigido por suas funções.In the default Consumption Plan, resources are added dynamically as required by your functions. Nesta hospedagem sem servidor, você só paga pelo tempo durante o qual suas funções são executadas.In this serverless hosting, you only pay for the time your functions run. Quando você executa em um Plano do Serviço de Aplicativo, deve gerenciar o dimensionamento do aplicativo de funções.When you run in an App Service plan, you must manage the scaling of your function app.
    LocalidadeLocation Europa OcidentalWest Europe Escolha uma região perto de você ou perto de outros serviços que suas funções acessam.Choose a region near you or near other services your functions access.
    Pilha de tempo de execuçãoRuntime stack Linguagem preferencialPreferred language Escolha um tempo de execução compatível com sua linguagem de programação de funções favorita.Choose a runtime that supports your favorite function programming language. Escolha .NET para funções C# e F#.Choose .NET for C# and F# functions.
    ArmazenamentoStorage Nome globalmente exclusivoGlobally unique name Crie uma conta de armazenamento usada pelo seu aplicativo de funções.Create a storage account used by your function app. Os nomes da conta de armazenamento devem ter entre 3 e 24 caracteres e podem conter apenas números e letras minúsculas.Storage account names must be between 3 and 24 characters in length and may contain numbers and lowercase letters only. Você também pode usar uma conta existente, mas ela precisa atender aos requisitos da conta de armazenamento.You can also use an existing account, which must meets the storage account requirements.
    Application InsightsApplication Insights PadrãoDefault Cria um recurso do Application Insights do mesmo nome do aplicativo na região com suporte mais próxima.Creates an Application Insights resource of the same App name in the nearest supported region. Ao expandir essa configuração, você pode alterar o Novo nome do recurso ou escolher um Local diferente em uma geografia do Azure onde deseja armazenar seus dados.By expanding this setting, you can change the New resource name or choose a different Location in an Azure geography where you want to store your data.
  3. Selecione Criar para provisionar e implantar o aplicativo de funções.Select Create to provision and deploy the function app.

  4. Selecione o ícone da Notificação no canto superior direito do portal e veja se a mensagem Implantação concluída com êxito é exibida.Select the Notification icon in the upper-right corner of the portal and watch for the Deployment succeeded message.

    Definir novas configurações do aplicativo de funções

  5. Selecione Ir para recursos para exibir o novo aplicativo de funções.Select Go to resource to view your new function app. Você também pode selecionar Fixar no painel.You can also select Pin to dashboard. A fixação torna mais fácil retornar a esse recurso de aplicativo de função no seu painel.Pinning makes it easier to return to this function app resource from your dashboard.

Aplicativo de funções criado com êxito.

Em seguida, crie uma nova função no novo aplicativo de funções.Next, you create a function in the new function app.

Criar uma função disparada por FilasCreate a Queue triggered function

  1. Expanda seu aplicativo de funções e clique no botão + ao lado de Functions.Expand your function app and click the + button next to Functions. Se essa for a primeira função em seu aplicativo de funções, selecione No portal e depois Continuar.If this is the first function in your function app, select In-portal then Continue. Caso contrário, vá para a etapa três.Otherwise, go to step three.

    Página de início rápido de funções no portal do Azure

  2. Escolha Mais modelos e, em seguida, Concluir e exibir modelos.Choose More templates then Finish and view templates.

    Início Rápido do Functions, escolher mais modelos

  3. No campo de pesquisa, digite queue e escolha o modelo Gatilho de fila.In the search field, type queue and then choose the Queue trigger template.

  4. Se solicitado, selecione Instalar para instalar a extensão de Armazenamento do Azure em todas as dependências no aplicativo de funções.If prompted, select Install to install the Azure Storage extension any dependencies in the function app. Após a instalação ser bem-sucedida, selecione Continuar.After installation succeeds, select Continue.

    Instalar extensões de associação

  5. Use as configurações conforme especificado na tabela abaixo da imagem.Use the settings as specified in the table below the image.

    Configure a função disparada da fila de armazenamento.

    ConfiguraçãoSetting Valor sugeridoSuggested value DescriçãoDescription
    NomeName Exclusivo no aplicativo de funçõesUnique in your function app O nome dessa função disparada por filas.Name of this queue triggered function.
    Nome da filaQueue name myqueue-itemsmyqueue-items Nome da fila à qual se conectar em sua conta de armazenamento.Name of the queue to connect to in your Storage account.
    Conexão da conta de armazenamentoStorage account connection AzureWebJobStorageAzureWebJobStorage Você pode usar a conexão da conta de armazenamento que já está sendo usada por seu aplicativo de funções ou criar uma nova.You can use the storage account connection already being used by your function app, or create a new one.
  6. Clique em Criar para criar a função.Click Create to create your function.

Em seguida, você pode se conectar à sua conta de armazenamento do Azure e criar a fila de armazenamento myqueue-items.Next, you connect to your Azure Storage account and create the myqueue-items storage queue.

Criar a filaCreate the queue

  1. Em sua função, clique em Integrar, expanda Documentaçãoe copie Nome da conta e Chave de conta.In your function, click Integrate, expand Documentation, and copy both Account name and Account key. Você usa essas credenciais para conectar-se à conta de armazenamento no Gerenciador de Armazenamento do Microsoft Azure.You use these credentials to connect to the storage account in Azure Storage Explorer. Se você já tiver se conectado à conta de armazenamento, vá para a etapa 4.If you have already connected your storage account, skip to step 4.

    Obtenha as credenciais de conexão da conta de armazenamento.

  2. Execute a ferramenta Gerenciador de Armazenamento do Microsoft Azure, clique no ícone conectar-se à esquerda, escolha Usar um nome e chave de conta de armazenamento e clique em Avançar.Run the Microsoft Azure Storage Explorer tool, click the connect icon on the left, choose Use a storage account name and key, and click Next.

    Execute a ferramenta Gerenciador de Conta de Armazenamento.

  3. Insira o Nome da conta e Chave de conta da etapa 1, clique em Avançar e em Conectar.Enter the Account name and Account key from step 1, click Next and then Connect.

    Insira as credenciais de armazenamento e conecte-se.

  4. Expanda a conta de armazenamento anexada, clique com o botão direito do mouse em Filas, clique em Criar Fila, digite myqueue-items e pressione enter.Expand the attached storage account, right-click Queues, click Create Queue, type myqueue-items, and then press enter.

    Crie uma fila de armazenamento.

Agora que você tem uma fila de armazenamento, você pode testar a função adicionando uma mensagem à fila.Now that you have a storage queue, you can test the function by adding a message to the queue.

Testar a funçãoTest the function

  1. De volta ao Portal do Azure, navegue até sua função, expanda os Logs na parte inferior da página e verifique se o streaming de log não está em pausa.Back in the Azure portal, browse to your function, expand the Logs at the bottom of the page, and make sure that log streaming isn't paused.

  2. No Gerenciador de Armazenamento, expanda sua conta de armazenamento, Filas e myqueue-items; em seguida, clique em Adicionar mensagem.In Storage Explorer, expand your storage account, Queues, and myqueue-items, then click Add message.

    Adicione uma mensagem à fila.

  3. Digite sua mensagem "Olá, Mundo!"Type your "Hello World!" em Texto da mensagem e clique em OK.message in Message text and click OK.

  4. Aguarde alguns segundos, depois volte para seus logs de função e verifique se a nova mensagem foi lida da fila.Wait for a few seconds, then go back to your function logs and verify that the new message has been read from the queue.

    Exiba a mensagem nos logs.

  5. No Gerenciador de Armazenamento, clique em Atualizar e verifique se a mensagem foi processada e se não está mais na fila.Back in Storage Explorer, click Refresh and verify that the message has been processed and is no longer in the queue.

Limpar recursosClean up resources

Outros inícios rápidos nessa coleção aproveitam esse início rápido.Other quick starts in this collection build upon this quick start. Se você planeja trabalhar com inícios rápidos subsequentes, tutoriais ou com qualquer serviço criado por você nesse início rápido, não limpe os recursos.If you plan to work with subsequent quick starts, tutorials, or with any of the services you have created in this quick start, do not clean up the resources.

Os Recursos no Azure se referem a aplicativos de funções, funções, contas de armazenamento e assim por diante.Resources in Azure refers to function apps, functions, storage accounts, and so forth. Eles são agrupados em grupos de recursos, e você pode excluir tudo junto ao excluir o grupo.They are grouped into resource groups, and you can delete everything in a group by deleting the group.

Você criou recursos para concluir esses guias de início rápido.You created resources to complete these quickstarts. Você pode ser cobrado por esses recursos, dependendo do status de conta e preços do serviço.You may be billed for these resources, depending on your account status and service pricing. Caso não precise mais dos recursos, é possível excluí-los desta maneira:If you don't need the resources anymore, here's how to delete them:

  1. No portal do Azure, vá até a página Grupo de recursos.In the Azure portal, go to the Resource group page.

    Para ir até essa página a partir da página de aplicativo de funções, selecione a guia Visão geral e depois selecione o link em Grupo de recursos.To get to that page from the function app page, select the Overview tab and then select the link under Resource group.

    Selecione o grupo de recursos para excluir a partir da página do aplicativo de funções.

    Para ir até essa página a partir do painel, selecione Grupos de recursos e depois selecione o grupo de recursos que você usou para esse guia de início rápido.To get to that page from the dashboard, select Resource groups, and then select the resource group that you used for this quickstart.

  2. Na página Grupo de recursos, examine a lista de recursos incluídos e verifique se eles são aqueles que deseja excluir.In the Resource group page, review the list of included resources, and verify that they are the ones you want to delete.

  3. Selecione Excluir grupo de recursos e siga as instruções.Select Delete resource group, and follow the instructions.

    A exclusão poderá levar alguns minutos.Deletion may take a couple of minutes. Ao ser concluída, uma notificação será exibida por alguns segundos.When it's done, a notification appears for a few seconds. Também é possível selecionar o ícone de sino na parte superior da página para exibir a notificação.You can also select the bell icon at the top of the page to view the notification.

Próximas etapasNext steps

Você criou uma função que é executada quando uma mensagem é adicionada a uma fila de armazenamento.You have created a function that runs when a message is added to a storage queue. Para obter mais informações sobre gatilhos de Armazenamento de Filas, consulte Associações de fila do Armazenamento do Azure Functions.For more information about Queue storage triggers, see Azure Functions Storage queue bindings.

Agora que você criou sua primeira função, vamos adicionar uma associação de saída à função que grava uma mensagem de volta em outra fila.Now that you have a created your first function, let's add an output binding to the function that writes a message back to another queue.