Esercitazione: Configurare il mirroring di Microsoft Fabric da SQL Server

1. Per eseguire il mirroring dei dati da SQL Server 2025, è necessario avere un ruolo membro o amministratore nell'area di lavoro quando si crea un database con mirroring dal portale di Fabric. Durante la creazione, all'identità gestita di SQL Server viene concessa automaticamente l'autorizzazione "Lettura e scrittura" per il database con mirroring. Gli utenti con il ruolo collaboratore non hanno l'autorizzazione di ricondividi necessaria per completare questo passaggio.

   A partire da SQL Server 2025, le autorizzazioni necessarie per l'account di accesso di Fabric sono:

   • Le autorizzazioni seguenti nel database utente:
     • SELECT
     • ALTERARE QUALSIASI SPECCHIO ESTERNO
     • VISUALIZZARE LO STATO DELLE PRESTAZIONI DEL DATABASE
     • VISUALIZZARE LO STATO DI SICUREZZA DEL DATABASE

2. Connettersi all'istanza di SQL Server usando uno strumento di query T-SQL come SQL Server Management Studio (SSMS) o l'estensione MSSQL per Visual Studio Code.

3. Connettersi al database master. Creare un account di accesso al server e assegnare le autorizzazioni appropriate.

   Importante

   Per le istanze di SQL Server in un gruppo di disponibilità Always On, il login deve essere creato in tutte le istanze di SQL Server. L'entità fabric_login deve avere lo stesso SID in ogni istanza di replica.

   • Creare un login autenticato SQL denominato fabric_login. È possibile scegliere qualsiasi nome per questo accesso. Specificare una password complessa. Eseguire il seguente script T-SQL nel database master:

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

   • In alternativa, accedere come amministratore Microsoft Entra e creare un account di accesso autenticato Microsoft Entra ID da un account esistente (scelta consigliata). Eseguire il seguente script T-SQL nel database master:

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

4. Connettersi al database utente di cui eseguire il mirroring per Microsoft Fabric. Creare un utente del database connesso all'account di accesso e concedere i privilegi minimi necessari:

   • Per un accesso autenticato 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];
   

   • In alternativa, per un account di accesso autenticato Microsoft Entra (scelta consigliata):

   --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];
   

Per SQL Server versioni 2016-2022, un amministratore deve essere membro del ruolo del server sysadmin per configurare CDC. Il ruolo del sysadmin server è necessario anche per qualsiasi manutenzione CDC futura. Il mirroring usa CDC se è già abilitato per il mirroring del database e delle tabelle. La procedura seguente consente di creare l'account fabric_login di accesso e aggiungerlo al ruolo del server sysadmin per configurare CDC. Se CDC esiste già, non è necessario aggiungere temporaneamente l'entità fabric_login al ruolo del sysadmin server. Dopo aver configurato CDC, l'abilitazione del mirroring richiede solo CONNECT a livello di server e le autorizzazioni SELECT e CONNECT a livello di database per replicare i dati.

1. Connettersi all'istanza di SQL Server usando uno strumento di query T-SQL come SQL Server Management Studio (SSMS) o l'estensione MSSQL per Visual Studio Code.

2. Connettersi al database master. In questo passaggio si creerà un account di accesso al server e si assegneranno le autorizzazioni appropriate.

   Se CDC è già abilitato per il database e per le tabelle destinate al mirroring, fabric_login non è necessario che sia membro del ruolo del server sysadmin. Se il CDC non è già abilitato, fabric_login deve essere membro del ruolo del server sysadmin per configurare il CDC.

   Importante

   Per le istanze di SQL Server in un gruppo di disponibilità Always On, il login deve essere creato in tutte le istanze di SQL Server. Ripetere i passaggi seguenti in ogni istanza di replica. L'entità fabric_login deve avere lo stesso SID in ogni istanza di replica.

   È possibile scegliere qualsiasi nome per questo accesso. L'appartenenza al ruolo del server sysadmin dell'istanza di SQL Server 2016-2022 è necessaria per enable o disabilitare Change Data Capture.

   • Eseguire lo script T-SQL seguente nel master database per creare un account di accesso autenticato SQL denominato fabric_login. Specificare una password complessa.

   --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];
   

   • In alternativa, accedere come amministratore di Microsoft Entra e creare un account di accesso autenticato Microsoft Entra ID da un account esistente. Eseguire il seguente script T-SQL nel database 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. È necessaria l'appartenenza al ruolo db_owner nel database di origine utilizzato per il mirroring per gestire CDC.

   Connettersi al database utente di cui eseguire il mirroring per Microsoft Fabric. Creare un utente del database connesso all'account di accesso e concedere i privilegi minimi necessari.

   • Per un accesso autenticato SQL:

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

   • In alternativa, per un account di accesso autenticato Microsoft Entra (scelta consigliata):

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

