Partager via


Ajouter SQL Server sur la source CDC de la base de données de machine virtuelle à un Eventstream

Cet article vous montre comment ajouter une source SQL Server pour Capture de Données Modifiées (CDC) sur une base de données de machine virtuelle à un flux d’événements.

Le connecteur source SQL Server on VM DB (CDC) pour les flux d'événements Fabric vous permet de capturer un instantané des données actuelles d'une base de données SQL Server on VM. Actuellement, SQL Server sur la base de données de machine virtuelle (CDC) est pris en charge à partir des services suivants où les bases de données sont accessibles publiquement :

Remarque

AWS RDS SQL Server, AWS RDS Custom SQL Server et Google Cloud SQL Server ne prennent pas en charge la version Express. Vérifiez que vous utilisez une édition appropriée de SQL Server pour cdc.

Une fois que la source SQL Server sur la base de données de machine virtuelle (CDC) est ajoutée au flux d’événements, elle surveille et enregistre les futures modifications au niveau des lignes, qui peuvent ensuite être traitées en temps réel et envoyées à différentes destinations pour une analyse plus approfondie.

Prérequis

  • Accès à un espace de travail en mode licence de capacité Fabric ou en mode licence d’évaluation avec des autorisations Contributeur ou supérieures.
  • SQL Server en cours d’exécution sur la base de données de machine virtuelle.
  • Votre SQL Server sur la base de données de machine virtuelle doit être configuré pour autoriser l’accès public.
  • Activez la capture des changements de données dans votre SQL Server sur la base de données de machine virtuelle en exécutant la procédure stockée sys.sp_cdc_enable_db. Pour plus d’informations, consultez Activation et désactivation de la capture des changements de données.

Activer CDC dans votre SQL Server sur la base de données de machine virtuelle

  1. Activez la capture des changements de données pour la base de données.

    EXEC sys.sp_cdc_enable_db; 
    
  2. Activez la capture des changements de données pour une table à l’aide d’une option de rôle de gestion. Dans cet exemple, MyTable est le nom de la table SQL.

    EXEC sys.sp_cdc_enable_table 
       @source_schema = N'dbo', 
       @source_name   = N'MyTable', 
       @role_name     = NULL 
    GO 
    

    Une fois la requête exécutée, vous avez activé la capture des changements de données dans votre SQL Server sur la base de données de machine virtuelle.

    Capture d’écran de CDC activée.

Ajouter SQL Server sur une base de données de machine virtuelle en tant que source

  1. Dans l'intelligence en temps réel de Fabric, sélectionnez Eventstream pour créer un nouveau Eventstream.

    Capture d’écran de la création d'un nouveau flux d'événements.

  2. Dans l’écran suivant, sélectionnez Ajouter une source externe.

    Capture d’écran de la sélection Ajouter une source externe.

Configurer et se connecter à SQL Server sur une base de données de machine virtuelle

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

    Capture d’écran montrant la sélection du lien Nouvelle connexion sur la page Se connecter.

  2. Dans la section Paramètres de connexion, entrez les valeurs suivantes pour votre SQL Server sur une machine virtuelle :

    • Serveur : entrez l’adresse IP accessible publiquement ou le nom de domaine de votre machine virtuelle, puis ajoutez deux points et le port. Par exemple, si votre adresse IP est xx.xxx.xxx.xxx et le port est 1433, vous devez entrer xx.xxx.xxx.xxx:1433 dans le champ Serveur. Si le port n’est pas spécifié, la valeur de port par défaut 1433 est utilisée.

    • Base de données : entrez le nom de la base de données à laquelle vous souhaitez vous connecter sur votre serveur SQL Server sur la machine virtuelle.

      Capture d’écran montrant la sélection du lien Nouvelle connexion sur la page Connexion.

  3. Faites défiler vers le bas et, dans la section Identifiants de connexion, suivez les étapes suivantes :

    • Dans le champ Nom de la connexion, saisissez un nom pour la connexion.

    • Pour le type d’authentification, sélectionnez De base.

      Remarque

      Actuellement, les Eventstreams Fabric prennent uniquement en charge l’authentification de base.

    • Entrez Nom d’utilisateur et Mot de passe pour le SQL Server sur machine virtuelle.

      Remarque

      Ne sélectionnez pas l’option : Utilisez la connexion chiffrée.

      Capture d’écran montrant la section Informations d’identification de connexion de la page Se connecter.

  4. Sélectionnez Connecter au bas de la page.

  5. À présent, dans la page Connexion , sélectionnez Toutes les tables ou Entrez le ou les noms de table. Si vous sélectionnez ce dernier, spécifiez des tables à l’aide d’une liste séparée par des virgules d’identificateurs de table complets (schemaName.tableName) ou d’expressions régulières valides. Par exemple:

    • Permet dbo.test.* de sélectionner toutes les tables dont les noms commencent par dbo.test.
    • Permet dbo\.(test1|test2) de sélectionner dbo.test1 et dbo.test2.

    Vous pouvez combiner les deux formats à l’aide de virgules. La limite de caractères totale de l’entrée entière est de 102 400 caractères.

  6. Vous pouvez développer les paramètres avancés pour configurer le mode de gestion décimal, qui spécifie comment le connecteur gère les valeurs des colonnes représentées par DECIMAL et NUMERIC.

    • Precise: représente des valeurs utilisant des types décimaux exacts (par exemple, Java BigDecimal) pour garantir une précision et une précision complètes dans la représentation des données.
    • Double: convertit les valeurs en nombres à virgule flottante de double précision. Cela améliore la facilité d’utilisation et les performances, mais peut entraîner une perte de précision.
    • String: encode les valeurs sous forme de chaînes mises en forme. Cela facilite leur consommation dans les systèmes en aval, mais perd des informations sémantiques sur le type numérique d’origine.
  7. Cliquez sur Suivant.

    Capture d’écran montrant la sélection de l’option Toutes les tables.

  8. Dans l’écran Vérifier + créer, vérifiez le résumé, puis sélectionnez Se connecter.

    Capture d’écran montrant la sélection du bouton Ajouter.

Afficher l’Eventstream mis à jour

Vous pouvez afficher le SQL Server sur la source CDC de la base de données de machine virtuelle ajouté à votre Eventstream en mode Édition.

Capture d’écran du SQL Server sur la source CDC de la base de données de machine virtuelle ajouté en mode Édition avec le bouton Publier mis en surbrillance.

Pour implémenter ce nouveau SQL Server sur la source CDC de la base de données de machine virtuelle, sélectionnez Publier. Une fois ces étapes terminées, votre SQL Server sur la source CDC de la base de données de machine virtuelle est disponible en visualisation dans Affichage en direct.

Capture d’écran du SQL Server sur la source CDC de la base de données de machine virtuelle ajouté en mode Affichage en direct.

Autres connecteurs :