Veiledning: Konfigurer Microsoft Fabric-speiling fra SQL Server

1. For å speile data fra SQL Server 2025 må du ha en medlems- eller administratorrolle i arbeidsområdet ditt når du oppretter en speilet database fra Fabric-portalen. Under opprettelsen gis den administrerte identiteten til SQL Server automatisk "Les og skriv"-tillatelse på den speilede databasen. Brukere med bidragsyterrollen har ikke tillatelsen Reshare som er nødvendig for å fullføre dette trinnet.

   Fra og med SQL Server 2025 er tillatelsene som kreves for Fabric-innlogging:

   • Følgende tillatelser i brukerdatabasen:
     • SELECT
     • ENDRE ETHVERT EKSTERNT SPEIL
     • VIS YTELSESSTATUS FOR DATABASEN
     • VIS SIKKERHETSTILSTAND FOR DATABASEN

2. Koble til din SQL Server-instans ved å bruke et T-SQL-spørringsverktøy som SQL Server Management Studio (SSMS) eller MSSQL-utvidelsen for Visual Studio Code.

3. Koble til master databasen. Opprett en serverpålogging, og tilordne de riktige tillatelsene.

   Viktig!

   For SQL Server-instanser i en Always On-tilgjengelighetsgruppe må innloggingen opprettes i alle SQL Server-instanser. Kontohaveren fabric_login må ha samme SID i hver replikaforekomst.

   • Opprett en SQL-godkjent pålogging med navnet fabric_login. Du kan velge et hvilket som helst navn for denne påloggingen. Angi ditt eget sterke passord. Kjør følgende T-SQL-skript i master databasen:

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

   • Eller logg inn som Microsoft Entra-administrator, og opprett en Microsoft Entra ID-autentisert innlogging fra en eksisterende konto (anbefalt). Kjør følgende T-SQL-skript i master databasen:

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

4. Koble til brukerdatabasen for å speile planen din til Microsoft Fabric. Opprett en databasebruker som er koblet til påloggingen, og gi de nødvendige minimumsrettighetene:

   • For en SQL-godkjent pålogging:

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

   • Eller, for en Microsoft Entra-autentisert innlogging (anbefalt):

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

For SQL Server versjoner 2016-2022 må en administrator være medlem av sysadmin serverrollen for å sette opp CDC. Serverrollen sysadmin er også nødvendig for fremtidig CDC-vedlikehold. Speiling bruker CDC hvis det allerede er aktivert for at databasen og tabellene skal speiles. Følgende steg oppretter fabric_login påloggingen og legg den til i sysadmin-serverrollen for å konfigurere CDC. Hvis CDC allerede eksisterer, trenger du ikke midlertidig å legge til principalen fabric_login i sysadmin serverrollen. Når CDC er konfigurert, krever aktivering av speiling bare CONNECT på servernivå, og SELECT- og CONNECT-tillatelser på databasenivå for å replikere dataene.

1. Koble til din SQL Server-instans ved å bruke et T-SQL-spørringsverktøy som SQL Server Management Studio (SSMS) eller MSSQL-utvidelsen for Visual Studio Code.

2. Koble til master databasen. I dette steget oppretter du en serverpålogging og tildeler de riktige tillatelsene.

   Hvis CDC allerede er aktivert for at databasen og tabellene skal speiles, trenger ikke de fabric_login å være medlem av sysadmin-serverrollen. Hvis CDC ikke allerede er aktivert, må den fabric_login være medlem av sysadmin-serverrollen for å konfigurere CDC.

   Viktig!

   For SQL Server-instanser i en Always On-tilgjengelighetsgruppe må innloggingen opprettes i alle SQL Server-instanser. Gjenta følgende trinn på hver replikaforekomst. Kontohaveren fabric_login må ha samme SID i hver replikaforekomst.

   Du kan velge et hvilket som helst navn for denne påloggingen. Medlemskap i sysadmin-serverrollen til SQL Server 2016-2022-instansen kreves for å aktivere eller deaktivere innsamling av endringsdata.

   • Kjør følgende T-SQL-skript i master databasen for å opprette en SQL-godkjent pålogging med navnet fabric_login. Angi ditt eget sterke passord.

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

   • Eller, logg inn som Microsoft Entra-administrator, og opprett en Microsoft Entra ID-autentisert innlogging fra en eksisterende konto. Kjør følgende T-SQL-skript i master databasen:

   --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. Medlemskap i db_owner databaserollen for kildedatabasen for speiling kreves for å administrere CDC.

   Koble til brukerdatabasen for å speile planen din til Microsoft Fabric. Opprett en databasebruker som er koblet til påloggingen, og gi minimumsrettigheter som er nødvendige.

   • For en SQL-godkjent pålogging:

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

   • Eller, for en Microsoft Entra-autentisert innlogging (anbefalt):

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

