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

O espelhamento no Fabric é uma tecnologia SaaS empresarial, baseada na nuvem e sem necessidade de ETL. Nesta seção, você aprenderá a criar um banco de dados espelhado do SQL Server, que cria uma cópia somente leitura e replicada continuamente dos dados do SQL Server no OneLake.

Pré-requisitos

• Instale ou use uma instância existente do SQL Server, no local ou na nuvem.
  • Como tutorial, recomendamos o uso de uma cópia de um de seus bancos de dados existentes ou de qualquer banco de dados de teste ou desenvolvimento existente que você possa recuperar rapidamente de um backup.
• Instale uma ferramenta de consulta T-SQL como o SQL Server Management Studio (SSMS) ou a extensão mssql com o Visual Studio Code.
• Você precisa de uma capacidade já existente para Fabric. Caso não o faça, inicie uma avaliação dos serviços do Fabric.
  • A capacidade Fabric precisa estar ativa e em execução. Uma capacidade pausada ou excluída impede o espelhamento de malha e nenhum dado é replicado.
• As configurações de tenant do Fabric são necessárias. Verifique se as duas Fabric Tenant settings a seguir estão habilitadas:
  • Os principais de serviço podem usar APIs do Fabric
  • Os usuários podem acessar dados armazenados no OneLake com aplicativos externos ao Fabric
• Para espelhar dados do SQL Server 2025, precisa de ter uma função de membro ou administrador no seu espaço de trabalho ao criar uma base de dados espelhada a partir do portal Fabric. Durante a criação, a identidade gerenciada do SQL Server recebe automaticamente a permissão "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 Recompartilhar necessária para concluir esta etapa.
• Analise as limitações de plataforma em bases de dados replicadas do Microsoft Fabric a partir do SQL Server.
• Um gateway de dados on-premises ou um gateway de dados de rede virtual na rede da sua instância SQL Server. A rede do gateway de dados deve ligar-se à instância SQL Server através de um ponto final privado ou estar autorizada pela regra do firewall.

Principal de base de dados para Fabric

Em seguida, você precisa criar uma maneira para que o serviço Fabric se autentique em sua instância do SQL Server.

Você pode fazer isso com um login e utilizador mapeado de base de dados.

Utilizar um utilizador de login e base de dados mapeada

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

Siga estas instruções para o SQL Server 2025 ou o SQL Server 2016-2022 para criar um login e um utilizador de base de dados para o espelhamento de base de dados.

SQL Server 2025

A partir do 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 ESTADO DE DESEMPENHO DO BANCO DE DADOS
  • EXIBIR ESTADO DE SEGURANÇA DO BANCO DE DADOS

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

2. Conecte-se ao master banco de dados. Crie um login de servidor e atribua as permissões apropriadas.

   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. A fabric_login entidade principal deve ter o mesmo SID em cada instância de réplica.

   • Crie um logon autenticado SQL chamado fabric_login. Você pode escolher qualquer nome para este login. Forneça a sua própria palavra-passe forte. Execute o seguinte script T-SQL no master banco de dados:

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

   • Ou inicie sessão como administrador do Microsoft Entra e crie um início de sessão autenticado pelo Microsoft Entra ID a partir de uma conta existente (recomendado). Execute o seguinte script T-SQL no master banco de dados:

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

3. Conecte-se ao banco de dados de usuários que planeia espelhar para o Microsoft Fabric. Crie um usuário de banco de dados conectado ao login e conceda os privilégios mínimos necessários:

   • Para um logon autenticado 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 login autenticado do 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 as versões 2016-2022 do SQL Server, um administrador precisa de associação à função de servidor sysadmin para configurar inicialmente o CDC. Qualquer manutenção futura do CDC exigirá a associação à função de servidor sysadmin.

Depois que o CDC estiver configurado, habilitar o espelhamento requer apenas as permissões CONNECT no nível do servidor e as permissões SELECT e CONNECT no nível do banco de dados para replicar os dados.

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

