Partager via


Ajouter la CDC Azure Cosmos DB en tant que source dans le hub en temps réel (préversion)

Cet article explique comment ajouter la capture des changements de données Azure Cosmos DB for NoSQL (CDC) en tant que source de l’événement dans le hub Fabric en temps réel.

Le connecteur source de la capture des changements de données (CDC) Azure Cosmos DB vous permet de capturer un instantané des données actuelles dans une base de données Azure Cosmos DB. Le connecteur surveille et enregistre ensuite les modifications futures au niveau des lignes apportées à ces données. Une fois les modifications capturées dans un flux, vous pouvez traiter ces données CDC en temps réel et les envoyer à différentes destinations au sein de Fabric pour un traitement ou une analyse plus approfondis.

Remarque

Le hub en temps réel est actuellement en mode aperçu.

Prérequis

  • Accédez à un espace de travail Premium Fabric avec les autorisations contributeur ou supérieures.
  • Accédez à un compte Azure Cosmos DB for NoSQL et à la base de données.
  • Votre base de données Azure Cosmos DB for NoSQL doit être accessible au public et ne doit pas se trouver derrière un pare-feu ou être sécurisée dans un réseau virtuel.

Obtenir les détails de connexion à partir du portail Azure

Les étiquettes des éléments que vous devez collecter à partir du portail Azure sont affichées dans les étapes suivantes. Vous avez toujours besoin de l’URI de point de terminaison, dans un format tel que https://<account>.<api>.azure.com:<port>/, de la clé primaire et des ID de base de données et d’article pour lesquelles vous souhaitez collecter des données.

Remarque

La CDC Azure Cosmos DB for NoSQL utilise le dernier mode de version du flux de modification d’Azure Cosmos DB. Il capture les modifications apportées aux enregistrements dans la dernière version. Notez que les suppressions ne sont pas capturées avec ce mode.

  1. Sur la page du portail Azure pour votre compte Azure Cosmos DB, sélectionnez Clés sous Paramètres dans le volet de navigation de gauche.

  2. Sur la page Clés, copiez l’URI et les valeurs de clé primaire à utiliser pour configurer la connexion eventstream.

    Capture d’écran de l’URI et de la clé primaire à la page Clés Azure Cosmos DB du portail Azure.

  3. Sur la page de présentation du portail Azure de votre compte Azure Cosmos DB, notez l’ID de base de données et d’article pour lequel vous souhaitez collecter des données.

    Capture d’écran de la liste conteneurs d’un compte d’API NoSQL Azure Cosmos DB.

Obtenir des événements à partir d’une CDC Azure Cosmos DB

Vous pouvez obtenir des événements à partir d’une CDC Azure Cosmos DB dans un hub en temps réel de l’une des façons suivantes :

  • Utilisation de l’expérience Obtenir des événements
  • Utilisation de l’onglet Sources Microsoft

Lancer Obtenir une expérience en matière d’événements

  1. Passez à l’expérience Informations en temps réel dans Microsoft Fabric. Sélectionnez Microsoft Fabric dans la barre de navigation gauche, puis sélectionnez Informations en temps réel.

    Capture d’écran montrant comment basculer vers l’expérience Informations en temps réel.

  2. Sélectionnez Hub en temps réel dans la barre de navigation gauche.

    Capture d’écran montrant comment lancer le hub en temps réel dans Microsoft Fabric.

  3. Dans la page hub en temps réel, sélectionnez + Obtenir des événements dans le coin supérieur droit de la page.

    Capture d’écran montrant la sélection du bouton Obtenir des événements dans le hub en temps réel.

Suivez les instructions de la section Ajouter CDC azure Cosmos DB en tant que source.

Onglet Sources Microsoft

  1. Dans le hub en temps réel, basculez vers l’onglet Sources Microsoft.

  2. Dans la liste déroulante Source, sélectionnez (CDC) Azure Cosmos DB.

  3. Pour l’abonnement, sélectionnez un abonnement Azure qui possède le groupe de ressources avec votre compte Cosmos DB.

  4. Dans Groupe de ressources, sélectionnez un groupe de ressources pour votre compte Cosmos DB.

  5. Pour Région, sélectionnez un emplacement où se trouve votre Cosmos DB.

  6. Maintenant, déplacez la souris sur le nom de la source CDC Cosmos DB que vous souhaitez connecter au hub en temps réel dans la liste des bases de données, puis sélectionnez le bouton Connecter, ou sélectionnez ... (points de suspension), puis le bouton Connecter.

    Capture d’écran montrant l’onglet Sources Microsoft avec des filtres pour afficher la CDC Cosmos DB et le bouton de connexion.

    Pour configurer les informations de connexion, suivez les étapes de la section Ajouter la CDC Azure Cosmos DB en tant que source. Ignorez la première étape de la sélection de CDC Azure Cosmos DB en tant que type de source dans l’Assistant Obtenir les événements.

