Ajouter une source Azure Cosmos DB CDC à un Eventstream (préversion)

Article
06/19/2024

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.

Important

Les fonctionnalités améliorées des Eventstreams Fabric sont actuellement en préversion.

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é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.

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.
Sur la page Clés, copiez l’URI et les valeurs de clé primaire à utiliser pour configurer la connexion eventstream.
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.

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

Dans l'intelligence en temps réel de Fabric, sélectionnez Eventstream pour créer un nouveau Eventstream. Vérifiez que l’option Fonctionnalités améliorées (préversion) est activée.
Dans l’écran suivant, sélectionnez Ajouter une source externe.

Configurer et se connecter à Azure Cosmos DB (CDC)

Dans l’écran Sélectionner une source de données, sélectionnez Azure Cosmos DB (CDC).
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.
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.
Sélectionnez Se connecter.
Fournissez les informations suivantes pour vos ressources Azure Cosmos DB :
- 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.
Cliquez sur Suivant.
Passez le résumé en revue et sélectionnez Ajouter.