4. Når CDC er aktivert, kan du fjerne fabric_login fra sysadmin-serverrollen.

   • For en SQL-godkjent pålogging:

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

   • Eller, for en Microsoft Entra-autentisert innlogging (anbefalt):

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

Koble server til Azure Arc og aktiver administrert identitet

For å konfigurere Fabric Mirroring må du konfigurere Azure Arc for din SQL Server 2025-instans.

1. Hvis ikke allerede, koble serveren til Azure Arc og installer Azure Extension for SQL Server.

   • Følg stegene i Quickstart - Koble hybridmaskinen til Azure Arc-aktiverte servere.
   • Azure-utvidelsen for SQL Server installeres automatisk når du kobler SQL Server-instansen til Azure Arc.
   • For SQL Server-instanser som kjører i en Always On-tilgjengelighetsgruppe, må alle noder være koblet til Azure Arc.

2. Hvis det ikke allerede er konfigurert, bør du konfigurere Managed identity for SQL Server aktivert av Azure Arc, som muliggjør utgående autentisering som er nødvendig for Fabric Mirroring.

3. Koble til din lokale SQL Server 2025-instans. Når du kobler til, velger du Klarer serversertifikat.

4. Vis de administrerte identitetene:

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

   Dette skal returnere 1 rad med riktig client_id og tenant_id. Identity_type skal være «System-tilordnet».

Legg til tillatelser for administrerte identiteter i Microsoft Fabric

Den administrerte identiteten til SQL Server opprettes og gis automatisk tillatelser av Microsoft Fabric.

For SQL Server instanser som kjører i en Always On-tilgjengelighetsgruppe, må imidlertid den systemtildelte managed identity (SAMI) til hver sekundærnode få Contributor tillatelser til Fabric-arbeidsområdet. En administrert identitet opprettes av Azure-utvidelsen for SQL Server når SQL-instansen kobles til Azure Arc, og hver må manuelt få Fabric-tillatelser.

1. Gi Fabric-tillatelser til hver sekundærnodes administrerte identitet i Fabric-portalen.

   1. Velg Administrer tilgang i stoffarbeidsområdet.

      

   2. Velg Legg til personer eller grupper.

   3. I dialogboksen Legg til personer finner du servernavnene for hver node i tilgjengelighetsgruppen.

   4. Gi hvert medlemskap til bidragsyterrollen .

      

Konfigurer den lokale eller virtuelle nettverksdatagatewayen

Sjekk nettverkskravene dine for Fabric for å få tilgang til SQL Server din. Du må installere en lokal datagateway eller lage en virtuell nettverksdatagateway for å speile dataene. Sørg for at nettverket til gateway-maskinen på stedet kan koble til SQL Server instans. For mer informasjon, se Hvordan: Sikre data Microsoft Fabric speilede databaser fra SQL Server.

For å bruke lokal datagateway:

1. Last ned lokal datagateway fra det offisielle Microsoft Download Center.
2. Start installasjonen. Følg instruksjonene i Installer en lokal datagateway.
   • Oppgi e-postadressen for Microsoft-kontoen din.
   • Navn: MyOPDG eller et navn du ønsker.
   • Gjenopprettingsnøkkel: gi en sterk gjenopprettingsnøkkel.

Opprett en speilet SQL Server

1. Åpne Fabric-portalen.
2. Bruk et eksisterende arbeidsområde, eller opprett et nytt arbeidsområde.
3. Gå til Opprett-ruten. Velg Opprett-ikonet.
4. Bla for å velge Speilet SQL Server database.
5. Skriv inn navnet på SQL Server-databasen som skal speiles, og velg deretter Create.

Koble Fabric til din SQL Server-instans

For å aktivere speiling må du koble til SQL Server-instansen fra Fabric for å starte tilkoblingen fra Fabric. Følgende steg veileder deg gjennom prosessen med å opprette tilkoblingen til din SQL Server:

1. Under Nye kilder, velg SQL Server database. Eller velg en eksisterende SQL Server-tilkobling fra OneLake-huben.

2. Hvis du valgte Ny tilkobling, legg inn tilkoblingsdetaljene i den SQL Server instansen.

   • Server: Den fullt kvalifiserte servernavnstien som Fabric bruker for å nå din SQL Server-instans, den samme som du ville brukt for SSMS.

   Tips

   SQL Server instanser i en Always On-tilgjengelighetsgruppe, bruk Always On-lytteren for Server.

   • Database: Skriv inn navnet på din SQL Server.
     • Tilkobling: Opprett ny tilkobling.
     • Tilkoblingsnavn: Et automatisk navn angis. Du kan endre det.
     • Datagateway: Velg datagatewayen du setter opp i henhold til situasjonen din.
     • Godkjenningstype: Velg godkjenningsmetoden, og angi hovedstolen du konfigurerte i Bruk en pålogging og tilordnet databasebruker.
     • Merk av for Bruk kryptert tilkobling .

3. Velg Koble til.

Forbered din SQL Server-instans

1. SQL Server Agent-tjenesten må være i drift. Det anbefales på det sterkeste å konfigurere automatisk oppstart.
2. Endret datahenting (CDC) aktiveres automatisk og konfigureres av Fabric Mirroring for hver ønskede tabell i databasen. Se gjennom kjente problemer og feil med CDC. CDC krever at hver tabell har en primærnøkkel.

Konfigurer den lokale eller virtuelle nettverksdatagatewayen

Sjekk nettverkskravene dine for Fabric for å få tilgang til SQL Server din. Du må installere en lokal datagateway eller lage en virtuell nettverksdatagateway for å speile dataene. Sørg for at datagatewayens nettverk kan koble til den SQL Server instansen. For mer informasjon, se Hvordan: Sikre data Microsoft Fabric speilede databaser fra SQL Server.

For å bruke lokal datagateway:

1. Last ned den lokale datagatewayen, se Laste ned den lokale datagatewayen fra det offisielle Microsoft Download Center.
2. Start installasjonen. Følg instruksjonene i Installer en lokal datagateway.
   • Oppgi e-postadressen for Microsoft-kontoen din.
   • Navn: MyOPDG eller et navn du ønsker.
   • Gjenopprettingsnøkkel: gi en sterk gjenopprettingsnøkkel.

Opprett en speilet SQL Server

1. Åpne Fabric-portalen.
2. Bruk et eksisterende arbeidsområde, eller opprett et nytt arbeidsområde.
3. Gå til Opprett-ruten. Velg Opprett-ikonet.
4. Bla for å velge Speilet SQL Server database.
5. Skriv inn navnet på SQL Server-databasen som skal speiles, og velg deretter Create.

Koble Fabric til din SQL Server-instans

For å aktivere speiling må du koble til SQL Server-instansen fra Fabric for å starte tilkoblingen fra Fabric. Følgende steg veileder deg gjennom prosessen med å opprette tilkoblingen til din SQL Server:

1. Under Nye kilder, velg SQL Server database. Eller velg en eksisterende SQL Server-tilkobling fra OneLake-huben.

2. Hvis du valgte Ny tilkobling, legg inn tilkoblingsdetaljene i den SQL Server instansen.

   • Server: Den fullt kvalifiserte servernavnstien som Fabric bruker for å nå din SQL Server-instans, den samme som du ville brukt for SSMS.

   Tips

   For SQL Server instanser i en Always On-tilgjengelighetsgruppe, bruk Always On-lytteren for Server.

   • Database: Skriv inn navnet på din SQL Server.
     • Tilkobling: Opprett ny tilkobling.
     • Tilkoblingsnavn: Et automatisk navn angis. Du kan endre det.
     • Datagateway: Velg navnet på den lokale datagatewayen du konfigurerte i henhold til scenarioet.
     • Godkjenningstype: Velg godkjenningsmetoden, og angi hovedstolen du konfigurerte i Bruk en pålogging og tilordnet databasebruker.

3. Velg Koble til.

Konfigurere sekundære replikaer av Always On-tilgjengelighetsgrupper

Denne seksjonen er kun nødvendig hvis kildedatabasen for SQL Server-speilingen til Fabric er medlem av en Always On-tilgjengelighetsgruppe.

Hvis kildedatabasen er i en AlwaysOn-tilgjengelighetsgruppe, kreves det flere trinn for å konfigurere de sekundære replikaene. Gjenta disse trinnene for hver sekundære replika for å klargjøre hele tilgjengelighetsgruppen. Hver replika krever at SQL-agentjobber konfigureres slik at CDC fungerer som den skal når replikaen er primær.

1. Failover tilgjengelighetsgruppen til en sekundær replika.

2. Bruk det angitte skriptet til å opprette, hvis de ikke allerede finnes, oppryddings- og registreringsjobber i systemdatabasen msdb til den sekundære replikaforekomsten. Disse jobbene er viktige for å vedlikeholde de historiske dataene som beholdes av CDC.

   I skriptet nedenfor erstatter <YOUR DATABASE NAME> du med navnet på brukerdatabasen som skal speiles. Utfør følgende T-SQL-eksempel på brukerdatabasen:

   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
   

   CDC-jobbene for registrering og opprydding starter umiddelbart og opprettes med standardinnstillinger. For mer informasjon om jobbene, se sys.sp_cdc_add_job (Transact-SQL).

3. Hver jobb kjører på hver tilgjengelighetsgruppereplika som standard, selv om det er en sekundær replika. Dette vil føre til feilmeldinger i loggene ettersom brukerdatabasene på de sekundære replikaene ikke kan skrives. Aktiver de to CDC-jobbene på primære replikaer, og deaktiver dem på sekundære replikaer. Følg veiledningen i Endre datafangst i AlwaysOn-tilgjengelighetsgrupper.