Démarrage rapide : Créer une tâche Azure Stream Analytics à l’aide de 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. Cet exemple de travail lit les données de streaming à partir d’un appareil IoT Hub. 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.

Avant de commencer

• Si vous n’avez pas d’abonnement Azure, créez un compte gratuit.

• Connectez-vous au portail Azure.

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

• Suivez les instructions d’installation pour installer les outils Stream Analytics pour Visual Studio.

Préparer les données d’entrée

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. Pour préparer les données d’entrée requises pour le travail, exécutez les opérations suivantes :

1. Connectez-vous au portail Azure.

2. Sélectionnez Créer une ressource>Internet des objets>IoT Hub.

3. Dans le volet IoT Hub, entrez les informations suivantes :

   Paramètre	Valeur suggérée	Description
   Abonnement	<Votre abonnement>	Sélectionnez l’abonnement Azure que vous souhaitez utiliser.
   Resource group	asaquickstart-resourcegroup	Sélectionnez Créer et saisissez le nom du nouveau groupe de ressources pour votre compte.
   Nom du hub IoT	MyASAIoTHub	Sélectionnez un nom pour votre hub IoT.
   Région	<Sélectionnez la région la plus proche de vos utilisateurs>	Sélectionnez l’emplacement géographique où vous pouvez héberger votre hub IoT. Utilisez l’emplacement le plus proche de vos utilisateurs.
   Niveau	Gratuit	Pour ce démarrage rapide, sélectionnez Gratuit s’il est toujours disponible sur votre abonnement. Si le niveau Gratuit n’est pas disponible, choisissez le niveau le plus bas disponible. Pour plus d’informations, consultez la tarification IoT Hub.

   

4. Sélectionnez Revoir + créer. Passez en revue les informations de votre IoT Hub et sélectionnez Créer. La création de votre hub IoT peut prendre plusieurs minutes. Vous pouvez suivre la progression dans le volet Notifications.

5. Après la fin du déploiement, sélectionnez Accéder à la ressource pour accéder à la page IoT Hub de votre hub IoT.

6. Sur la page IoT Hub, sélectionnez Appareils sous Gestion des appareils dans le menu de navigation de gauche.

7. Sur la page Appareils, sélectionnez + Ajouter un appareil dans la barre d’outils.

   

8. Sur la page Créer un appareil, entrez un nom pour l’appareil, puis sélectionnez Enregistrer.

   

9. Une fois que l’appareil a été créé, ouvrez-le dans la liste Appareils IoT. Si vous ne voyez pas encore l’appareil, actualisez la page.

   

10. Copiez la Chaîne de connexion principale et enregistrez-la dans un bloc-notes pour une utilisation ultérieure.

Créer un stockage d’objets blob

1. Dans le coin supérieur gauche du portail Azure, sélectionnez Créer une ressource>Stockage>Compte de stockage.

2. Dans le volet Créer un compte de stockage, entrez un nom, un emplacement et un groupe de ressources de compte de stockage. Choisissez les mêmes emplacement et groupe de ressources que pour le hub IoT que vous avez créé. Ensuite, sélectionnez Vérifier + créer pour créer le compte.

   

3. Une fois votre compte de stockage créé, sélectionnez la vignette Service BLOB dans le volet Vue d’ensemble.

   

4. Dans la page Service BLOB, sélectionnez + Conteneur dans la barre d’outils.

5. Sur la page Nouveau conteneur, attribuez un nom à votre conteneur, par exemple conteneur1. Pour Niveau d’accès public, laissez la valeur Privé (aucun accès anonyme) et sélectionnez Créer.

   

Créer un projet Stream Analytics

1. Démarrez Visual Studio.

2. Sélectionnez Fichier > Nouveau Projet.

3. Dans la liste des modèles sur la gauche, sélectionnez Stream Analytics, puis Application Azure Stream Analytics.

4. Entrez les éléments Nom, Emplacement et Nom de la solution de votre projet, puis sélectionnez Créer.

   

5. Notez les éléments inclus dans un projet Azure Stream Analytics.

   

Choisir le bon abonnement

1. Dans le menu Affichage de Visual Studio, sélectionnez Explorateur de serveurs.
2. Cliquez avec le bouton droit sur Azure, sélectionnez Se connecter à un abonnement Microsoft Azure, puis connectez-vous avec votre compte Azure.

Définir l’entrée

1. Dans l’Explorateur de solutions, développez le nœud Entrées et double-cliquez sur Input.json.

