Créer une fonction déclenchée par une file d’attente de stockage AzureCreate a function triggered by Azure Queue storage

Découvrez comment créer une fonction qui est déclenchée lorsque des messages sont envoyés à une file d’attente de stockage Azure.Learn how to create a function that is triggered when messages are submitted to an Azure Storage queue.

PrérequisPrerequisites

  • Un abonnement Azure.An Azure subscription. Si vous n’en avez pas, créez un compte gratuit avant de commencer.If you don't have one, create a free account before you begin.

Création d’une application Azure FunctionCreate an Azure Function app

  1. Dans le menu du portail Azure ou dans la page Accueil, sélectionnez Créer une ressource.From the Azure portal menu or the Home page, select Create a resource.

  2. Dans la page Nouveau, sélectionnez Calcul > Application de fonction.In the New page, select Compute > Function App.

  3. Dans la page De base, utilisez les paramètres d’application de fonction comme indiqué dans le tableau ci-dessous.On the Basics page, use the function app settings as specified in the following table.

    ParamètreSetting Valeur suggéréeSuggested value DescriptionDescription
    AbonnementSubscription Votre abonnementYour subscription Abonnement sous lequel est créée cette nouvelle application de fonction.The subscription under which this new function app is created.
    Groupe de ressourcesResource Group myResourceGroupmyResourceGroup Nom du nouveau groupe de ressources dans lequel créer votre Function App.Name for the new resource group in which to create your function app.
    Nom de l’application de fonctionFunction App name Nom global uniqueGlobally unique name Nom qui identifie votre nouvelle Function App.Name that identifies your new function app. Les caractères valides sont a-z (insensible à la casse), 0-9et -.Valid characters are a-z (case insensitive), 0-9, and -.
    PublierPublish CodeCode Option permettant de publier des fichiers de code ou un conteneur Docker.Option to publish code files or a Docker container.
    Pile d’exécutionRuntime stack Langage préféréPreferred language Choisissez un runtime qui prend en charge votre langage de programmation de fonction favori.Choose a runtime that supports your favorite function programming language. La modification dans le portail n’est disponible que pour les scripts JavaScript, PowerShell, TypeScript et C#.In-portal editing is only available for JavaScript, PowerShell, TypeScript, and C# script. Les fonctions de la bibliothèque de classes C#, ainsi que les fonctions Java et Python doivent être développées localement.C# class library, Java, and Python functions must be developed locally.
    VersionVersion Numéro de versionVersion number Choisissez la version de votre runtime installé.Choose the version of your installed runtime.
    RégionRegion Région recommandéePreferred region Choisissez une région près de chez vous ou près d’autres services auxquels ont accès vos fonctions.Choose a region near you or near other services your functions access.
  4. Sélectionnez Suivant : Hébergement.Select Next : Hosting. Dans la page Hébergement, entrez les paramètres suivants.On the Hosting page, enter the following settings.

    ParamètreSetting Valeur suggéréeSuggested value DescriptionDescription
    Compte de stockageStorage account Nom globalement uniqueGlobally unique name Créez un compte de stockage utilisé par votre application de fonction.Create a storage account used by your function app. Les noms des comptes de stockage doivent comporter entre 3 et 24 caractères, uniquement des lettres minuscules et des chiffres.Storage account names must be between 3 and 24 characters in length and can contain numbers and lowercase letters only. Vous pouvez également utiliser un compte existant qui doit répondre aux exigences relatives aux comptes de stockage.You can also use an existing account, which must meet the storage account requirements.
    Système d’exploitationOperating system WindowsWindows Un système d’exploitation est présélectionné pour vous en fonction de la sélection de votre pile d’exécution, mais vous pouvez modifier le paramètre si nécessaire.An operating system is pre-selected for you based on your runtime stack selection, but you can change the setting if necessary. La modification sur le portail est prise en charge sur Windows uniquement.In-portal editing is only supported on Windows.
    PlanPlan Consommation (serverless)Consumption (Serverless) Plan d’hébergement qui définit la façon dont les ressources sont allouées à votre Function App.Hosting plan that defines how resources are allocated to your function app. Dans le plan de Consommation par défaut, les ressources sont ajoutées dynamiquement en fonction des besoins de vos fonctions.In the default Consumption plan, resources are added dynamically as required by your functions. Avec cet hébergement serverless, vous payez uniquement pour la durée d’exécution de vos fonctions.In this serverless hosting, you pay only for the time your functions run. Si vous exécutez dans un plan App Service, vous devez gérer la mise à l’échelle de votre application de fonction.When you run in an App Service plan, you must manage the scaling of your function app.
  5. Sélectionnez Suivant : Supervision.Select Next : Monitoring. Dans la page Supervision, entrez les paramètres suivants.On the Monitoring page, enter the following settings.

    ParamètreSetting Valeur suggéréeSuggested value DescriptionDescription
    Application InsightsApplication Insights DefaultDefault Crée une ressource Application Insights avec le même nom de l’application dans la région prise en charge la plus proche.Creates an Application Insights resource of the same App name in the nearest supported region. En développant ce paramètre ou en sélectionnant Créer nouveau, vous pouvez modifier le nom Application Insights ou choisir une autre région dans une zone géographique Azure où vous souhaitez stocker vos données.By expanding this setting or selecting Create new, you can change the Application Insights name or choose a different region in an Azure geography where you want to store your data.
  6. Sélectionnez Vérifier + créer pour passer en revue les sélections de configuration d’application.Select Review + create to review the app configuration selections.

  7. Dans la page Vérifier + créer, vérifiez vos paramètres, puis sélectionnez Créer pour provisionner et déployer l’application de fonction.On the Review + create page, review your settings, and then select Create to provision and deploy the function app.

  8. Cliquez sur l’icône Notifications en haut à droite du portail pour voir le message Le déploiement a été effectué.Select the Notifications icon in the upper-right corner of the portal and watch for the Deployment succeeded message.

  9. Sélectionnez Accéder à la ressource pour afficher votre nouvelle application de fonction.Select Go to resource to view your new function app. Vous pouvez également sélectionner Épingler au tableau de bord.You can also select Pin to dashboard. L’épinglage permet de revenir plus facilement à cette ressource d’application de fonction à partir de votre tableau de bord.Pinning makes it easier to return to this function app resource from your dashboard.

    Notification de déploiement

