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

1. Para espelhar dados do SQL Server 2025, precisa de ter um papel 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 gerida do SQL Server recebe automaticamente permissão de "Ler e escrever" na base de dados espelhada. Os usuários com a função de colaborador não têm a permissão Recompartilhar necessária para concluir esta etapa.

   A partir do SQL Server 2025, as permissões necessárias para o login no 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

2. Liga-te à tua 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 master banco de dados. Crie um login de servidor e atribua as permissões apropriadas.

   Importante

   Para instâncias do SQL Server num grupo de disponibilidade Always On, o login 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, faça login como administrador da Microsoft Entra e crie um login autenticado com o Microsoft Entra ID a partir de uma conta já 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;
   

4. Conecte-se à base de dados do utilizador que planeia espelhar no 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 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 deve ser membro da função de servidor sysadmin para configurar o CDC. A função sysadmin do servidor também é necessária para qualquer manutenção futura do CDC. O espelhamento usa CDC se já estiver ativado para a base de dados e as tabelas a serem espelhadas. Os passos a seguir criam o login fabric_login e adicionam-no ao papel de servidor sysadmin para configurar o CDC. Se o CDC já existe, não precisa de adicionar temporariamente o fabric_login principal ao papel de sysadmin servidor. 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. Liga-te à tua 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 master banco de dados. Neste passo, irá criar um login de servidor e atribuir as permissões apropriadas.

   Se o CDC já estiver ativado para que a base de dados e as tabelas sejam espelhadas, fabric_login não precisa ser membro do cargo de administrador de servidores (sysadmin). Se o CDC ainda não estiver ativado, é necessário ser membro da função de servidor sysadmin para configurar o CDC.

   Importante

   Para instâncias do SQL Server num grupo de disponibilidade Always On, o login 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 adesão ao papel de servidor sysadmin da instância SQL Server 2016-2022 é obrigatória para ativar ou desativar 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 da Microsoft Entra e crie um login autenticado com o Microsoft Entra ID 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.

   Ligue à base de dados de utilizadores o seu plano para espelhar no 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 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. 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 Microsoft Entra (recomendado):

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

Ligue o servidor ao Azure Arc e ative a identidade gerida

Para configurar o Fabric Mirroring, precisa de configurar o Azure Arc para a sua instância do SQL Server 2025.

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

   • Siga os passos em Quickstart - Ligue máquina híbrida com servidores Azure Arc habilitados.
   • A Extensão Azure para SQL Server instala-se automaticamente quando liga a instância do SQL Server ao Azure Arc.
   • Para instâncias do SQL Server que estejam a correr num grupo de disponibilidade Always On, é necessário que todos os nós estejam ligados ao Azure Arc.

2. Se ainda não estiver configurado, deve configurar a Managed identity para SQL Server ativada pelo Azure Arc, o que permite a autenticação de saída necessária ao Fabric Mirroring.

3. Ligue-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 geridas no Microsoft Fabric

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

No entanto, para instâncias do SQL Server a executar num grupo de disponibilidade Always On, a identidade gerida atribuída pelo sistema (SAMI) de cada nó secundário precisa de receber permissões Contributor no workspace do Fabric. Uma identidade gerida é criada pela Azure Extension for SQL Server quando a instância SQL está ligada ao Azure Arc, e cada uma deve receber permissões 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

Verifica os requisitos de rede do Fabric para aceder ao teu 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 local pode se ligar à instância SQL Server. Para mais informações, consulte Como: Proteger dados em bases de dados espelhadas do Microsoft Fabric a partir 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. Desloce-se para selecionar Mirrored SQL Server database.
5. Introduza o nome da sua base de dados de SQL Server para espelhar e depois selecione Criar.

Ligue o Fabric à sua instância do SQL Server

Para ativar o espelhamento, é necessário ligar-se à instância do SQL Server a partir do Fabric para iniciar a ligação a partir do Fabric. Os passos seguintes guiam-no no processo de criação da ligação ao seu SQL Server:

1. Em Novas fontes, selecione SQL Server base de dados. Ou, selecione uma ligação SQL Server existente a partir do hub OneLake.

2. Se selecionou Nova ligação, introduza os detalhes da ligação na instância SQL Server.

   • Server: O caminho do nome do servidor totalmente qualificado que o Fabric usa para aceder à sua instância SQL Server, o mesmo que usaria para SSMS.

   Sugestão

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

   • Database: Introduza 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.

Prepare a sua instância de SQL Server

1. O serviço SQL Server Agent deve estar a funcionar. É 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

Verifica os requisitos de rede do Fabric para aceder ao teu 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 gateway de dados pode ligar-se à instância SQL Server. Para mais informações, consulte Como: Proteger dados nas bases de dados espelhadas do Microsoft Fabric a partir 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. Desloce-se para selecionar Mirrored SQL Server database.
5. Introduza o nome da sua base de dados de SQL Server para espelhar e depois selecione Criar.

Ligue o Fabric à sua instância do SQL Server

Para ativar o espelhamento, é necessário ligar-se à instância do SQL Server a partir do Fabric para iniciar a ligação a partir do Fabric. Os passos seguintes guiam-no no processo de criação da ligação ao seu SQL Server:

1. Em Novas fontes, selecione SQL Server base de dados. Ou, selecione uma ligação SQL Server existente a partir do hub OneLake.

2. Se selecionou Nova ligação, introduza os detalhes da ligação na instância SQL Server.

   • Server: O caminho do nome do servidor totalmente qualificado que o Fabric usa para aceder à sua instância SQL Server, o mesmo que usaria para SSMS.

   Sugestão

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

   • Database: Introduza 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 secção só é obrigatória se a base de dados de origem do SQL Server que espelha 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, 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 mais informações sobre os empregos, 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.