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

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

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

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

   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. 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 Microsoft Entra e crie um login autenticado ID Microsoft Entra a partir 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;
   

3. Conecte-se ao banco de dados do usuário que você planeja 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 SELECT, ALTER ANY EXTERNAL MIRROR, VIEW DATABASE PERFORMANCE STATE, VIEW DATABASE SECURITY STATE
      TO [fabric_user];
   

   • Ou, para um logon 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];
   

Para as versões do SQL Server 2016-2022, um administrador precisa de associação à função de servidor sysadmin para configurar inicialmente o CDC. Qualquer manutenção futura do CDC exigirá associação à função de servidor sysadmin.

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 do SQL Server usando uma ferramenta de consulta T-SQL, como o SSMS (SQL Server Management Studio) ou a extensão mssql com o Visual Studio Code.

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

   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 habilitar 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 logon como administrador do Microsoft Entra e crie um logon autenticado da ID do Microsoft Entra 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ê planeja 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 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. 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 do Microsoft Entra (recomendado):

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

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 estiver, conecte o servidor ao Azure Arc e instale a Extensão do Azure para SQL Server.

   • Siga as etapas no 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 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 o SQL Server habilitada pelo Azure Arc, que habilita a autenticação de saída necessária para o Espelhamento de Malha.

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 no Microsoft Fabric

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

No entanto, para instâncias do SQL Server que estão sendo executadas em grupos de disponibilidade Always On, a identidade gerenciada atribuída pelo sistema (SAMI) de cada nó secundário precisa receber permissões de Colaborador para o Fabric workspace. Uma identidade gerenciada é criada pela Extensão do Azure para SQL Server quando a instância do SQL está conectada ao Azure Arc. Em seguida, 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 se conectar à 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 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 até selecionar banco de dados do SQL Server espelhado.
5. Insira o nome do banco de dados do SQL Server a ser espelhado e selecione Criar.

Conectar o Fabric à instância do SQL Server

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

1. Em Novas fontes, selecione o banco de dados do SQL Server. Ou selecione uma conexão existente do SQL Server no hub Do 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 do servidor totalmente qualificado que o Fabric usa para alcançar sua instância do SQL Server, o mesmo que você usaria para o SSMS.

   Dica

   As instâncias do SQL Server em um grupo de disponibilidade Always On usam o Listener Always On para Servidor.

   • Banco de dados: insira o nome do SQL Server.
     • Conexão: crie uma nova conexão.
     • Nome da conexão: um nome automático é fornecido. Isso não poderá ser alterado.
     • 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.

Prepare sua instância do SQL Server

1. O serviço SQL Server Agent tem de 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 se conectar à 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 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 até selecionar banco de dados do SQL Server espelhado.
5. Insira o nome do banco de dados do SQL Server a ser espelhado e selecione Criar.

Conectar o Fabric à instância do SQL Server

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

1. Em Novas fontes, selecione o banco de dados do SQL Server. Ou selecione uma conexão existente do SQL Server no hub Do 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 do servidor totalmente qualificado que o Fabric usa para alcançar sua instância do 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 ouvinte Always On para Servidor.

   • Banco de dados: insira o nome do SQL Server.
     • Conexão: crie uma nova conexão.
     • Nome da conexão: um nome automático é fornecido. Isso não poderá ser alterado.
     • 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 do espelhamento do SQL Server para o 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.