Function App créée avec succès.

Créez ensuite une fonction dans la nouvelle Function App.Next, you create a function in the new function app.

Créer une fonction déclenchée par une file d’attenteCreate a Queue triggered function

  1. Sélectionnez Fonctions, puis + Ajouter pour ajouter une nouvelle fonction.Select Functions, and then select + Add to add a new function.

    Function App créée avec succès.

  2. Choisissez le modèle déclencheur de file d’attente de stockage.Choose the Azure Queue Storage trigger template.

  3. Utilisez les paramètres spécifiés dans le tableau sous l’image.Use the settings as specified in the table below the image.

    Function App créée avec succès.

    ParamètreSetting Valeur suggéréeSuggested value DescriptionDescription
    NomName Unique dans votre Function AppUnique in your function app Nom de cette fonction déclenchée par la file d’attente.Name of this queue triggered function.
    Nom de la file d’attenteQueue name éléments myqueuemyqueue-items Le nom de la file d’attente à connecter à votre compte de stockage.Name of the queue to connect to in your Storage account.
    Connexion au compte de stockageStorage account connection AzureWebJobsStorageAzureWebJobsStorage Vous pouvez utiliser la connexion de compte de stockage qui est déjà utilisée par votre application de fonction, ou créez-en une.You can use the storage account connection already being used by your function app, or create a new one.
  4. Sélectionnez Créer une fonction pour créer votre fonction.Select Create Function to create your function.

    Function App créée avec succès.

Ensuite, connectez-vous à votre compte de stockage Azure et créez la file d’attente de stockage myqueue-items.Next, you connect to your Azure storage account and create the myqueue-items storage queue.

Créer la file d’attenteCreate the queue

  1. Dans votre fonction, sur la page Vue d’ensemble, sélectionnez votre groupe de ressources.In your function, on the Overview page, select your resource group.

    Function App créée avec succès.

  2. Recherchez et sélectionnez le compte de stockage de votre groupe de ressources.Find and select your resource group's storage account.

    Function App créée avec succès.

  3. Choisissez Files d’attente, puis + File d’attente.Choose Queues, and then choose + Queue.

    Function App créée avec succès.

  4. Dans le champ Nom, tapez myqueue-items, puis sélectionnez Créer.In the Name field, type myqueue-items, and then select Create.

    Function App créée avec succès.

Maintenant que vous disposez d’une file d’attente de stockage, vous pouvez tester la fonction en ajoutant un message à la file d’attente.Now that you have a storage queue, you can test the function by adding a message to the queue.

