Tutorial: Configurar o espelhamento de Microsoft Fabric a partir do SQL Server

Espelhamento no Fabric é uma tecnologia SaaS corporativa, baseada em nuvem, sem ETL. Nesta seção, você aprenderá a criar um banco de dados SQL Server espelhado, que cria uma cópia somente leitura e replicada continuamente de seus dados SQL Server no OneLake.

Pré-requisitos

• Instale ou use uma instância SQL Server existente, local ou na nuvem.
  • Como tutorial, recomendamos usar uma cópia de um de seus bancos de dados existentes ou de qualquer banco de dados de teste ou de desenvolvimento existente que você possa recuperar rapidamente de um backup.
• Instale uma ferramenta de consulta T-SQL, como SQL Server Management Studio (SSMS) ou a extensão MSSQL para Visual Studio Code.
• Você precisa de uma capacidade existente do Fabric. Se não tiver uma, inicie uma avaliação do Fabric.
  • A capacidade da Fabric precisa estar ativa e em funcionamento. Uma capacidade pausada ou excluída impede o Fabric Mirroring e nenhum dado é replicado.
• As configurações de locatário do sistema Fabric são necessárias. Verifique se as duas configurações do Locatário do Fabric a seguir estão habilitadas:
  • Entidades de serviço podem usar APIs do Fabric
  • Os usuários podem acessar os dados armazenados no OneLake com aplicativos externos ao Fabric
• Revise as limitações da plataforma em bancos de dados espelhados do Microsoft Fabric a partir do SQL Server.
• Um gateway de dados local (on-premises) ou um gateway de dados de rede virtual na rede de sua instância de SQL Server. A rede do gateway de dados deve se conectar à instância de SQL Server por meio de um endpoint privado ou ser autorizada por uma regra de firewall.

Principal do banco de dados para o Fabric

Em seguida, você precisa criar uma maneira de o serviço fabric se autenticar em sua instância de SQL Server.

Você pode fazer isso com um login e um usuário de banco de dados mapeado.

Usar um login e um usuário mapeado do banco de dados

O Fabric usará um logon dedicado para se conectar à instância de SQL Server de origem.

Siga estas instruções para SQL Server 2025 ou SQL Server 2016-2022 para criar uma credencial de logon e um usuário de banco de dados para espelhamento de banco de dados.

SQL Server 2025

1. Para espelhar dados do SQL Server 2025, você precisa ter uma função de membro ou administrador em seu workspace ao criar um banco de dados espelhado do portal do Fabric. Durante a criação, a identidade gerenciada do SQL Server recebe automaticamente permissão de leitura e gravação no banco de dados espelhado. Os usuários com a função de colaborador não têm a permissão Reshare necessária para concluir esta etapa.

   A partir de SQL Server 2025, as permissões necessárias para o logon do Fabric são:

   • As seguintes permissões no banco de dados do usuário:
     • SELECT
     • ALTERAR QUALQUER ESPELHO EXTERNO
     • EXIBIR O ESTADO DE DESEMPENHO DO BANCO DE DADOS
     • EXIBIR O ESTADO DE SEGURANÇA DO BANCO DE DADOS

2. Conecte-se à instância SQL Server usando uma ferramenta de consulta T-SQL, como SQL Server Management Studio (SSMS) ou a extensão MSSQL para Visual Studio Code.

3. Conecte-se ao banco de dados master. Crie um logon de servidor e atribua permissões corretas.

   Importante

   Para instâncias de SQL Server em um grupo de disponibilidade Always On, o logon deve ser criado em todas as instâncias de SQL Server. O fabric_login principal deve ter o mesmo SID em cada instância de réplica.

   • Crie um logon autenticado SQL denominado fabric_login. Escolha qualquer nome para esse logon. Forneça sua própria senha forte. Execute o seguinte script T-SQL no banco de dados master:

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

   • Ou faça login como administrador do Microsoft Entra e crie um login autenticado com o Microsoft Entra ID de uma conta existente (recomendado). Execute o seguinte script T-SQL no banco de dados master:

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

4. Conecte-se ao banco de dados que você pretende espelhar no Microsoft Fabric. Crie um usuário de banco de dados conectado ao logon e conceda os privilégios mínimos necessários:

   • Para um logon autenticado do 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, para um logon autenticado Microsoft Entra (recomendado):

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

SQL Server 2016-2022

Para SQL Server versões 2016-2022, um administrador deve ser membro da função de servidor sysadmin para configurar o CDC. A sysadmin função de servidor também é necessária para qualquer manutenção futura do CDC. O espelhamento usará CDC se já estiver habilitado para espelhar o banco de dados e as tabelas. As etapas a seguir criam o fabric_login logon e o adicionam à função de servidor sysadmin para configurar o CDC. Se o CDC já existir, você não precisará adicionar temporariamente o principal à função de servidor fabric_login. Depois que o CDC é configurado, habilitar o Espelhamento requer apenas CONNECT no nível do servidor e permissões SELECT e CONNECT no nível do banco de dados para replicar os dados.

1. Conecte-se à instância SQL Server usando uma ferramenta de consulta T-SQL, como SQL Server Management Studio (SSMS) ou a extensão MSSQL para Visual Studio Code.

2. Conecte-se ao banco de dados master. Nesta etapa, você criará um logon do servidor e atribuirá as permissões apropriadas.

   Se o CDC já estiver habilitado para que o banco de dados e as tabelas se espelham, ele fabric_login não precisará ser membro da função de servidor sysadmin. Se o CDC ainda não estiver habilitado, a conta fabric_login deve ser membro da função de servidor sysadmin para configurar o CDC.

   Importante

   Para instâncias do SQL Server em um grupo de disponibilidade Always On, o logon deve ser criado em todas as instâncias do SQL Server. Repita as seguintes etapas em cada instância de réplica. O fabric_login principal deve ter o mesmo SID em cada instância de réplica.

   Escolha qualquer nome para esse logon. A associação à função de servidor sysadmin da instância do SQL Server 2016-2022 é necessária para abilitar ou desabilitar a captura de dados de alteração.

   • Execute o seguinte script T-SQL no banco de dados master para criar um login autenticado do SQL chamado fabric_login. Forneça sua própria senha forte.

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

   • Ou faça login como administrador do Microsoft Entra e crie um login autenticado com Microsoft Entra ID a partir de uma conta existente. Execute o seguinte script T-SQL no banco de dados 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. Para gerenciar o CDC, é necessário ser membro da função de banco de dados db_owner do banco de dados de origem destinado ao espelhamento.

   Conecte-se ao banco de dados do usuário que você pretende espelhar para o Microsoft Fabric. Crie um usuário de banco de dados conectado ao logon e conceda os privilégios mínimos necessários.

   • Para um logon autenticado do SQL:

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

   • Ou, para um logon autenticado Microsoft Entra (recomendado):

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

4. Depois que o CDC estiver habilitado, você poderá remover fabric_login da função de servidor sysadmin.

   • Para um logon autenticado do SQL:

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

   • Ou, para um logon autenticado Microsoft Entra (recomendado):

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

Conecte-se ao seu SQL Server

As instruções e os requisitos para configurar um banco de dados espelhado do Fabric no SQL Server diferem a partir da versão SQL Server 2025.

A partir do SQL Server 2025, um servidor habilitado para Azure Arc faz parte da configuração necessária para a comunicação com o Fabric. Antes do SQL Server 2025, não é necessário usar o Azure Arc, e a replicação é baseada em Captura de Dados de Mudança (CDC).

SQL Server 2025

Conectar o servidor ao Azure Arc e habilitar a identidade gerenciada

Para configurar o Espelhamento de Malha, você precisa configurar Azure Arc para sua instância do SQL Server 2025.

1. Se ainda não estiver, conecte o servidor ao Azure Arc e instale a Extensão Azure para SQL Server.

   • Siga as etapas em Quickstart – Conectar o computador híbrido com servidores habilitados para Azure Arc.
   • A Extensão Azure para SQL Server é instalada automaticamente quando você conecta a instância de SQL Server ao Azure Arc.
   • Para instâncias do SQL Server em execução em um grupo de disponibilidade Always On, todos os nós devem estar conectados ao Azure Arc.

2. Se ainda não estiver configurado, você deverá configurar a identidade gerenciada para SQL Server habilitada pelo Azure Arc, que permite a autenticação de saída necessária para o Fabric Mirroring.

3. Conecte-se à instância local do SQL Server 2025. Quando você se conectar, selecione Certificado do servidor de confiança.

4. Exiba as identidades gerenciadas:

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

   Isso deve retornar 1 linha com o correto client_id e tenant_id. Identity_type deve ser "Atribuído pelo sistema".

Adicionar permissões de identidades gerenciadas em Microsoft Fabric

A identidade gerenciada do SQL Server é criada e as permissões são concedidas automaticamente pelo Microsoft Fabric.

No entanto, para instâncias do SQL Server em execução em um grupo de disponibilidade Always On, a identidade gerenciada atribuída pelo sistema (SAMI) de cada nó secundário precisa receber permissões de Colaborador no workspace do Fabric. Uma identidade gerenciada é criada pela extensão do Azure para SQL Server quando a instância SQL está conectada ao Azure Arc, e cada uma deve receber manualmente as permissões do Fabric.

1. No portal do Fabric, conceda permissões do Fabric à identidade gerenciada de cada nó secundário.

   1. No workspace do Fabric, selecione Gerenciar acesso.

      

   2. Selecione Adicionar pessoas ou grupos.

   3. No diálogo Adicionar pessoas, localize os nomes de servidor para cada nó no grupo de disponibilidade.

   4. Conceda a função de Colaborador a cada membro.

      

Configurar o gateway de dados de rede virtual ou local

Verifique os requisitos de rede do Fabric para acessar o SQL Server. Você precisa instalar um gateway de dados local ou criar um gateway de dados de rede virtual para espelhar os dados. Verifique se a rede do computador de gateway local pode conectar à instância SQL Server. Para obter mais informações, consulte Como: Proteger dados de bancos de dados espelhados do Microsoft Fabric a partir do SQL Server.

Para usar o gateway de dados local:

1. Baixe o gateway de dados local do Centro de Download Oficial da Microsoft.
2. Inicie a instalação. Siga as instruções em Instalar um gateway de dados local.
   • Forneça seu endereço de email de conta da Microsoft.
   • Nome: MyOPDG ou qualquer nome desejado.
   • Chave de recuperação: forneça uma chave de recuperação forte.

Criar um SQL Server espelhado

1. Abra o portal do Fabric.
2. Crie um novo espaço de trabalho ou use um existente.
3. Navegue até o painel Criar. Selecione o ícone Criar.
4. Role para selecionar banco de dados espelhado do SQL Server.
5. Insira o nome do banco de dados SQL Server a ser espelhado e selecione Create.

Conectar o Fabric à instância do SQL Server

Para habilitar o Espelhamento, você precisa se conectar à instância do SQL Server a partir do Fabric para iniciar a conexão pelo Fabric. As etapas a seguir orientam você pelo processo de criação da conexão com seu SQL Server:

1. Em As novas fontes, selecione SQL Server banco de dados. Ou selecione uma conexão SQL Server existente no hub Do OneLake.

2. Se você selecionou A nova conexão, insira os detalhes da conexão para a instância SQL Server.

   • Server: o caminho de nome do servidor totalmente qualificado que o Fabric usa para alcançar sua instância de SQL Server, o mesmo que você usaria para o SSMS.

   Dica

   instâncias de SQL Server em um grupo de disponibilidade Always On, use o listener Always On para Server.

   • Database: insira o nome do SQL Server.
     • Conexão: crie uma nova conexão.
     • Nome da conexão: um nome automático é fornecido. Você pode alterá-lo.
     • Gateway de dados: Selecione o gateway de dados que você configurou de acordo com seu cenário.
     • Tipo de autenticação: escolha o método de autenticação e forneça o usuário principal que você configurou em Usar um logon e usuário de banco de dados mapeado.
     • Selecione a caixa de seleção Usar conexão criptografada .

3. Selecione Conectar.

SQL Server 2016-2022

Preparar sua instância de SQL Server

1. O serviço SQL Server Agent deve estar em execução. É altamente recomendável configurar a Inicialização Automática.
2. O CDC (Captura de Dados Alterados) será habilitado e configurado automaticamente pelo Fabric Mirroring para cada tabela desejada no seu banco de dados. Examine os problemas conhecidos e os erros com CDC. O CDC requer que cada tabela tenha uma chave primária.

Configurar o gateway de dados de rede virtual ou local

Verifique os requisitos de rede do Fabric para acessar o SQL Server. Você precisa instalar um gateway de dados local ou criar um gateway de dados de rede virtual para espelhar os dados. Verifique se a rede do gateway de dados pode conectar à instância SQL Server. Para obter mais informações, consulte Como: Proteger dados de bancos de dados espelhados do Microsoft Fabric a partir do SQL Server.

Para usar o gateway de dados local:

1. Baixe o gateway de dados local. Veja Baixe o gateway de dados local do Centro de Download Oficial da Microsoft.
2. Inicie a instalação. Siga as instruções em Instalar um gateway de dados local.
   • Forneça seu endereço de email de conta da Microsoft.
   • Nome: MyOPDG ou qualquer nome desejado.
   • Chave de recuperação: forneça uma chave de recuperação forte.

Criar um SQL Server espelhado

1. Abra o portal do Fabric.
2. Crie um novo espaço de trabalho ou use um existente.
3. Navegue até o painel Criar. Selecione o ícone Criar.
4. Role para selecionar banco de dados do SQL Server espelhado.
5. Insira o nome do banco de dados SQL Server a ser espelhado e selecione Create.

Conectar o Fabric à instância do SQL Server

Para habilitar o Espelhamento, você precisa se conectar à instância do SQL Server a partir do Fabric para iniciar a conexão pelo Fabric. As etapas a seguir orientam você pelo processo de criação da conexão com seu SQL Server:

1. Em As novas fontes, selecione SQL Server banco de dados. Ou selecione uma conexão SQL Server existente no hub Do OneLake.

2. Se você selecionou A nova conexão, insira os detalhes da conexão para a instância SQL Server.

   • Server: o caminho de nome do servidor totalmente qualificado que o Fabric usa para alcançar sua instância de SQL Server, o mesmo que você usaria para o SSMS.

   Dica

   Para instâncias do SQL Server em um grupo de disponibilidade Always On, use o listener Always On para o Servidor.

   • Database: insira o nome do SQL Server.
     • Conexão: crie uma nova conexão.
     • Nome da conexão: um nome automático é fornecido. Você pode alterá-lo.
     • Gateway de dados: Selecione o nome do gateway de dados local que você configurou de acordo com seu cenário.
     • Tipo de autenticação: escolha o método de autenticação e forneça o usuário principal que você configurou em Usar um logon e usuário de banco de dados mapeado.

3. Selecione Conectar.

Configurar réplicas secundárias de grupos de disponibilidade Always On

Esta seção só será necessária se o banco de dados de origem para a criação de espelhamento do SQL Server no Fabric for membro de um grupo de disponibilidade Always On.

