Tutoriel : Configurer la mise en miroir Microsoft Fabric à partir de SQL Server

À compter de SQL Server 2025, les autorisations requises pour la connexion Fabric sont les suivantes :

• Autorisations suivantes dans la base de données utilisateur :
  • SELECT
  • MODIFIER TOUT MIROIR EXTERNE
  • AFFICHER L’ÉTAT DES PERFORMANCES DE LA BASE DE DONNÉES
  • AFFICHER L’ÉTAT DE SÉCURITÉ DE LA BASE DE DONNÉES

1. Connectez-vous à votre instance SQL Server à l’aide d’un outil de requête T-SQL tel que SQL Server Management Studio (SSMS) ou l’extension mssql avec Visual Studio Code.

2. Connectez-vous à la base de données master. Créez une connexion au serveur et attribuez les autorisations appropriées.

   Important

   Pour les instances SQL Server dans un groupe de disponibilité Always On, la connexion doit être créée dans toutes les instances SQL Server. Le fabric_login principal doit avoir le même SID dans chaque instance de réplica.

   • Créez une connexion authentifiée SQL nommée fabric_login. Vous pouvez choisir n’importe quel nom pour cette connexion. Fournissez votre propre mot de passe fort. Exécutez le script T-SQL suivant dans la base de données master :

   --Run in the master database
   USE [master];
   CREATE LOGIN [fabric_login] WITH PASSWORD = '<strong password>';
   

   • Vous pouvez également vous connecter en tant qu’administrateur Microsoft Entra et créer une connexion authentifiée par l’ID Microsoft Entra à partir d’un compte existant (recommandé). Exécutez le script T-SQL suivant dans la base de données master :

   --Run in the master database
   USE [master];
   CREATE LOGIN [bob@contoso.com] FROM EXTERNAL PROVIDER;
   

3. Connectez-vous à la base de données utilisateur que vous prévoyez de mettre en miroir à Microsoft Fabric. Créez un utilisateur de base de données connecté à la connexion et accordez les privilèges minimum nécessaires :

   • Pour une connexion authentifiée SQL :

   --Run in the user database
   CREATE USER [fabric_user] FOR LOGIN [fabric_login];
   
   GRANT SELECT, ALTER ANY EXTERNAL MIRROR, VIEW DATABASE PERFORMANCE STATE, VIEW DATABASE SECURITY STATE
      TO [fabric_user];
   

   • Ou, pour une connexion authentifiée Microsoft Entra (recommandé) :

   --Run in the user database
   CREATE USER [bob@contoso.com] FOR LOGIN [bob@contoso.com];
   
   GRANT SELECT, ALTER ANY EXTERNAL MIRROR, VIEW DATABASE PERFORMANCE STATE, VIEW DATABASE SECURITY STATE
      TO [bob@contoso.com];
   

Pour sql Server versions 2016-2022, un administrateur a besoin d’appartenance au rôle serveur sysadmin pour configurer initialement cdc. Toute maintenance future du CDC nécessitera l’appartenance au rôle serveur sysadmin.

Une fois la capture de données modifiées établie, l’activation de la mise en miroir nécessite uniquement les permissions CONNECT au niveau du serveur, et les autorisations SELECT et CONNECT au niveau de la base de données afin de répliquer les données.

1. Connectez-vous à votre instance SQL Server à l’aide d’un outil de requête T-SQL tel que SQL Server Management Studio (SSMS) ou l’extension mssql avec Visual Studio Code.