Tester la fonctionTest the function

  1. Dans le portail Azure, accédez à votre fonction, développez les Journaux d’activité en bas de la page et vérifiez que la diffusion de journaux d’activité n’est pas suspendue.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.

    Function App créée avec succès.

  2. Dans une fenêtre de navigateur distincte, accédez à votre groupe de ressources dans le Portail Azure, puis sélectionnez le compte de stockage.In a separate browser window, go to your resource group in the Azure portal, and select the storage account.

  3. Sélectionnez Files d’attente, puis sélectionnez le conteneur myQueue-items.Select Queues, and then select the myqueue-items container.

    Function App créée avec succès.

  4. Sélectionnez Ajouter un message, puis tapez « Hello World ! »Select Add message, and type "Hello World!" dans Texte du message.in Message text. Sélectionnez OK.Select OK.

    Function App créée avec succès.

  5. Attendez quelques secondes, puis retournez à vos journaux d’activité de fonction et vérifiez que le nouveau message a été lu à partir de la file d’attente.Wait for a few seconds, then go back to your function logs and verify that the new message has been read from the queue.

    Function App créée avec succès.

  6. De retour dans votre file d’attente de stockage, sélectionnez Actualiser et vérifiez que le message a été traité et qu’il ne se trouve plus dans la file d’attente.Back in your storage queue, select Refresh and verify that the message has been processed and is no longer in the queue.

Nettoyer les ressourcesClean up resources

Les autres démarrages rapides de cette collection reposent sur ce démarrage rapide.Other quickstarts in this collection build upon this quickstart. Si vous envisagez d’utiliser d’autres guides de démarrage rapide, tutoriels ou l’un des services que vous avez créés dans ce guide de démarrage rapide, ne supprimez pas les ressources.If you plan to work with subsequent quickstarts, tutorials, or with any of the services you have created in this quickstart, do not clean up the resources.

Ressources dans Azure fait référence aux applications de fonction, fonctions, comptes de stockage, et ainsi de suite.Resources in Azure refer to function apps, functions, storage accounts, and so forth. Elles sont rassemblées en groupes de ressources, et vous pouvez supprimer tous les éléments d’un groupe en supprimant le groupe.They're grouped into resource groups, and you can delete everything in a group by deleting the group.

Vous avez créé des ressources pour effectuer ces démarrages rapides.You created resources to complete these quickstarts. Vous pouvez être facturé pour ces ressources, en fonction de l’état de votre compte et de la tarification du service.You may be billed for these resources, depending on your account status and service pricing. Si vous n’avez plus besoin des ressources, voici comment les supprimer :If you don't need the resources anymore, here's how to delete them:

  1. Dans le portail Azure, accédez à la page Groupe de ressources.In the Azure portal, go to the Resource group page.

    Pour accéder à cette page à partir de la page d’application de fonction, sélectionnez l’onglet Vue d’ensemble, puis le lien situé sous Groupe de ressources.To get to that page from the function app page, select the Overview tab and then select the link under Resource group.

    Sélectionnez le groupe de ressources à supprimer dans la page d’application de fonction.

    Pour accéder à la page à partir du tableau de bord, sélectionnez Groupes de ressources, puis le groupe de ressources que vous avez utilisé pour ce démarrage rapide.To get to that page from the dashboard, select Resource groups, and then select the resource group that you used for this quickstart.

  2. Dans la page Groupe de ressources, passez en revue la liste des ressources incluses et vérifiez qu’elles correspondent à celles que vous souhaitez supprimer.In the Resource group page, review the list of included resources, and verify that they're the ones you want to delete.

  3. Sélectionnez Supprimer le groupe de ressources et suivez les instructions.Select Delete resource group, and follow the instructions.

    Cette opération peut prendre quelques minutes.Deletion may take a couple of minutes. Une fois terminée, une notification s’affiche pendant quelques secondes.When it's done, a notification appears for a few seconds. Vous pouvez également sélectionner l’icône représentant une cloche en haut de la page pour afficher la notification.You can also select the bell icon at the top of the page to view the notification.

Étapes suivantesNext steps

Vous avez créé une fonction qui s’exécute lorsqu’un message est ajouté à une file d’attente de stockage.You have created a function that runs when a message is added to a storage queue. Pour en savoir plus sur les déclencheurs de stockage en file d’attente, consultez la page Liaisons de file d’attente de stockage Azure Functions.For more information about Queue storage triggers, see Azure Functions Storage queue bindings.

Maintenant que vous avez créé votre première fonction, nous allons ajouter une liaison de sortie à la fonction qui écrit un message dans une autre file d’attente.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.