Démarrage rapide : Créer une tâche Azure Stream Analytics à l’aide de Visual StudioQuickstart: Create an Azure Stream Analytics job by using Visual Studio

Ce démarrage rapide vous montre comment créer et exécuter une tâche Stream Analytics à l’aide d’Azure Stream Analytics Tools pour Visual Studio.This quickstart shows you how to create and run a Stream Analytics job using Azure Stream Analytics tools for Visual Studio. Cet exemple de travail lit les données de streaming à partir d’un appareil IoT Hub.The example job reads streaming data from an IoT Hub device. Vous définissez un travail qui calcule la température moyenne quand elle dépasse 27 degrés et qui écrit les événements de sortie résultants dans un nouveau fichier du stockage d’objets blob.You define a job that calculates the average temperature when over 27° and writes the resulting output events to a new file in blob storage.

Notes

Les outils Visual Studio et Visual Studio Code ne prennent pas en charge les travaux dans les régions Chine Est, Chine Nord, Allemagne Centre et Allemagne Nord-Est.Visual Studio and Visual Studio Code tools don't support jobs in the China East, China North, Germany Central, and Germany NorthEast regions.

Avant de commencerBefore you begin

  • Si vous n’avez pas d’abonnement Azure, créez un compte gratuit.If you don't have an Azure subscription, create a free account.

  • Connectez-vous au portail Azure.Sign in to the Azure portal.

  • Installez Visual Studio 2019, Visual Studio 2015 ou Visual Studio 2013 Update 4.Install Visual Studio 2019, Visual Studio 2015, or Visual Studio 2013 Update 4. Les éditions Enterprise (Ultimate/Premium), Professional et Community sont prises en charge.Enterprise (Ultimate/Premium), Professional, and Community editions are supported. L’édition Express n’est pas prise en charge.Express edition is not supported.

  • Suivez les instructions d’installation pour installer Stream Analytics Tools pour Visual Studio.Follow the installation instructions to install Stream Analytics tools for Visual Studio.

Préparer les données d’entréePrepare the input data

Avant de définir le travail Stream Analytics, vous devez préparer les données qui seront configurées ultérieurement comme entrée pour le travail.Before defining the Stream Analytics job, you should prepare the data, which is later configured as the job input. Pour préparer les données d’entrée requises pour le travail, exécutez les opérations suivantes :To prepare the input data required by the job, complete the following steps:

  1. Connectez-vous au portail Azure.Sign in to the Azure portal.

  2. Sélectionnez Créer une ressource > Internet des objets > IoT Hub.Select Create a resource > Internet of Things > IoT Hub.

  3. Dans le volet IoT Hub, entrez les informations suivantes :In the IoT Hub pane, enter the following information:

    ParamètreSetting Valeur suggéréeSuggested value DescriptionDescription
    AbonnementSubscription <Your subscription> Sélectionnez l’abonnement Azure que vous souhaitez utiliser.Select the Azure subscription that you want to use.
    Resource groupResource group asaquickstart-resourcegroupasaquickstart-resourcegroup Sélectionnez Créer et saisissez le nom du nouveau groupe de ressources pour votre compte.Select Create New and enter a new resource-group name for your account.
    RégionRegion <Select the region that is closest to your users> Sélectionnez l’emplacement géographique où vous pouvez héberger votre hub IoT.Select a geographic location where you can host your IoT Hub. Utilisez l’emplacement le plus proche de vos utilisateurs.Use the location that's closest to your users.
    Nom du hub IoTIoT Hub Name MyASAIoTHubMyASAIoTHub Sélectionnez un nom pour votre hub IoT.Select a name for your IoT Hub.

    Création d’un IoT Hub

  4. Sélectionnez Suivant : Définir la taille et l’échelle.Select Next: Set size and scale.

  5. Choisissez votre niveau de tarification et de mise à l’échelle.Choose your Pricing and scale tier. Pour ce guide de démarrage rapide, sélectionnez le niveau F1 - Gratuit s’il est toujours disponible sur votre abonnement.For this quickstart, select the F1 - Free tier if it's still available on your subscription. Si le niveau Gratuit n’est pas disponible, choisissez le niveau le plus bas disponible.If the free tier is unavailable, choose the lowest tier available. Pour plus d’informations, consultez la tarification IoT Hub.For more information, see IoT Hub pricing.

    Dimensionnement et mise à l’échelle de votre hub IoT

  6. Sélectionnez Revoir + créer.Select Review + create. Passez en revue les informations de votre hub IoT et cliquez sur Créer.Review your IoT Hub information and click Create. La création de votre hub IoT peut prendre plusieurs minutes.Your IoT Hub might take a few minutes to create. Vous pouvez suivre la progression dans le volet Notifications.You can monitor the progress in the Notifications pane.

  7. Dans le menu de navigation de votre hub IoT, cliquez sur Ajouter sous Appareils IoT.In your IoT Hub navigation menu, click Add under IoT devices. Ajoutez un ID d’appareil et cliquez sur Enregistrer.Add a Device ID and click Save.

    Ajouter un appareil dans votre hub IoT

  8. Une fois que l’appareil a été créé, ouvrez-le dans la liste Appareils IoT.Once the device is created, open the device from the IoT devices list. Copiez la valeur Chaîne de connexion -- clé primaire et enregistrez-la dans un bloc-notes pour une utilisation ultérieure.Copy the Connection string -- primary key and save it to a notepad to use later.

    Copier la chaîne de connexion de l’appareil IoT Hub