Se o banco de dados de origem estiver em um grupo de disponibilidade Always On, serão necessárias etapas adicionais para configurar as réplicas secundárias. Repita estas etapas para cada réplica secundária a fim de preparar todo o grupo de disponibilidade. Cada réplica requer que as tarefas do SQL Agent sejam configuradas para que o CDC funcione corretamente quando essa réplica estiver como primária.

1. Faça failover do grupo de disponibilidade para uma réplica secundária.

2. Use o script fornecido para criar, caso ainda não existam, trabalhos de limpeza e captura no banco de dados do sistema da instância de msdb réplica secundária. Esses trabalhos são importantes para manter os dados históricos retidos pelo CDC.

   No script a seguir, substitua <YOUR DATABASE NAME> pelo nome do banco de dados do usuário que será espelhado. Execute o seguinte exemplo de T-SQL no banco de dados do usuário:

   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
   

   Os trabalhos de CDC de captura e limpeza começam imediatamente e são criados com configurações padrão. Para obter mais informações sobre os trabalhos, consulte sys.sp_cdc_add_job (Transact-SQL).

3. Cada trabalho é executado em cada réplica de grupo de disponibilidade por padrão, mesmo que seja uma réplica secundária. Isso causará mensagens de erro nos logs, pois os bancos de dados do usuário nas réplicas secundárias não são graváveis. Habilite as duas tarefas CDC em réplicas primárias e desabilite-as em réplicas secundárias. Siga as orientações em Captura de Mudança de Dados em Grupos de Disponibilidade Always On.

Importante

Qualquer segurança granular estabelecida no banco de dados de origem deve ser reconfigurada no banco de dados espelhado em Microsoft Fabric. Para obter mais informações, consulte Como: Proteger dados de bancos de dados espelhados do Microsoft Fabric a partir do SQL Server.

Iniciar o processo de espelhamento

1. A tela Configurar espelhamento permite espelhar todos os dados no banco de dados, por padrão.

   • Espelhar todos os dados significa que todas as novas tabelas criadas após o Espelhamento ser iniciado serão espelhadas.

   • Opcionalmente, escolha apenas alguns objetos para espelhar. Desative a opção Espelhar todos os dados e selecione tabelas individuais do banco de dados.

   Para este tutorial, selecionamos a opção Espelhar todos os dados.

2. Selecione Criar banco de dados espelhado. O espelhamento começa.

3. Aguarde de dois a cinco minutos. Em seguida, selecione Monitorar duplicação para ver o status.

4. Após alguns minutos, o status deve mudar para Em execução, o que significa que as tabelas estão sendo sincronizadas.

   Se você não vir as tabelas e o status de replicação correspondente, aguarde alguns segundos e atualize o painel.

5. Quando a cópia inicial das tabelas for feita, uma data será exibida na coluna Última atualização.

6. Agora que seus dados estão em funcionamento, há vários cenários de análise disponíveis em todo o Fabric.

Monitorar o espelhamento do Fabric

Depois que o espelhamento estiver configurado, você será direcionado para a página Status do espelhamento. Aqui, é possível monitorar o estado atual da duplicação.

Para obter mais informações e detalhes sobre os estados de replicação, consulte Monitorar a replicação espelhada do banco de dados Fabric.

Screenshot do portal do Fabric mostrando o status de replicação do monitor do novo banco de dados espelhado do SQL Server.

Validar dados no OneLake

Com o Espelhamento do Fabric em execução, agora você pode consultar o banco de dados SQL Server no Microsoft Fabric. Para saber mais sobre as possibilidades, consulte Explore dados em seu banco de dados espelhado usando Microsoft Fabric.

Otimização de desempenho

Agora que o espelhamento está em execução, saiba como optimizar o desempenho do banco de dados de origem e do banco de dados espelhado do SQL Server em Microsoft Fabric.

Conteúdo relacionado

• Mirroring SQL Server
• O que é Espelhamento no Tecido?