Partager via

Ajouter une source Azure Cosmos DB CDC à un Eventstream

  • Article

Cet article vous montre comment ajouter une source de capture des changements de données Azure Cosmos DB (Azure Cosmos DB for NoSQL) à un Eventstream.

Le connecteur source de la capture des changements de données (CDC) d’Azure Cosmos DB pour les Eventstreams Microsoft Fabric 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 le Eventstreams, 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

Cette source n'est pas prise en charge dans les régions suivantes de votre espace de travail : Ouest US3, Suisse Ouest.

Prérequis

  • Accès à un espace de travail en mode licence de capacité Fabric ou en mode licence d’évaluation avec des autorisations Collaborateur 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.
  • Si vous n’avez pas de flux d’événements, créez un flux d’événements.

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.

Remarque

Le nombre maximal de sources et de destinations pour un flux d’événements est de 11.

Ajouter Azure Cosmos DB (CDC) en tant que source

Si vous n’avez pas encore ajouté de source à votre flux d’événements, sélectionnez la vignette Utiliser une source externe.

Capture d’écran montrant la sélection de la vignette Utiliser une source externe.

Si vous ajoutez la source à un flux d’événements déjà publié, basculez vers le mode Édition, sélectionnez Ajouter une source dans le ruban, puis sélectionnez Sources externes.

Capture d’écran montrant la sélection du menu Ajouter une source à des sources externes.  

Sur la page Sélectionner une source de données, recherchez et sélectionnez Se connecter dans la vignette Azure Event Hubs.

Capture d’écran montrant la sélection d’Azure Cosmos DB (CDC) comme type de source dans l’assistant Sélectionner une source de données.

Configurer et se connecter à Azure Cosmos DB (CDC)

  1. Dans l’écran Connecter, sous Connexion, sélectionnez Nouvelle connexion pour créer une liaison de connexion cloud à votre base de données Azure Cosmos DB.

    Capture d'écran de la page Se connecter avec le lien Nouvelle connexion sélectionné.

  2. Dans l'écran Paramètres de connexion, saisissez les informations suivantes :

    • 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.
    • Nom de connexion : généré automatiquement, ou vous pouvez entrer un nouveau nom pour cette connexion.
    • Clé de compte : entrez la clé primaire de votre compte Azure Cosmos DB que vous avez copié à partir du Portail Azure.

    Capture d’écran des paramètres de connexion pour la source CDC Azure Cosmos DB.

  3. Sélectionnez Connecter.

  4. Fournissez les informations suivantes pour vos ressources Azure Cosmos DB, puis sélectionnez Suivant.

    • ID de conteneur : entrez le nom du conteneur ou de la table Azure Cosmos DB auquel vous souhaitez vous connecter.

    • Base de données : saisissez le nom de votre base de données Azure Cosmos DB.

    • Stratégie de décalage : indiquez s’il faut commencer à lire les décalages les plus anciens ou les derniers décalages s’il n’y a pas de validation.

      Vous pouvez également modifier le nom de la source dans la section Détails du flux à droite en sélectionnant le bouton Crayon.

      Capture d’écran des détails de connexion de la source Azure Cosmos DB CDC.

  5. Dans la page Vérifier + se connecter, passez en revue le résumé, puis sélectionnez Ajouter.

    Capture d’écran montrant la page Vérifier + se connecter pour la source CDC Azure Cosmos DB.

Afficher le flux d’événements mis à jour

  1. Vous voyez la source Azure Cosmos DB (CDC) ajoutée à votre Eventstreams en mode Édition. Sélectionnez Publier pour publier les modifications et commencer la diffusion en continu des données Azure Cosmos DB CDC dans le Eventstreams.

    Capture d’écran de la source Azure Cosmos DB CDC ajoutée en mode Édition avec le bouton Publier mis en surbrillance.

  2. Vous voyez le flux d’événements en mode Direct. Sélectionnez Modifier dans le ruban pour revenir au mode Édition pour mettre à jour le flux d’événements.

    Capture d’écran du Eventstreams publié avec la source Azure Cosmos DB dans l’affichage en direct.

Contenu connexe

Autres connecteurs :