Créer un stockage d’objets blobCreate blob storage

  1. Dans le coin supérieur gauche du portail Azure, sélectionnez Créer une ressource > Stockage > Compte de stockage.From the upper left-hand corner of the Azure portal, select Create a resource > Storage > Storage account.

  2. Dans le volet Créer un compte de stockage, entrez un nom, un emplacement et un groupe de ressources de compte de stockage.In the Create storage account pane, enter a storage account name, location, and resource group. Choisissez les mêmes emplacement et groupe de ressources que pour le hub IoT que vous avez créé.Choose the same location and resource group as the IoT Hub you created. Ensuite, cliquez sur Vérifier + créer pour créer le compte.Then click Review + create to create the account.

    Créer un compte de stockage

  3. Une fois que votre compte de stockage a été créé, sélectionnez la vignette Objets blob dans le volet Vue d’ensemble.Once your storage account is created, select the Blobs tile on the Overview pane.

    Vue d’ensemble du compte de stockage

  4. Dans la page Service Blob, sélectionnez Conteneur et donnez un nom à votre conteneur, tel que conteneur1.From the Blob Service page, select Container and provide a name for your container, such as container1. Pour Niveau d’accès public laissez la valeur Privé (aucun accès anonyme) et sélectionnez OK.Leave the Public access level as Private (no anonymous access) and select OK.

    Création du conteneur d’objets blob

Créer un projet Stream AnalyticsCreate a Stream Analytics project

  1. Démarrez Visual Studio.Start Visual Studio.

  2. Sélectionnez Fichier > Nouveau Projet.Select File > New Project.

  3. Dans la liste des modèles sur la gauche, sélectionnez Stream Analytics, puis Application Azure Stream Analytics.In the templates list on the left, select Stream Analytics, and then select Azure Stream Analytics Application.

  4. Entrez les éléments Nom, Emplacement et Nom de la solution de votre projet, puis sélectionnez OK.Input the project Name, Location, and Solution name, and select OK.

    Créer un projet Stream Analytics

Notez les éléments inclus dans un projet Azure Stream Analytics.Notice the elements that are included in an Azure Stream Analytics project.

Azure Stream Analytics project elements

Choisir le bon abonnementChoose the required subscription

  1. Dans le menu Affichage de Visual Studio, sélectionnez Explorateur de serveurs.In Visual Studio, on the View menu, select Server Explorer.

  2. Cliquez avec le bouton droit sur Azure, sélectionnez Se connecter à un abonnement Microsoft Azure, puis connectez-vous avec votre compte Azure.Right click on Azure, select Connect to Microsoft Azure Subscription, and then sign in with your Azure account.