4. Dopo aver abilitato CDC, è possibile rimuovere fabric_login dal ruolo del server sysadmin.

   • Per un accesso autenticato SQL:

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

   • In alternativa, per un account di accesso autenticato Microsoft Entra (scelta consigliata):

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

Connettere il server a Azure Arc e abilitare l'identità gestita

Per configurare il mirroring del fabric, è necessario configurare Azure Arc per l'istanza di SQL Server 2025.

1. Se non è già stato fatto, connettere il server a Azure Arc e installare l'estensione Azure per SQL Server.

   • Seguire i passaggi descritti in Quickstart - Connettere un computer ibrido con server abilitati per Azure Arc.
   • L'estensione Azure per SQL Server viene installata automaticamente quando si connette l'istanza di SQL Server a Azure Arc.
   • Per le istanze di SQL Server che vengono eseguite in un gruppo di disponibilità Always On, tutti i nodi devono essere connessi ad Azure Arc.

2. Se non è già stato configurato, è necessario configurare Identità gestita per SQL Server abilitata da Azure Arc, che abilita l'autenticazione in uscita necessaria per il Mirroring di Fabric.

3. Connettersi all'istanza locale SQL Server 2025. Quando ci si connette, selezionare Considera attendibile il certificato del server.

4. Visualizzare le identità gestite:

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

   Verrà restituita una riga con il valore corretto client_id e tenant_id. Identity_type deve essere "Assegnato dal sistema".

Aggiungere autorizzazioni per le identità gestite in Microsoft Fabric

L'identità gestita del SQL Server viene creata e concessa automaticamente le autorizzazioni da Microsoft Fabric.

Tuttavia, per le istanze di SQL Server in esecuzione in un gruppo di disponibilità Always On, occorre concedere all'identità gestita assegnata dal sistema (SAMI) di ogni nodo secondario le autorizzazioni di Contributor per l'area di lavoro Fabric. Un'identità gestita viene creata dall'estensione di Azure per SQL Server quando l'istanza di SQL è connessa ad Azure Arc e a ciascuna devono essere concesse manualmente le autorizzazioni Fabric.

1. Nel portale Fabric, concedere le autorizzazioni Fabric all'identità gestita di ogni nodo secondario.

   1. Nell'area di lavoro Fabric, selezionare Gestisci accesso.

      

   2. Selezionare Aggiungi persone o gruppi.

   3. Nella finestra di dialogo Aggiungi persone trovare i nomi dei server per ogni nodo nel gruppo di disponibilità.

   4. Concedi ogni adesione al ruolo di Collaboratore.

      

Configurare il gateway dati di rete virtuale o locale

Controllare i requisiti di rete per l'accesso all'SQL Server da parte di Fabric. È necessario installare un gateway dati locale o creare un gateway dati di rete virtuale per eseguire il mirroring dei dati. Assicurarsi che la rete del computer gateway locale possa connettersi all'istanza di SQL Server. Per ulteriori informazioni, vedere Come proteggere i dati nei database Microsoft Fabric con mirroring dai database di SQL Server.

Per usare il gateway dati locale:

1. Scarica il gateway dati locale dal Centro download ufficiale di Microsoft.
2. Avviare l'installazione. Segui le istruzioni in Installare un gateway dati locale.
   • Specificare l'indirizzo di posta elettronica dell'account Microsoft.
   • Nome: MyOPDG o qualsiasi nome desiderato.
   • Chiave di ripristino: fornire una chiave di ripristino avanzata.

Creare un SQL Server replicato

1. Aprire il portale di Fabric.
2. Usare un’area di lavoro esistente, oppure creare una nuova area di lavoro.
3. Passare al riquadro Crea . Selezionare l'icona Crea .
4. Scorrere fino a selezionare Mirrored SQL Server database.
5. Immettere il nome del database SQL Server da eseguire con mirroring, quindi selezionare Crea.

Connettere Fabric all'istanza di SQL Server

Per abilitare il mirroring, è necessario connettersi all'istanza di SQL Server da Fabric per avviare la connessione da Fabric. I passaggi seguenti illustrano il processo di creazione della connessione al SQL Server:

1. In Nuovi origini selezionare SQL Server database. In alternativa, selezionare una connessione SQL Server esistente dall'hub OneLake.

2. Se è stata selezionata Nuova connessione, immettere i dettagli della connessione all'istanza di SQL Server.

   • Server: Il percorso del nome del server completamente qualificato che Fabric utilizza per raggiungere la tua istanza di SQL Server, lo stesso che useresti per SSMS.

   Suggerimento

   Le istanze di SQL Server in un gruppo di disponibilità Always On, usano il listener Always On per Server.

   • Database: immettere il nome del SQL Server.
     • Connessione: creare una nuova connessione.
     • Nome connessione: viene specificato un nome automatico. È possibile modificarlo.
     • Gateway dati: Selezionare il gateway dati configurato in base allo scenario in uso.
     • Tipo di autenticazione: scegliere il metodo di autenticazione e specificare l'entità configurata in Usare un account di accesso e un utente di database mappato.
     • Selezionare la casella di controllo Usa connessione crittografata .