2. Connectez-vous à la base de données master. Créez une connexion au serveur et attribuez les autorisations appropriées.

   Important

   Pour les instances SQL Server dans un groupe de disponibilité Always On, la connexion doit être créée dans toutes les instances SQL Server. Répétez les étapes suivantes pour chaque instance de réplique. Le fabric_login principal doit avoir le même SID dans chaque instance de réplica.

   Vous pouvez choisir n’importe quel nom pour cette connexion. L’appartenance au rôle serveur sysadmin de l’instance SQL Server 2016-2022 est requise pour activer ou désactiver la capture de données modifiées.

   • Exécutez le script T-SQL suivant dans la master base de données pour créer une connexion authentifiée SQL nommée fabric_login. Fournissez votre propre mot de passe fort.

   --Run in the master database
   USE [master];
   CREATE LOGIN [fabric_login] WITH PASSWORD = '<strong password>';
   GRANT CONNECT SQL TO [fabric_login];
   ALTER SERVER ROLE [sysadmin] ADD MEMBER [fabric_login];
   

   • Vous pouvez également vous connecter en tant qu’administrateur Microsoft Entra et créer une connexion authentifiée par l’ID Microsoft Entra à partir d’un compte existant. Exécutez le script T-SQL suivant dans la base de données master :

   --Run in the master database
   USE [master];
   CREATE LOGIN [bob@contoso.com] FROM EXTERNAL PROVIDER;
   GRANT CONNECT SQL TO [fabric_login];
   ALTER SERVER ROLE [sysadmin] ADD MEMBER [bob@contoso.com];
   

3. L’appartenance au rôle db_owner de la base de données source pour la mise en miroir est nécessaire pour gérer le CDC.

   Connectez-vous à la base de données utilisateur que vous prévoyez de mettre en miroir à Microsoft Fabric. Créez un utilisateur de base de données connecté à la connexion et accordez les privilèges minimum nécessaires.

   • Pour une connexion authentifiée SQL :

   --Run in the user database
   CREATE USER [fabric_user] FOR LOGIN [fabric_login];
   GRANT CONNECT, SELECT TO [fabric_user];
   

   • Ou, pour une connexion authentifiée Microsoft Entra (recommandé) :

   --Run in the user database
   CREATE USER [bob@contoso.com] FOR LOGIN [bob@contoso.com];
   GRANT CONNECT, SELECT TO [fabric_user];
   

4. Une fois la capture de données modifiées activée, vous pouvez supprimer fabric_login du rôle serveur sysadmin.

   • Pour une connexion authentifiée SQL :

   --Run in the master database
   USE [master];
   ALTER SERVER ROLE [sysadmin] DROP MEMBER [fabric_login];
   

   • Ou, pour une connexion authentifiée Microsoft Entra (recommandé) :

   --Run in the master database
   USE [master];
   ALTER SERVER ROLE [sysadmin] DROP MEMBER [bob@contoso.com];
   

Connecter un serveur à Azure Arc et activer l’identité managée

Pour configurer la mise en miroir Fabric, vous devez configurer Azure Arc pour votre instance SQL Server 2025.

1. Si ce n’est déjà fait, connectez le serveur à Azure Arc et installez l’extension Azure pour SQL Server.

   • Suivez les étapes de démarrage rapide - Connecter une machine hybride avec des serveurs avec Azure Arc.
   • L’extension Azure pour SQL Server s’installe automatiquement lorsque vous connectez l’instance SQL Server à Azure Arc.
   • Pour les instances SQL Server s’exécutant dans un groupe de disponibilité Always On, tous les nœuds doivent être connectés à Azure Arc.

2. S’il n’est pas déjà configuré, vous devez configurer l’identité managée pour SQL Server activée par Azure Arc, ce qui active l’authentification sortante nécessaire pour la mise en miroir Fabric.

3. Connectez-vous à votre instance SQL Server 2025 locale. Lorsque vous vous connectez, sélectionnez Certificat de serveur d’approbation.

4. Affichez les identités managées :

   --Run in the master database
   USE [master];
   SELECT *
   FROM sys.dm_server_managed_identities;
   

   Cela doit retourner 1 ligne avec la valeur correcte client_id et tenant_id. Identity_type doit être « Affecté par le système ».

Ajouter des autorisations d’identités managées dans Microsoft Fabric

L'identité managée du SQL Server est créée automatiquement, et ses autorisations sont accordées par Microsoft Fabric.

Toutefois, pour les instances SQL Server exécutées dans un groupe de disponibilité Always On, l’identité managée affectée par le système (SAMI) de chaque nœud secondaire doit disposer des autorisations Contributeur à l’espace de travail Fabric. Une identité managée est créée par l’extension Azure pour SQL Server lorsque l’instance SQL est connectée à Azure Arc, et chacune doit recevoir des autorisations Fabric manuellement.

1. Dans le portail Fabric, accordez des autorisations Fabric à l’identité managée de chaque nœud secondaire.

   1. Dans l’espace de travail Fabric, sélectionnez Gérer l’accès.

      

   2. Sélectionnez Ajouter des personnes ou des groupes.

   3. Dans le dialogue Ajouter des personnes , recherchez les noms de serveurs pour chaque nœud du groupe de disponibilité.

   4. Accordez chaque adhésion au rôle Contributeur.

      

Configurer la passerelle de données de réseau virtuel ou local

Vérifiez la configuration réseau requise pour que Fabric accède à votre serveur SQL Server. Vous devez installer une passerelle de données locale ou créer une passerelle de données de réseau virtuel pour mettre en miroir les données. Vérifiez que le réseau de la machine de passerelle locale peut se connecter à l’instance SQL Server. Pour plus d’informations, consultez Guide pratique pour sécuriser les bases de données mises en miroir Microsoft Fabric à partir de SQL Server.

Pour utiliser la passerelle de données locale :

1. Téléchargez la passerelle de données locale à partir du Centre de téléchargement Microsoft officiel.
2. Démarrez l’installation. Suivez les instructions de l’installation d’une passerelle de données locale.
   • Indiquez votre adresse e-mail de compte Microsoft.
   • Nom : MyOPDG ou tout nom souhaité.
   • Clé de récupération : veuillez fournir une clé de récupération robuste.

Créer un serveur SQL Server mis en miroir

1. Ouvrez le portail Fabric.
2. Utilisez un espace de travail existant ou créez-en un nouveau.
3. Accédez au volet Créer. Sélectionnez l’icône Créer.
4. Faites défiler pour sélectionner la base de données SQL Server mise en miroir.
5. Entrez le nom de votre base de données SQL Server à mettre en miroir, puis sélectionnez Créer.

Connecter Fabric à votre instance SQL Server

Pour activer la mise en miroir, vous devez vous connecter à l’instance SQL Server à partir de Fabric pour lancer la connexion à partir de Fabric. Les étapes suivantes vous guident tout au long du processus de création de la connexion à votre serveur SQL Server :

1. Sous Nouvelles sources, sélectionnez base de données SQL Server. Vous pouvez également sélectionner une connexion SQL Server existante à partir du hub OneLake.

2. Si vous avez sélectionné Nouvelle connexion, entrez les détails de connexion à l’instance SQL Server.

   • Serveur : chemin d’accès complet du nom de serveur utilisé par Fabric pour atteindre votre instance SQL Server, identique à celui que vous utiliseriez pour SSMS.

   Conseil / Astuce

   Les instances SQL Server d’un groupe de disponibilité Always On utilisent l’écouteur Always On pour le serveur.

   • Base de données : entrez le nom de votre serveur SQL Server.
     • Connexion : créez une nouvelle connexion.
     • Nom de connexion : un nom automatique est fourni. Vous pouvez en changer.
     • Passerelle de données : Sélectionnez la passerelle de données que vous configurez en fonction de votre scénario.
     • Type d’authentification : choisissez la méthode d’authentification et indiquez le principal que vous avez configuré dans Utiliser une connexion et un utilisateur de base de données mappé.
     • Cochez la case Utiliser la connexion chiffrée .

3. Sélectionnez Se connecter.