Définir l’entréeDefine input

  1. Dans l’Explorateur de solutions, développez le nœud Entrées et double-cliquez sur Input.json.In Solution Explorer, expand the Inputs node and double-click Input.json.

  2. Renseignez la Configuration d'entrée Stream Analytics avec les valeurs suivantes :Fill out the Stream Analytics Input Configuration with the following values:

    ParamètreSetting Valeur suggéréeSuggested value DescriptionDescription
    Alias d’entréeInput Alias EntréeInput Saisissez un nom pour identifier l’entrée du travail.Enter a name to identify the job’s input.
    Type de sourceSource Type Flux de donnéesData Stream Choisissez la source d’entrée appropriée : Flux de données ou Données de référence.Choose the appropriate input source: Data Stream or Reference Data.
    SourceSource IoT HubIoT Hub Sélectionnez la bonne source d’entrée.Choose the appropriate input source.
    RessourceResource Choisir une source de données du compte actuelChoose data source from current account Vous pouvez entrer les données manuellement ou sélectionner un compte existant.Choose to enter data manually or select an existing account.
    AbonnementSubscription <Your subscription> Sélectionnez l’abonnement Azure qui contient le hub IoT que vous avez créé.Select the Azure subscription that has the IoT Hub you created.
    IoT HubIoT Hub MyASAIoTHubMyASAIoTHub Choisissez ou entrez le nom de votre hub IoT.Choose or enter the name of your IoT Hub. Si les hubs IoT sont créés dans le même abonnement, leurs noms sont automatiquement détectés.IoT Hub names are automatically detected if they are created in the same subscription.
  3. Conservez les valeurs par défaut pour les autres options et sélectionnez Enregistrer pour enregistrer les paramètres.Leave other options to default values and select Save to save the settings.

    Configurer les données d’entrée

Définir la sortieDefine output

  1. Dans l’Explorateur de solutions, développez le nœud Sorties et double-cliquez sur Output.json.In Solution Explorer, expand the Outputs node and double-click Output.json.

  2. Renseignez la Configuration de sortie Stream Analytics avec les valeurs suivantes :Fill out the Stream Analytics Output Configuration with the following values:

    ParamètreSetting Valeur suggéréeSuggested value DescriptionDescription
    Alias de sortieOutput Alias OutputOutput Saisissez un nom pour identifier la sortie du travail.Enter a name to identify the job’s output.
    RécepteurSink Stockage BlobBlob Storage Sélectionnez le bon récepteur.Choose the appropriate sink.
    RessourceResource Spécifier manuellement les paramètres de la source de donnéesProvide data source settings manually Vous pouvez entrer les données manuellement ou sélectionner un compte existant.Choose to enter data manually or select an existing account.
    AbonnementSubscription <Your subscription> Sélectionnez l’abonnement Azure contenant le compte de stockage que vous avez créé.Select the Azure subscription that has the storage account you created. Le compte de stockage peut être dans le même abonnement ou dans un abonnement distinct.The storage account can be in the same or in a different subscription. Cet exemple suppose que vous avez créé le compte de stockage dans le même abonnement.This example assumes that you have created storage account in the same subscription.
    Compte de stockageStorage Account asaquickstartstorageasaquickstartstorage Sélectionnez ou saisissez le nom du compte de stockage.Choose or enter the name of the storage account. Les noms de compte de stockage sont automatiquement détectés s’ils sont créés dans le même abonnement.Storage account names are automatically detected if they are created in the same subscription.
    ConteneurContainer conteneur1container1 Sélectionnez un conteneur existant que vous avez créé dans votre compte de stockage.Select the existing container that you created in your storage account.
    Modèle de chemin d'accèsPath Pattern sortieoutput Entrez le nom d’un chemin de fichier qui doit être créé dans le conteneur.Enter the name of a file path to be created within the container.
  3. Conservez les valeurs par défaut pour les autres options et sélectionnez Enregistrer pour enregistrer les paramètres.Leave other options to default values and select Save to save the settings.

    Configurer les données de sortie

Définir la requête de transformationDefine the transformation query

  1. Ouvrez Script.asaql à partir de l’Explorateur de solutions dans Visual Studio.Open Script.asaql from Solution Explorer in Visual Studio.

  2. Ajoutez la requête suivante :Add the following query:

    SELECT *
    INTO Output
    FROM Input
    HAVING Temperature > 27
    

Envoyer une requête Stream Analytics sur AzureSubmit a Stream Analytics query to Azure

  1. Dans l’éditeur de requête, sélectionnez Envoyer sur Azure dans l’éditeur de script.In the Query Editor, select Submit To Azure in the script editor.

  2. Sélectionnez Créer une tâche Azure Stream Analytics et entrez un Nom de tâche.Select Create a New Azure Stream Analytics job and enter a Job Name. Choisissez l’Abonnement, le Groupe de ressources, et l’Emplacement que vous avez utilisés au début du démarrage rapide.Choose the Subscription, Resource Group, and Location you used at the beginning of the Quickstart.

    Envoyer la tâche sur Azure