2. Conecte-se ao master banco de dados. Crie um login de servidor e atribua as permissões apropriadas.

   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 etapas a seguir em cada instância de réplica. A fabric_login entidade principal deve ter o mesmo SID em cada instância de réplica.

   Você pode escolher qualquer nome para este login. A associação à função de servidor sysadmin da instância do SQL Server 2016-2022 é necessária para habilitar ou desabilitar a captura de dados de alteração.

   • Execute o seguinte script T-SQL no master banco de dados para criar um logon autenticado SQL chamado fabric_login. Forneça a sua própria palavra-passe 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 inicie sessão como administrador do Microsoft Entra e crie um login autenticado do ID do Microsoft Entra a partir de uma conta existente. Execute o seguinte script T-SQL no master banco de dados:

   --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 gerir o CDC, é necessária a associação à função db_owner do banco de dados de origem para espelhamento.

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

   • Para um logon autenticado SQL:

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

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

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

4. Após o CDC estar habilitado, pode remover fabric_login da função de servidor sysadmin.

   • Para um logon autenticado SQL:

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

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

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

Conectar-se ao seu SQL Server

As instruções e os requisitos para configurar um Fabric Mirrored Database no SQL Server diferem a partir do SQL Server 2025.

A partir do SQL Server 2025, um servidor habilitado para o Azure Arc faz parte da configuração necessária para a comunicação com o Fabric. Antes do SQL Server 2025, o Azure Arc não era necessário e a replicação é baseada no CDC (Change Data Capture).

SQL Server 2025

Conectar o servidor ao Azure Arc e habilitar a identidade gerenciada

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

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

   • Siga as etapas em Guia de início rápido - Conectar máquina híbrida com servidores habilitados para Azure Arc.
   • A Extensão do Azure para SQL Server é instalada automaticamente quando você conecta a instância do SQL Server ao Azure Arc.
   • Para instâncias do SQL Server executadas em um grupo de disponibilidade Always On, todos os nós devem estar conectados ao Azure Arc.

2. Caso ainda não esteja configurado, deverá configurar a Identidade Gerida para o SQL Server ativada pelo Azure Arc, que habilita a autenticação de saída necessária para o Fabric Mirroring.

3. Conecte-se à sua instância local do SQL Server 2025. Quando você se conectar, selecione Confiar no certificado do servidor.

4. Veja 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 no Microsoft Fabric

A identidade gerenciada do SQL Server é criada e recebe permissões do Microsoft Fabric automaticamente.

No entanto, para instâncias do SQL Server executadas em um grupo de disponibilidade Sempre Ativo, a identidade gerida atribuída pelo sistema (SAMI) de cada nó secundário precisa receber permissões de Colaborador para o espaço de trabalho do Fabric. Uma identidade gerida é criada pela Extensão do Azure para o SQL Server quando a instância SQL está conectada ao Azure Arc, e cada uma deve receber permissões do Fabric manualmente.

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

   1. No espaço de trabalho Fabric, selecione Gerir acesso.

      

   2. Selecione Adicionar pessoas ou grupos.

   3. Na caixa de diálogo Adicionar utilizadores, localize os nomes dos servidores para cada nó no grupo de disponibilidade.

   4. Dê a cada membro a função de Colaborador.

      

Configure o gateway de dados local ou de rede virtual

Verifique os requisitos de rede do Fabric para acessar o SQL Server. Precisa de instalar um gateway de dados local ou criar um gateway virtual de rede para espelhar os dados. Certifique-se de que a rede da máquina gateway no local consiga ligar-se à instância do SQL Server. Para obter mais informações, consulte Como proteger dados de bancos de dados espelhados do Microsoft Fabric do SQL Server.

Para utilizar o gateway de dados local:

1. Baixe o gateway de dados local a partir 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 o endereço de e-mail da sua conta Microsoft.
   • Nome: MyOPDG ou qualquer nome que deseje.
   • Chave de recuperação: forneça uma chave de recuperação forte.

Criar um SQL Server espelhado

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

Conectar o Fabric à sua instância do SQL Server

Para habilitar o espelhamento, é necessário conectar-se à instância do SQL Server a partir do Fabric para iniciar a conexão a partir do Fabric. As etapas a seguir guiam você pelo processo de criação da conexão com o SQL Server:

1. Em Novas fontes, selecione Banco de dados do SQL Server. Ou selecione uma conexão existente do SQL Server no hub OneLake.

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

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

   Sugestão

   Instâncias do SQL Server em um grupo de disponibilidade Always On, use o ouvinte Always On para Server.

   • Banco de dados: insira o nome do seu 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 configurou de acordo com o seu cenário.
     • Tipo de autenticação: escolha o método de autenticação e forneça o principal que configurou em Utilizar um utilizador de login e base de dados mapeado.
     • Marque a caixa de seleção Usar conexão criptografada .

3. Selecione Conectar.

SQL Server 2016-2022

Preparar sua instância do SQL Server

1. O serviço SQL Server Agent deve estar em execução. É altamente recomendável configurar a inicialização automática.
2. A Captura de Dados Alterados (CDC) será automaticamente habilitada e configurada pelo Espelhamento de Malha para cada tabela desejada em seu banco de dados. Analise os problemas e erros conhecidos com o CDC. O CDC exige que cada tabela tenha uma chave primária.

Configure o gateway de dados local ou de rede virtual

Verifique os requisitos de rede do Fabric para acessar o SQL Server. Precisa de instalar um gateway de dados local ou criar um gateway virtual de rede para espelhar os dados. Certifique-se de que a rede do data gateway consegue ligar-se à instância do SQL Server. Para obter mais informações, consulte Como proteger dados de bancos de dados espelhados do Microsoft Fabric do SQL Server.

Para utilizar o gateway de dados local:

1. Baixe o gateway de dados local, consulte Baixar 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 o endereço de e-mail da sua conta Microsoft.
   • Nome: MyOPDG ou qualquer nome que deseje.
   • Chave de recuperação: forneça uma chave de recuperação forte.

Criar um SQL Server espelhado

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

Conectar o Fabric à sua instância do SQL Server

Para habilitar o espelhamento, é necessário conectar-se à instância do SQL Server a partir do Fabric para iniciar a conexão a partir do Fabric. As etapas a seguir guiam você pelo processo de criação da conexão com o SQL Server:

1. Em Novas fontes, selecione Banco de dados do SQL Server. Ou selecione uma conexão existente do SQL Server no hub OneLake.

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

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

   Sugestão

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

   • Banco de dados: insira o nome do seu 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 principal que configurou em Utilizar um utilizador de login e base 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 do espelhamento do SQL Server para 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, etapas adicionais serão necessárias para configurar as réplicas secundárias. Repita estas etapas para cada réplica secundária para preparar o grupo de disponibilidade inteiro. Cada réplica requer que as tarefas do agente SQL sejam configuradas para que o CDC funcione corretamente quando essa réplica for primária.

1. Execute a transição do grupo de disponibilidade para uma réplica secundária.

2. Use o script fornecido para criar, caso não existam, tarefas de limpeza e captura no banco de msdb dados do sistema da instância de 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 de 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 CDC de captura e limpeza começam imediatamente e são criados com as configurações padrão. Para obter mais informações sobre os trabalhos, consulte sys.sp_cdc_add_job (Transact-SQL).

3. Cada tarefa é executada em cada réplica de grupo de disponibilidade automaticamente, mesmo que seja uma réplica secundária. Isso causará mensagens de erro nos logs, pois os bancos de dados de usuário nas réplicas secundárias não podem ser gravados. Habilite as duas tarefas de CDC nas réplicas primárias e desative-as nas réplicas secundárias. Siga as orientações em Alterar captura 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 no Microsoft Fabric. Para obter mais informações, consulte Como proteger dados de bancos de dados espelhados do Microsoft Fabric 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 início do espelhamento serão espelhadas.

   • Opcionalmente, escolha apenas determinados 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. Começa o espelhamento.

3. Aguarde 2-5 minutos. Em seguida, selecione Monitorar replicação para ver o status.

4. Após alguns minutos, o status deve mudar para Executando, 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 eles terminarem a cópia inicial das tabelas, uma data aparecerá na coluna Última atualização .

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

Espelhamento de malha do monitor

Assim que o espelhamento estiver configurado, você será direcionado para a página de Status de Espelhamento. Aqui, você pode monitorar o estado atual da replicação.

Para obter mais informações e detalhes sobre os estados de replicação, consulte Replicação de banco de dados espelhado do Monitor Fabric.

Validar dados no OneLake

Com o Fabric Mirroring instalado e em execução, agora pode consultar dados do seu banco de dados SQL Server no Microsoft Fabric. Para conhecer as possibilidades, consulte Explorar dados em seu banco de dados espelhado usando o Microsoft Fabric.

Otimização do desempenho

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

Conteúdo relacionado

• Espelhamento do SQL Server
• O que é espelhamento em malha?