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

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 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.

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.