Exécuter le simulateur IoTRun the IoT simulator

  1. Ouvrez le simulateur en ligne Azure IoT Raspberry Pi dans un autre onglet ou une nouvelle fenêtre de navigateur.Open the Raspberry Pi Azure IoT Online Simulator in a new browser tab or window.

  2. Remplacez l’espace réservé à la ligne 15 par la chaîne de connexion de l’appareil Azure IoT Hub.Replace the placeholder in Line 15 with the Azure IoT Hub device connection string you saved in a previous section.

  3. Cliquez sur Exécuter.Click Run. La sortie doit indiquer les données de capteur et les messages qui sont envoyés à votre hub IoT.The output should show the sensor data and messages that are being sent to your IoT Hub.

    Simulateur en ligne Azure IoT Raspberry Pi

Démarrer la tâche Stream Analytics et observez le résultatStart the Stream Analytics job and check output

  1. Dès lors que votre tâche est créée, sa vue s’ouvre automatiquement.When your job is created, the job view opens automatically. Cliquez sur le bouton à la flèche verte pour commencer la tâche,Select the green arrow button to start the job,

    Démarrer une tâche Stream Analytics

  2. Changez le mode de démarrage de la sortie du projet à JobStartTime et sélectionnez Démarrer.Change the Job output start mode to JobStartTime and select Start.

    Démarrer la configuration de la tâche

  3. Constatez que l’état du travail est passé à En cours d’exécution et qu'il existe des événements d’entrée/de sortie.Note the job status has changed to Running, and there are input/output events. Cela peut prendre quelques minutes.This may take a few minutes.

    Exécution de la tâche Stream Analytics

  4. Pour afficher les résultats, dans le menu Affichage, sélectionnez Cloud Explorer et accédez au compte de stockage dans votre groupe de ressources.To view results, on the View menu, select Cloud Explorer, and navigate to the storage account in your resource group. Sous Conteneurs d’objets blob, double-cliquez sur container1, puis le chemin du fichier de sortie.Under Blob Containers, double-click container1, and then the output file path.

    Afficher les résultats

Nettoyer les ressourcesClean up resources

Lorsque vous n’en avez plus besoin, supprimez le groupe de ressources, le travail de streaming et toutes les ressources associées.When no longer needed, delete the resource group, the streaming job, and all related resources. La suppression du travail évite la facturation des unités de streaming consommées par le travail.Deleting the job avoids billing the streaming units consumed by the job. Si vous envisagez d’utiliser le travail à l’avenir, vous pouvez l’arrêter et le redémarrer plus tard lorsque vous en avez besoin.If you're planning to use the job in future, you can stop it and restart it later when you need. Si vous ne pensez pas continuer à utiliser ce travail, supprimez toutes les ressources créées pendant ce guide de démarrage rapide en procédant comme suit :If you are not going to continue to use this job, delete all resources created by this quickstart by using the following steps:

  1. Dans le menu de gauche du portail Azure, cliquez sur Groupes de ressources, puis sur le nom de la ressource que vous avez créée.From the left-hand menu in the Azure portal, select Resource groups and then select the name of the resource you created.

  2. Sur la page de votre groupe de ressources, sélectionnez Supprimer, saisissez le nom de la ressource à supprimer dans la zone de texte, puis sélectionnez Supprimer.On your resource group page, select Delete, type the name of the resource to delete in the text box, and then select Delete.

Étapes suivantesNext steps

Dans ce guide de démarrage rapide, vous avez déployé un travail Stream Analytics simple à l’aide de Visual Studio.In this quickstart, you deployed a simple Stream Analytics job using Visual Studio. Vous pouvez également déployer des travaux Stream Analytics à l’aide du Portail Azure et de PowerShell.You can also deploy Stream Analytics jobs using the Azure portal and PowerShell.

Pour en savoir plus sur les outils Azure Stream Analytics pour Visual Studio, consultez l’article suivant :To learn about Azure Stream Analytics tools for Visual Studio, continue to the following article: