Partage via

Filtrer et ingérer vers Azure Data Explorer en utilisant l’éditeur nocode Stream Analytics

  • Article

Cet article explique comment utiliser l’éditeur sans code pour créer facilement un travail Stream Analytics. Il lit en continu à partir de vos Event Hubs, filtre les données entrantes, puis écrit les résultats en continu dans Azure Data Explorer.

Prérequis

  • Vos ressources Azure Event Hubs et de base de données Azure Data Explorer 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.
  • Les données de votre instance d’Event Hubs doivent être sérialisées au format JSON, CSV ou Avro.

Développer un travail Stream Analytics pour filtrer et ingérer des données en temps réel

  1. Sur le portail Azure, recherchez et sélectionnez l’instance Azure Event Hubs.

  2. Sélectionnez Fonctionnalités>Traiter les données, puis Démarrer sur la carte Filtrer et stocker des données dans Azure Data Explorer.

    Capture d’écran montrant le filtre et l’ingestion dans la carte Azure Data Lake Storage Gen2 où vous sélectionnez Démarrer.

  3. Saisissez un nom pour le travail Stream Analytics, puis sélectionnez Créer.

    Capture d’écran montrant où saisir le nom d’un travail.

  4. Spécifiez le type de sérialisation de vos données dans la fenêtre Event Hubs et la méthode d’authentification que le travail utilisera pour se connecter aux Event Hubs. Sélectionnez Connecter.
    Capture d’écran montrant la configuration de la connexion à Event Hubs.

  5. Lorsque la connexion est établie avec succès et que vous disposez de flux de données qui circulent dans votre instance Event Hubs, vous verrez immédiatement deux éléments :

    • 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 supprimer, renommer ou modifier son type.
      Capture d’écran montrant la liste des champs Event Hubs dans laquelle vous pouvez supprimer, renommer ou modifier le type de champ.
    • Exemple dynamique de données entrantes dans la table d’aperçu des données sous la vue diagramme. Il s’actualise automatiquement à 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 Filtrer pour agréger les données. Dans la zone Filtre, sélectionnez un champ pour filtrer les données entrantes avec une condition.

    Capture d’écran montrant la configuration de l’opérateur de filtre.

  7. Sélectionnez la vignette Gérer. Dans le panneau de configuration Gérer les champs, choisissez les champs que vous souhaitez obtenir dans le hub d’événements. Si vous souhaitez ajouter tous les champs, sélectionnez Ajouter tous les champs.

    Capture d’écran montrant la configuration de l’opérateur de champ Gérer.

  8. Sélectionnez la vignette Azure Data Explorer. Dans le panneau de configuration, renseignez les paramètres nécessaires et connectez-vous.

    Notes

    La table doit exister dans votre base de données sélectionnée, et le schéma de table doit correspondre exactement au nombre et aux types de champs que votre aperçu de données génère.

    Capture d’écran montrant la configuration de sortie Kusto.

  9. Si vous le souhaitez, sélectionnez Obtenir l’aperçu statique/Actualiser la préversion statique pour afficher la préversion des données qui sera ingérée dans le hub d’événements.
    Capture d’écran montrant l’option Obtenir l’aperçu statique/Actualiser la préversion statique.

  10. Sélectionnez Enregistrer, puis Démarrer le travail Stream Analytics.
    Capture d’écran montrant les options Enregistrer et Démarrer.

  11. Pour démarrer le travail, spécifiez :

    • Le nombre d’unités de streaming (SU) avec lesquelles le travail est exécuté. Les SU représentent les capacités de calcul et de mémoire allouées au travail. Nous vous recommandons de commencer par trois, puis d’ajuster selon les besoins.
    • Gestion des erreurs de données de sortie : elle vous permet de spécifier le comportement souhaité lorsque la sortie d’un travail vers votre destination échoue en raison d’erreurs de données. Par défaut, votre travail réessaie jusqu’à ce que l’opération d’écriture aboutisse. Vous pouvez également choisir de supprimer de tels événements de sortie.
      Capture d’écran montrant les options pour Démarrer le travail Stream Analytics dans lesquelles vous pouvez modifier l’heure de sortie, définir le nombre d’unités de diffusion en continu et sélectionner les options de gestion des erreurs de données de sortie.

  12. Une fois que vous avez sélectionné Démarrer, le travail commence à s’exécuter dans les deux minutes, et les métriques s’ouvrent dans la section d’onglet en-dessous.

    Capture d’écran montrant les données des métriques du travail après son démarrage.

    Vous pouvez également voir le travail sous la section Traiter les données de l’onglet Travaux Stream Analytics. Sélectionnez Ouvrir les métriques pour surveiller le travail ou l’arrêter et le redémarrer, selon les besoins.

    Capture d’écran de l’onglet Travaux Stream Analytics dans lequel vous affichez l’état des travaux en cours d’exécution.

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

En savoir plus sur Azure Stream Analytics et sur la surveillance du travail que vous avez créé.