Ajouter la CDC Azure Cosmos DB en tant que source

  1. À l’écran Sélectionner une source de données, sélectionnez (CDC) Azure Cosmos DB.

    La capture d’écran montre la page Sélectionner une source de données avec la (CDC) Azure Cosmos DB sélectionnée.

  2. Sélectionnez le lien Accéder à la ressource si vous souhaitez accéder au compte Azure Cosmos DB dans le portail Azure.

    Capture d’écran montrant la page Connecter avec le lien ** Accéder à la ressource** en surbrillance.

  3. Sur la page Connecter, sélectionnez Nouvelle connexion.

    Capture d’écran montrant la page Connecter de l’Assistant Obtenir les événements avec le lien ** Nouvelle connexion** en surbrillance.

  4. Dans la section Paramètres de connexion, spécifiez le point de terminaison Cosmos DB. Entrez l’URI ou le point de terminaison de votre compte Cosmos DB que vous avez copié à partir du Portail Azure.

    Capture d’écran montrant la section Paramètres de connexion de la page Nouvelle connexion.

  5. Déroulez les Options avancées et procédez comme suit :

    1. Pour le Nombre de nouvelles tentatives, spécifiez le nombre maximum de fois que le connecteur doit retransmettre une requête à la base de données Cosmos DB si la requête échoue à cause d’une erreur récupérable.

    2. Pour Activer le transfert de la fonction AVERAGE, spécifiez si le connecteur doit transférer la fonction d’agrégation AVG vers la base de données Cosmos DB.

    3. Pour Activer le transfert de la fonction SORT vers plusieurs colonnes, spécifiez si le connecteur doit permettre à plusieurs colonnes d’être transférées vers la base de données Cosmos DB lorsqu’elles sont spécifiées dans la clause ORDER BY de la requête SQL.

      Capture d’écran montrant les options avancées pour configurer le connecteur Azure Cosmos DB.

  6. Faites défiler vers le bas et, dans la section Identifiants de connexion, procédez comme suit :

    1. Sélectionnez une connexion existante et conservez l’option Créer une connexion par défaut.
    2. Pour créer une connexion, entrez les valeurs suivantes :
      1. Pour Nom de connexion, entrez un nom de connexion.

      2. Pour Type d’authentification, sélectionnez Clé de compte.

      3. Pour Clé de compte, entrez la valeur de clé que vous avez enregistrée précédemment.

      4. Sélectionnez Se connecter.

        Capture d’écran montrant la section Identifiants de connexion de la page Nouvelle connexion.

  7. À présent, sur la page Connecter, procédez comme suit :

    1. Spécifiez l’ID de conteneur du conteneur dans votre compte Azure Cosmos DB. 1.

    2. Dans la section Détails du flux à droite, sélectionnez l’Espace de travail Fabric dans lequel vous souhaitez enregistrer le flux d’évènement que l’Assistant va créer.

    3. Pour nom du eventstream, saisissez un nom pour l’eventstream. L’assistant crée un eventstream avec la CDC Azure Cosmos DB sélectionnée comme source.

    4. Le nom du flux est généré automatiquement pour vous en ajoutant -stream au nom de l’eventstream. Vous voyez ce flux sous l’onglet Flux de données du hub en temps réel lorsque l’assistant se termine.

    5. Cliquez sur Suivant.

      Capture d’écran montrant la page Connecter de l’assistant Obtenir les événements renseignée.

  8. À l’écran Vérifier et créer, vérifiez le résumé, puis sélectionnez Créer une source.

    Capture d’écran montrant la page Réviser et créer de l’assistant Obtenir les événements renseignée.

Afficher les détails du flux de données

  1. Sur la page Réviser et créer, si vous sélectionnez Ouvrir un eventstream, l’assistant ouvre l’eventstream qu’il a créé pour vous avec la CDC Azure Cosmos DB sélectionnée comme source. Pour fermer l’assistant, sélectionnez Fermer ou X* dans le coin supérieur droit de la page.

    Capture d’écran montrant la page Réviser et créer après la création réussie de la source.

  2. Dans le hub en temps réel, basculez vers l’onglet Flux de données du hub en temps réel. Actualisez la page. Vous devez voir le flux de données créé pour vous, comme illustré sur l’image suivante.

    Capture d’écran montrant l’onglet Flux de données du hub en temps réel avec le flux que vous venez de créer.

    Pour obtenir des étapes détaillées, consultez Afficher les détails des flux de données dans le hub En temps réel de Fabric.

Pour en savoir plus sur l’utilisation de flux de données, consultez les articles suivants :