3. Selezionare Connetti.

Preparare l'istanza di SQL Server

1. Il servizio SQL Server Agent deve essere in esecuzione. È consigliabile configurare l'avvio automatico.
2. L'acquisizione delle modifiche dei dati (CDC) verrà abilitata e configurata automaticamente dal mirroring di Fabric per ciascuna tabella desiderata nel tuo database. Esaminare i problemi noti e gli errori con CDC. CDC richiede che ogni tabella abbia una chiave primaria.

Configurare il gateway dati di rete virtuale o locale

Controllare i requisiti di rete per l'accesso all'SQL Server da parte di Fabric. È necessario installare un gateway dati locale o creare un gateway dati di rete virtuale per eseguire il mirroring dei dati. Assicurarsi che la rete del gateway dati possa connettersi all'istanza di SQL Server. Per ulteriori informazioni, consulta Come: Proteggere i dati nei database con mirroring di Microsoft Fabric tramite SQL Server.

Per usare il gateway dati locale:

1. Scaricare il gateway dati locale, vedere Scaricare il gateway dati locale dall'Area download Microsoft ufficiale.
2. Avviare l'installazione. Segui le istruzioni in Installare un gateway dati locale.
   • Specificare l'indirizzo di posta elettronica dell'account Microsoft.
   • Nome: MyOPDG o qualsiasi nome desiderato.
   • Chiave di ripristino: fornire una chiave di ripristino avanzata.

Creare un SQL Server con mirroring

1. Aprire il portale di Fabric.
2. Usare un’area di lavoro esistente, oppure creare una nuova area di lavoro.
3. Passare al riquadro Crea . Selezionare l'icona Crea .
4. Scorrere fino a selezionare Mirrored SQL Server database.
5. Immettere il nome del database SQL Server da eseguire con mirroring, quindi selezionare Crea.

Connettere Fabric all'istanza di SQL Server

Per abilitare il mirroring, è necessario connettersi all'istanza di SQL Server da Fabric per avviare la connessione da Fabric. I passaggi seguenti illustrano il processo di creazione della connessione al SQL Server:

1. In Nuovi origini selezionare SQL Server database. In alternativa, selezionare una connessione SQL Server esistente dall'hub OneLake.

2. Se è stata selezionata Nuova connessione, immettere i dettagli della connessione all'istanza di SQL Server.

   • Server: percorso completo del nome del server usato da Fabric per raggiungere l'istanza di SQL Server, la stessa usata per SSMS.

   Suggerimento

   Per le istanze di SQL Server in un gruppo di disponibilità Always On, usare il listener Always On per Server.

   • Database: immettere il nome del SQL Server.
     • Connessione: creare una nuova connessione.
     • Nome connessione: viene specificato un nome automatico. È possibile modificarlo.
     • Gateway dati: Selezionare il nome del gateway dati locale configurato in base allo scenario in uso.
     • Tipo di autenticazione: scegliere il metodo di autenticazione e specificare l'entità configurata in Usare un account di accesso e un utente di database mappato.

3. Selezionare Connetti.

Configurare repliche secondarie di gruppi di disponibilità AlwaysOn

Questa sezione è necessaria solo se il database di origine per il mirroring SQL Server in Fabric è membro di un gruppo di disponibilità AlwaysOn.

Se il database di origine si trova in un gruppo di disponibilità Always On, sono necessari passaggi aggiuntivi per configurare le repliche secondarie. Ripetere questi passaggi per ogni replica secondaria per preparare l'intero gruppo di disponibilità. Per ogni replica è necessario configurare i processi di SQL Agent in modo che CDC si comporti correttamente quando tale replica è primaria.

1. Eseguire il failover del gruppo di disponibilità in una replica secondaria.

2. Usare lo script fornito per creare, se non esistono già, le attività di pulizia e acquisizione nel database di sistema dell'istanza di replica secondaria msdb. Questi lavori sono importanti per mantenere i dati storici conservati da CDC.

   Nello script seguente sostituire <YOUR DATABASE NAME> con il nome del database utente che verrà sottoposto a mirroring. Eseguire l'esempio T-SQL seguente nel database utente:

   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
   

   I processi CDC di acquisizione e pulizia vengono avviati immediatamente e vengono creati con le impostazioni predefinite. Per ulteriori informazioni sulle attività, vedere sys.sp_cdc_add_job (Transact-SQL).

3. Ogni processo viene eseguito in ogni replica del gruppo di disponibilità per impostazione predefinita, anche se si tratta di una replica secondaria. Ciò causerà messaggi di errore nei log perché i database utente nelle repliche secondarie non sono scrivibili.This will cause error messages in the logs as the user databases on the secondary replicas are not writeable. Abilitare i due processi CDC nelle repliche primarie e disabilitarli nelle repliche secondarie. Seguire le indicazioni in Change Data Capture nei gruppi di disponibilità AlwaysOn.