Préparer votre instance SQL Server

1. Le service SQL Server Agent doit être en cours d’exécution. Il est vivement recommandé de configurer le démarrage automatique.
2. La Capture de Données Modifiées (CDC) sera automatiquement activée et configurée par la Mise en Miroir Fabric pour chaque table souhaitée dans votre base de données. Passez en revue les problèmes connus et les erreurs avec cdc. Le CDC exige que chaque table ait une clé primaire.

Configurer la passerelle de données de réseau virtuel ou local

Vérifiez la configuration réseau requise pour que Fabric accède à votre serveur SQL Server. Vous devez installer une passerelle de données locale ou créer une passerelle de données de réseau virtuel pour mettre en miroir les données. Assurez-vous que le réseau de la passerelle de données peut se connecter à l’instance SQL Server. Pour plus d’informations, consultez Guide pratique pour sécuriser les bases de données mises en miroir Microsoft Fabric à partir de SQL Server.

Pour utiliser la passerelle de données locale :

1. Téléchargez la passerelle de données locale, consultez Télécharger la passerelle de données locale à partir du Centre de téléchargement Microsoft officiel.
2. Démarrez l’installation. Suivez les instructions de l’installation d’une passerelle de données locale.
   • Indiquez votre adresse e-mail de compte Microsoft.
   • Nom : MyOPDG ou tout nom souhaité.
   • Clé de récupération : veuillez fournir une clé de récupération robuste.

Créer un serveur SQL Server mis en miroir

1. Ouvrez le portail Fabric.
2. Utilisez un espace de travail existant ou créez-en un nouveau.
3. Accédez au volet Créer. Sélectionnez l’icône Créer.
4. Faites défiler pour sélectionner la base de données SQL Server mise en miroir.
5. Entrez le nom de votre base de données SQL Server à mettre en miroir, puis sélectionnez Créer.

Connecter Fabric à votre instance SQL Server

Pour activer la mise en miroir, vous devez vous connecter à l’instance SQL Server à partir de Fabric pour lancer la connexion à partir de Fabric. Les étapes suivantes vous guident tout au long du processus de création de la connexion à votre serveur SQL Server :

1. Sous Nouvelles sources, sélectionnez base de données SQL Server. Vous pouvez également sélectionner une connexion SQL Server existante à partir du hub OneLake.

2. Si vous avez sélectionné Nouvelle connexion, entrez les détails de connexion à l’instance SQL Server.

   • Serveur : chemin d’accès complet du nom de serveur utilisé par Fabric pour atteindre votre instance SQL Server, identique à celui que vous utiliseriez pour SSMS.

   Conseil / Astuce

   Pour les instances SQL Server dans un groupe de disponibilité Always On, utilisez l’écouteur Always On pour Server.

   • Base de données : entrez le nom de votre serveur SQL Server.
     • Connexion : créez une nouvelle connexion.
     • Nom de connexion : un nom automatique est fourni. Vous pouvez en changer.
     • Passerelle de données : Sélectionnez le nom de la passerelle de données locale que vous avez configurée en fonction de votre scénario.
     • Type d’authentification : choisissez la méthode d’authentification et indiquez le principal que vous avez configuré dans Utiliser une connexion et un utilisateur de base de données mappé.

3. Sélectionnez Se connecter.

Configurer des réplicas secondaires des groupes de disponibilité d'Always On

Cette section n’est requise que si la base de données source de la mise en miroir SQL Server vers Fabric est membre d’un groupe de disponibilité Always On.

Si la base de données source se trouve dans un groupe de disponibilité Always On, des étapes supplémentaires sont nécessaires pour configurer les réplicas secondaires. Répétez ces étapes pour chaque réplica secondaire afin de préparer l’ensemble du groupe de disponibilité. Chaque réplica nécessite la configuration des travaux de l’agent SQL afin que la CDC se comporte correctement lorsque le réplica est en tant que principal.

