Démarrage rapide : Créer un travail Azure Stream Analytics à l’aide de Visual Studio

Ce guide de démarrage rapide vous montre comment créer et exécuter un travail Stream Analytics à l’aide des outils Azure Stream Analytics pour Visual Studio. L’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 lorsque la température est supérieure à 27° et écrit les événements en résultant dans un nouveau fichier dans le stockage 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 Entreprise (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 Stream Analytics Tools 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 sont ensuite configurées comme entrée de travail. Pour préparer les données d’entrée requises par le travail, procédez comme suit :

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
   Subscription	<Votre abonnement>	Sélectionnez l’abonnement Azure que vous souhaitez utiliser.
   groupe de ressources	asaquickstart-resourcegroup	Sélectionnez Créer nouveau et entrez un nouveau nom de groupe de ressources pour votre compte.
   Nom d’IoT Hub	MyASAIoTHub	Sélectionnez un nom pour votre IoT Hub.
   Région	<Sélectionnez la région la plus proche de vos utilisateurs>	Sélectionnez un emplacement géographique où vous pouvez héberger votre IoT Hub. Utilisez l’emplacement le plus proche de vos utilisateurs.
   Niveau	Libre	Pour ce guide de 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 d’IoT Hub.

   

4. Sélectionnez Vérifier + créer. Passez en revue vos informations IoT Hub, puis sélectionnez Créer. Votre IoT Hub peut prendre quelques minutes pour créer. Vous pouvez surveiller la progression dans le volet Notifications .

5. Une fois le déploiement terminé, sélectionnez Accéder à la ressource pour accéder à la page IoT Hub de votre hub IoT.

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

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

   

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

   

9. Une fois l’appareil créé, ouvrez l’appareil à partir de la liste des 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 l’utiliser ultérieurement.

Créer un stockage d’objets blob

1. Dans le coin supérieur gauche du portail Azure, sélectionnez Créer un>>.

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

   

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

   

4. Dans la page du service Blob , sélectionnez + Conteneur dans la barre d’outils.

5. Dans la page Nouveau conteneur , entrez un nom pour votre conteneur, tel que container1. Laissez le niveau d’accès public en tant qu’accès privé (pas d’accès anonyme) et sélectionnez Créer.

   

Créer un projet Stream Analytics

1. Démarrez Visual Studio.

2. Sélectionnez Nouveau projet de fichier>.

3. Dans la liste des modèles à gauche, sélectionnez Stream Analytics, puis l’application Azure Stream Analytics.

4. Entrez le nom du projet, l’emplacement et le nom de la solution, puis sélectionnez Créer.

   

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

   

Choisir l’abonnement requis

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

Définir une entrée

1. Dans l’Explorateur de solutions, développez le nœud Entrées et double-cliquez surInput.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	Input	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.
   Origine	IoT Hub	Choisissez la source d’entrée appropriée.
   Resource	Choisir une source de données à partir du compte actuel	Choisissez d’entrer manuellement des données ou de sélectionner un compte existant.
   Subscription	<Votre abonnement>	Sélectionnez l’abonnement Azure avec l’IoT Hub que vous avez créé.
   IoT Hub	MyASAIoTHub	Choisissez ou entrez le nom de votre IoT Hub. Les noms IoT Hub sont détectés automatiquement s’ils sont créés dans le même abonnement.

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

   

Définir la sortie

1. Dans l'Explorateur de solutions, étendre le nœud Sorties et double-cliquer 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.
   Éviers	Data Lake Storage Gen 2/Stockage Blob	Sélectionnez le bon récepteur.
   Resource	Fournir manuellement les paramètres de source de données	Choisissez d’entrer manuellement des données ou de sélectionner un compte existant.
   Subscription	<Votre abonnement>	Sélectionnez l’abonnement Azure avec le compte de stockage que vous avez créé. Le compte de stockage peut se trouver dans le même abonnement ou dans un autre abonnement. Cet exemple part du principe que vous avez créé un compte de stockage dans le même abonnement.
   Compte de stockage	asaquickstartstorage	Choisissez ou entrez 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	container1	Sélectionnez le conteneur existant que vous avez créé dans votre compte de stockage.
   Modèle de chemin	output	Entrez le nom d’un chemin d’accès de fichier à créer dans le conteneur.

3. Conservez d’autres options aux valeurs par défaut 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 à Azure

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

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

3. Entrez un nom de travail.

4. Choisissez l’abonnement Azure.

5. Choisissez le groupe de ressources.

6. Conservez la valeur par défaut du cluster.

7. Sélectionnez l’emplacement que vous avez utilisé au début du démarrage rapide.

8. Ensuite, sélectionnez Envoyer.

   

Exécuter le simulateur IoT

1. Ouvrez le simulateur Azure IoT Online Raspberry Pi dans un nouvel onglet ou 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 le travail Stream Analytics et vérifier la sortie

1. Une fois votre travail créé, l’affichage des travaux s’ouvre automatiquement. Sélectionnez le bouton flèche verte pour démarrer le travail,

   

2. Remplacez le mode de démarrage de la sortie du travail par JobStartTime , puis sélectionnez Démarrer.

   

3. Notez que l’état du travail a changé en cours d’exécution et qu’il existe des événements d’entrée/sortie. Cela peut prendre quelques minutes. Sélectionnez le bouton Actualiser dans la barre d’outils pour actualiser les métriques.

   

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

   

Nettoyer les ressources

Quand vous n’en avez plus besoin, supprimez le groupe de ressources, la tâche de diffusion en continu et toutes les ressources associées. La suppression du travail évite la facturation des unités de diffusion en continu consommées par le travail. Si vous envisagez d’utiliser le travail ultérieurement, vous pouvez l’arrêter et le redémarrer ultérieurement lorsque vous en avez besoin. Si vous ne souhaitez pas continuer à utiliser ce travail, supprimez toutes les ressources créées par ce guide de démarrage rapide en procédant comme suit :

1. Dans le menu de gauche du portail Azure, sélectionnez Groupes de ressources , puis sélectionnez le nom de la ressource que vous avez créée.
2. Dans la page de votre groupe de ressources, sélectionnez Supprimer, tapez 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, passez à l’article suivant :