Partage via

Capturer des données à partir d’Event Hubs au format Parquet

  • Article

Cet article explique comment utiliser l’éditeur sans code pour capturer automatiquement des données de streaming dans Event Hubs dans un compte Azure Data Lake Storage Gen2 au format Parquet.

Prérequis

  • Un espace de noms Azure Event Hubs avec un hub d’événements et un compte Azure Data Lake Storage Gen2 avec un conteneur pour stocker les données capturées. Ces ressources doivent être accessibles publiquement et ne peuvent pas résider derrière un pare-feu ou être sécurisées dans un réseau virtuel Azure.

    Si vous n’avez pas de hub d’événements, créez-en un en suivant les instructions dans Démarrage rapide : Créer un hub d’événements.

    Si vous n’avez pas de compte Data Lake Storage Gen2, créez-en un en suivant les instructions dans Créer un compte de stockage

  • Les données de votre Event Hubs doivent être sérialisées au format JSON, CSV ou Avro. À des fins de test, sélectionnez Générer des données (préversion) dans le menu de gauche, sélectionnez Données de stock pour le jeu de données, puis sélectionnez Envoyer.

    Capture d’écran montrant la page Générer des données pour générer des exemples de données de stock.

Configurer un travail pour capturer des données

Procédez comme suit pour configurer un travail Stream Analytics pour capturer des données dans Azure Data Lake Storage Gen2.

  1. Dans le portail Azure, accédez à votre hub d’événements.

  2. Dans le menu de gauche, sélectionnez Traiter les données sous Fonctionnalités. Puis, sélectionnez Démarrer sur la carte Capturer des données dans ADLS Gen2 au format Parquet.

    Capture d’écran montrant les options de démarrage pour le traitement des données Event Hubs.

  3. Saisissez un nom pour votre tâche Stream Analytics, puis sélectionnez Créer.

    Capture d’écran montrant la fenêtre Nouveau travail Stream Analytics dans laquelle vous entrez le nom du travail.

  4. Spécifiez le type de Sérialisation de vos données dans Event Hubs et la méthode d’authentification que la tâche utilise pour se connecter aux Event Hubs. Sélectionnez Connecter.

    Capture d’écran montrant la configuration de la connexion à Event Hubs.

  5. Une fois la connexion établie, vous pouvez voir :

    • Champs présents dans les données d’entrée. Vous pouvez choisir Ajouter un champ ou sélectionner le symbole trois points en regard d’un champ pour éventuellement supprimer, renommer ou modifier son nom.

    • Exemple dynamique de données entrantes dans la table d’aperçu des données sous la vue diagramme. Il s’actualise à intervalles réguliers. Vous pouvez sélectionner Suspendre la préversion de streaming pour afficher une vue statique des exemples de données d’entrée.

      Capture d’écran montrant des exemples de données sous Aperçu des données.

  6. Sélectionnez la vignette Azure Data Lake Storage Gen2 pour modifier la configuration.

  7. Dans la page de configuration Azure Data Lake Storage Gen2, effectuez ces étapes :

    1. Sélectionnez l’abonnement, le nom du compte de stockage et le conteneur dans le menu déroulant.

    2. Une fois l’abonnement sélectionné, la méthode d’authentification et la clé de compte de stockage doivent être renseignées automatiquement.

    3. Sélectionnez Parquet pour le format Sérialisation.

      Capture d’écran montrant la page de configuration de Data Lake Storage Gen2.

    4. Pour les objets blob de streaming, le modèle de chemin de répertoire est censé être une valeur dynamique. Il est requis pour que la date fasse partie du chemin de fichier de l’objet blob, avec la référence {date}. Pour en savoir plus sur les modèles de chemin d’accès personnalisés, consultez Partitionnement personnalisé de la sortie des objets blob Azure Stream Analytics.

      Première capture d’écran montrant la fenêtre Objet blob dans laquelle vous modifiez la configuration de la connexion d’un objet blob.

    5. Sélectionnez Se connecter.

  8. Une fois la connexion établie, vous pouvez voir les champs présents dans les données de sortie.

  9. Sélectionnez Enregistrer dans la barre de commandes pour enregistrer votre configuration.

    Capture d’écran montrant le bouton Enregistrer sélectionné sur la barre de commande.

  10. Sélectionnez Démarrer dans la barre de commandes pour démarrer le flux de streaming et capturer des données. Ensuite, dans la fenêtre Démarrer le travail Stream Analytics :

    1. Sélectionnez l’heure de début de sortie.

    2. Sélectionnez le niveau tarifaire.

    3. Sélectionnez le nombre d’unités de streaming (SU) avec laquelle le travail s’exécute. Les SU représentent les ressources de calcul allouées pour exécuter un travail Stream Analytics. Pour plus d’informations, voir Unités de streaming dans Azure Stream Analytics.

      Capture d’écran montrant la fenêtre Démarrer le travail Stream Analytics dans laquelle vous définissez l’heure de début de la sortie, les unités de streaming et la gestion des erreurs.

  11. Vous devriez voir la tâche Stream Analytics sous l’onglet Tâche Stream Analytics de la page Traiter les données de votre hub d’événements.

    Capture d’écran montrant la tâche Stream Analytics dans la page Traiter les données.