1. Basculez le groupe de disponibilité vers un réplica secondaire.

2. Utilisez le script fourni pour créer, s'ils n'existent pas déjà, des jobs de nettoyage et de capture dans la base de données système de l'instance de réplica secondaire msdb. Ces travaux sont importants pour préserver les données historiques conservées par le CDC.

   Dans le script suivant, remplacez <YOUR DATABASE NAME> par le nom de la base de données utilisateur qui sera mise en miroir. Exécutez l’exemple T-SQL suivant sur la base de données utilisateur :

   DECLARE @db nvarchar(128) = '<YOUR DATABASE NAME>';
   
   DECLARE @capture nvarchar(128) = N'cdc.' + @db + N'_capture';
   DECLARE @cleanup nvarchar(128) = N'cdc.' + @db + N'_cleanup';
   -- Names may differ. Run `SELECT * FROM msdb.dbo.sysjobs WHERE category_id = 13 or category_id = 16` to see if these names exist.
   
    IF NOT EXISTS (SELECT name, job_id FROM msdb.dbo.sysjobs WHERE name = @capture)
    BEGIN
        -- Create the capture job
        EXEC sys.sp_cdc_add_job @job_type = N'capture';
        PRINT 'CDC capture job has been created.';
    END
    ELSE
    BEGIN
        PRINT 'CDC capture job already exists.';
        -- Start capture job is running
        IF NOT EXISTS (SELECT j.name, j.enabled, ja.start_execution_date, ja.stop_execution_date
            FROM msdb.dbo.sysjobs AS j
            LEFT JOIN msdb.dbo.sysjobactivity AS ja ON j.job_id = ja.job_id
            WHERE j.name = @capture and ((ja.start_execution_date IS NOT NULL and ja.stop_execution_date IS NULL)) or j.enabled <> 0)
        BEGIN
            EXEC msdb.dbo.sp_start_job @job_name = @capture;
            PRINT 'CDC capture job started running.';
        END
        ELSE
        BEGIN
            PRINT 'CDC capture job already running.';
        END
    END
   
    IF NOT EXISTS (SELECT name,job_id FROM msdb.dbo.sysjobs WHERE name = @cleanup)
    BEGIN
        -- Create the cleanup job
        EXEC sys.sp_cdc_add_job @job_type = N'cleanup';
        PRINT 'CDC cleanup job has been created.';
    END
    ELSE
    BEGIN
        -- Ensure that the cleanup job is properly scheduled (default schedule)
        IF NOT EXISTS (SELECT j.name, j.enabled, ja.start_execution_date, ja.stop_execution_date
            FROM msdb.dbo.sysjobs AS j
            LEFT JOIN msdb.dbo.sysjobactivity AS ja ON j.job_id = ja.job_id
            WHERE j.name = @cleanup and j.enabled <> 0)
        BEGIN
            EXEC msdb.dbo.sp_update_job @job_name = @cleanup, @enabled = 1;
            PRINT 'CDC cleanup job updated to enabled.';
        END
        ELSE
        BEGIN
            PRINT 'CDC cleanup job already enabled.';
        END
        PRINT 'CDC cleanup job already exists.';
    END
   

   Les travaux de capture et de nettoyage de la CDC démarrent immédiatement et sont créés avec les paramètres par défaut. Pour plus d’informations sur les tâches, consultez sys.sp_cdc_add_job (Transact-SQL).

3. Chaque travail s’exécute par défaut sur chaque réplica de groupe de disponibilité ; même s’il s’agit d’un réplica secondaire. Cela entraîne des messages d’erreur dans les journaux, car les bases de données utilisateur sur les réplicas secondaires ne sont pas accessibles en écriture. Activez les deux tâches CDC sur les réplicas principaux et désactivez-les sur les réplicas secondaires. Suivez les instructions de capture de données de modification sur les groupes de disponibilité Always On.