2. Renseignez la Configuration d'entrée Stream Analytics avec les valeurs suivantes :

   Paramètre	Valeur suggérée	Description
   Alias d’entrée	Entrée	Saisissez un nom pour identifier l’entrée du travail.
   Type de source	Flux de données	Choisissez la source d’entrée appropriée : Flux de données ou Données de référence.
   Source	IoT Hub	Sélectionnez la bonne source d’entrée.
   Ressource	Choisir une source de données du compte actuel	Vous pouvez entrer les données manuellement ou sélectionner un compte existant.
   Abonnement	<Votre abonnement>	Sélectionnez l’abonnement Azure qui contient le hub IoT que vous avez créé.
   IoT Hub	MyASAIoTHub	Choisissez ou entrez le nom de votre hub IoT. Si des noms Hubs IoT sont créés dans le même abonnement, ils sont automatiquement détectés.

3. Conservez les valeurs par défaut pour les autres options et sélectionnez Enregistrer pour enregistrer les paramètres.

   

Définir la sortie

1. Dans l’Explorateur de solutions, développez le nœud Sorties et double-cliquez sur Output.json.

2. Renseignez la Configuration de sortie Stream Analytics avec les valeurs suivantes :

   Paramètre	Valeur suggérée	Description
   Alias de sortie	Output	Saisissez un nom pour identifier la sortie du travail.
   Récepteur	Stockage d’objets blob/Data Lake Storage Gen2	Sélectionnez le bon récepteur.
   Ressource	Spécifier manuellement les paramètres de la source de données	Vous pouvez entrer les données manuellement ou sélectionner un compte existant.
   Abonnement	<Votre abonnement>	Sélectionnez l’abonnement Azure contenant le compte de stockage que vous avez créé. Le compte de stockage peut être dans le même abonnement ou dans un abonnement distinct. Cet exemple suppose que vous avez créé le compte de stockage dans le même abonnement.
   Compte de stockage	asaquickstartstorage	Sélectionnez ou saisissez le nom du compte de stockage. Les noms de compte de stockage sont automatiquement détectés s’ils sont créés dans le même abonnement.
   Conteneur	conteneur1	Sélectionnez un conteneur existant que vous avez créé dans votre compte de stockage.
   Modèle de chemin d'accès	sortie	Entrez le nom d’un chemin de fichier qui doit être créé dans le conteneur.

3. Conservez les valeurs par défaut pour les autres options et sélectionnez Enregistrer pour enregistrer les paramètres.

   

Définir la requête de transformation

1. Ouvrez Script.asaql à partir de l’Explorateur de solutions dans Visual Studio.

2. Ajoutez la requête suivante :

   SELECT *
   INTO Output
   FROM Input
   WHERE Temperature > 27
   

Envoyer une requête Stream Analytics sur Azure

1. Dans l’éditeur de requête, sélectionnez Envoyer sur Azure dans l’éditeur de script.

2. Dans la fenêtre Envoyer le travail, sélectionnez Créer un travail Azure Stream Analytics.

3. Entrez un Nom de travail.

4. Sélectionnez l’Abonnement Azure.

5. Choisissez le Groupe de ressources.

6. Conservez la valeur par défaut pour Cluster.

7. Sélectionnez l’Emplacement utilisé au début du Démarrage rapide.

8. Puis, sélectionnez Envoyer.

   

Exécuter le simulateur IoT

1. Ouvrez le simulateur en ligne Azure IoT Raspberry Pi dans un autre onglet ou une nouvelle fenêtre de navigateur.

2. Remplacez l’espace réservé à la ligne 15 par la chaîne de connexion de l’appareil Azure IoT Hub.

3. Sélectionnez Exécuter. La sortie doit indiquer les données de capteur et les messages qui sont envoyés à votre hub IoT.

   

Démarrer la tâche Stream Analytics et observez le résultat

1. Dès lors que votre tâche est créée, sa vue s’ouvre automatiquement. Cliquez sur le bouton à la flèche verte pour commencer la tâche,

   

2. Changez le mode de démarrage de la sortie du projet à JobStartTime et sélectionnez Démarrer.

   

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. Cela peut prendre quelques minutes. Sélectionnez le bouton Actualiser dans la barre d’outils pour actualiser des métriques.

   

4. Pour afficher les résultats, dans le menu Affichage, sélectionnez Cloud Exploreret accédez au compte de stockage dans votre groupe de ressources. Sous Conteneurs d’objets blob, double-cliquez sur container1, puis le chemin du fichier de sortie.

   

Nettoyer les ressources

Lorsque vous n’en avez plus besoin, supprimez le groupe de ressources, le travail de streaming et toutes les ressources associées. La suppression du travail évite la facturation des unités de streaming consommées par le travail. 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. Si vous ne comptez pas continuer à utiliser ce travail, supprimez toutes les ressources créées dans le cadre de ce guide de démarrage rapide en procédant comme suit :

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.
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.

Étapes suivantes

Dans ce guide de démarrage rapide, vous avez déployé un travail Stream Analytics simple à l’aide de Visual Studio. Vous pouvez également déployer des travaux Stream Analytics à l’aide du Portail Azure et de PowerShell.

Pour en savoir plus sur les outils Azure Stream Analytics pour Visual Studio, consultez l’article suivant :