Vérifier la sortie

  1. Dans la page d’instance Event Hubs pour votre hub d’événements, sélectionnez Générer des données, sélectionnez Données de stock pour jeu de données, puis sélectionnez Envoyer pour envoyer des exemples de données au hub d’événements.

  2. Vérifiez que les fichiers Parquet sont générés dans le conteneur Azure Data Lake Storage.

    Capture d’écran montrant les fichiers Parquet générés dans le conteneur Azure Data Lake Storage.

  3. Sélectionnez Traiter des données dans le menu de gauche. Basculez sur l’onglet Tâches Stream Analytics. Sélectionnez Ouvrir les métriques pour les surveiller.

    Capture d’écran montrant le lien Ouvrir les métriques sélectionné.

    Voici un exemple de capture d’écran des métriques montrant les événements d’entrée et de sortie.

    Capture d’écran montrant les métriques du travail Stream Analytics.

Considérations relatives à l’utilisation de la fonctionnalité de géo Event Hubs

Azure Event Hubs a récemment lancé la fonctionnalité géo en préversion publique. Cette fonctionnalité est différente de la fonctionnalité récupération d’urgence géo d’Azure Event Hubs.

Lorsque le type de basculement est Forcé et que la cohérence de la réplication est Asynchrone, le travail Stream Analytics ne garantit pas exactement une sortie vers une sortie Azure Event Hubs.

Azure Stream Analytics, comme producteur avec un hub d’événements en tant que sortie, peut observer un retard de filigrane sur le travail pendant la durée de basculement et pendant la limitation par Event Hubs au cas où le décalage de réplication entre le serveur principal et le serveur secondaire atteint la limite maximale configurée de décalage.

Azure Stream Analytics, comme consommateur avec Event Hubs en tant qu’entrée, peut observer un délai de filigrane sur le travail pendant la durée de basculement et peut ignorer les données ou rechercher des données dupliquées une fois le basculement terminé.

En raison de ces avertissements, nous vous recommandons de redémarrer le travail Stream Analytics avec l’heure de début appropriée juste après la fin du basculement d’Event Hubs. En outre, étant donné que la fonctionnalité géo d’Event Hubs est en préversion publique, nous vous déconseillons d’utiliser ce modèle pour les travaux Stream Analytics de production à ce stade. Le comportement actuel de Stream Analytics s’améliore avant que la fonctionnalité de géo d’Event Hubs soit généralement disponible et puisse être utilisée dans des travaux de production Stream Analytics.

Étapes suivantes

Maintenant, vous savez comment utiliser l’éditeur no code Stream Analytics pour créer un travail qui capture les données Event Hubs dans Azure Data Lake Storage Gen2 au format Parquet. Ensuite, vous pouvez en savoir plus sur Azure Stream Analytics et comment surveiller le travail que vous avez créé.