Compartilhar via

Tutorial: Configurar bancos de dados espelhados do Microsoft Fabric do Banco de Dados do Azure para PostgreSQL

O espelhamento no Fabric (agora disponível em geral) é uma tecnologia SaaS corporativa, baseada em nuvem, zero ETL. Nesta seção, você aprenderá a criar um servidor flexível espelhado do Banco de Dados do Azure para PostgreSQL, que cria uma cópia replicada continuamente somente leitura dos dados postgreSQL no OneLake.

Importante

Os servidores flexíveis do Banco de Dados do Azure para PostgreSQL recém-criados após o Ignite 2025 incluem automaticamente a versão de disponibilidade geral mais recente dos componentes de espelhamento. Os servidores existentes são atualizados progressivamente como parte dos próximos ciclos de manutenção sem a necessidade de intervenção manual. Você não precisa desativar e reativar o espelhamento para receber atualizações.

Pré-requisitos

  • Crie ou use um servidor flexível do Banco de Dados do Azure para PostgreSQL existente.
  • Você precisa de uma capacidade existente do Fabric. Se não tiver uma, inicie uma avaliação do Fabric.
  • A capacidade da malha precisa estar ativa e em execução. Uma capacidade pausada ou excluída também interrompe o Espelhamento e nenhum dado será 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:
  • 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 Banco de Dados do Azure para PostgreSQL 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 Reshare necessária para concluir esta etapa.
  • Se o Servidor Flexível não tiver a conectividade pública habilitada ou não permitir que os serviços do Azure se conectem a ele, você poderá criar um gateway de dados de rede virtual para espelhar os dados. Verifique se a Rede Virtual do Azure ou a rede do computador de gateway podem se conectar ao servidor flexível do Banco de Dados do Azure para PostgreSQL por meio de um ponto de extremidade privado ou é permitida pela regra de firewall.
  • Não há suporte para espelhamento de malha em uma réplica de leitura ou em um servidor primário em que exista uma réplica de leitura.

Preparar seu Banco de Dados do Azure para PostgreSQL

O espelhamento no servidor flexível do Banco de Dados do Azure para PostgreSQL baseia-se na Replicação Lógica e requer que alguns pré-requisitos específicos sejam configurados antes de poderem se conectar aos seus dados.

Importante

Para orientar os usuários na habilitação desses pré-requisitos, criamos uma página específica do Espelhamento de Malha no portal do Azure que automatiza tudo isso para você. Para obter mais informações, consulte os conceitos de espelhamento do Fabric para o servidor flexível do PostgreSQL.

  • System-Assigned IDENTIDADE Gerenciada (SAMI) deve estar habilitado.
  • O wal_level parâmetro do servidor para o WAL (log de gravação antecipada) deve ser definido como lógico.
  • A extensão (azure_cdc) é necessária e deve estar na lista de permissões e pré-carregada (requer reinicialização).
  • O max_worker_processes parâmetro do servidor deve ser aumentado em 3 para cada banco de dados espelhado no servidor de origem.

Função de banco de dados para espelhamento de malha

Em seguida, você precisa fornecer ou criar uma função de PostgreSQL ou de Entra ID para que o serviço Fabric se conecte ao servidor flexível do Banco de Dados do Azure para PostgreSQL.

Você pode fazer isso especificando uma função de banco de dados para se conectar ao sistema de origem usando uma das seguintes opções:

Usar um papel de ID do Entra

  1. Siga estas instruções para mapear um usuário ou grupo da ID do Entra para uma função de banco de dados PostgreSQL.

  2. Depois que isso for feito, você poderá usar o script SQL a seguir para conceder as azure_cdc_admin permissões à nova função.

    -- grant role for replication management to the new user
GRANT azure_cdc_admin TO <entra_user>;
-- grant create permission on the database to mirror to the new user
GRANT CREATE ON DATABASE <database_to_mirror> TO <entra_user>;

Usar uma função PostgreSQL

  1. Conecte-se ao servidor flexível do Banco de Dados do Azure para PostgreSQL usando pgAdmin. Você deve se conectar a uma entidade de segurança que seja membro da função azure_pg_admin.

  2. Criar uma função PostgreSQL chamada fabric_user. Você pode escolher qualquer nome para essa função. Forneça sua própria senha forte. Conceda as permissões necessárias para o espelhamento do Fabric no banco de dados. Execute o script SQL a seguir para conceder o CREATEDB, CREATEROLE, LOGINe REPLICATIONas azure_cdc_admin permissões para a nova função chamada fabric_user.

    -- create a new user to connect from Fabric
CREATE ROLE fabric_user CREATEDB CREATEROLE LOGIN REPLICATION PASSWORD '<strong password>';

-- grant role for replication management to the new user
GRANT azure_cdc_admin TO fabric_user;
-- grant create permission on the database to mirror to the new user
GRANT CREATE ON DATABASE <database_to_mirror> TO fabric_user;

O usuário do banco de dados criado com um dos dois métodos anteriores também precisa ser owner das tabelas a serem replicadas no banco de dados espelhado. Isso significa que as tabelas foram criadas por esse usuário ou que a propriedade dessas tabelas foi alterada usando ALTER TABLE <table name here> OWNER TO <user>;.

  • Ao alternar a propriedade para um novo usuário, talvez seja necessário conceder a esse usuário todos os privilégios no public esquema antes. Para obter mais informações sobre o gerenciamento de conta de usuário, consulte a documentação de gerenciamento de usuários do Banco de Dados do Azure para PostgreSQL, documentação do produto PostgreSQL para funções e privilégios de banco de dados, sintaxe GRANT e Privilégios.

Importante

A falta de uma das etapas de configuração de segurança anteriores fará com que as operações espelhadas subsequentes no portal do Fabric falhem com uma Internal error mensagem.

Criar um servidor flexível do Banco de Dados do Azure para PostgreSQL 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 ou selecione o botão Novo item . Selecione o ícone Criar.
  4. Role até a seção Data Warehouse e selecione Banco de Dados do Azure espelhado para PostgreSQL (versão prévia).

Conectar-se ao servidor flexível do Banco de Dados do Azure para PostgreSQL

As etapas a seguir orientam você pelo processo de criação da conexão com o servidor flexível do Banco de Dados do Azure para PostgreSQL:

  1. Em Novas fontes, selecione Banco de Dados do Azure para PostgreSQL (versão prévia). Ou selecione uma conexão de servidor flexível do Banco de Dados do Azure para PostgreSQL existente no hub do OneLake.
  2. Se você selecionou Nova conexão, insira os detalhes da conexão para o servidor flexível do Banco de Dados do Azure para PostgreSQL.
    • Servidor: Você pode encontrar o nome do servidor navegando até a página visão geral do servidor flexível do Banco de Dados do Azure para PostgreSQL no portal do Azure. Por exemplo, <server-name>.postgres.database.azure.com.
    • Banco de dados: insira o nome do servidor flexível do Banco de Dados do Azure para PostgreSQL.
    • 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 um Gateway de Dados da VNET disponível para conectar um servidor flexível do Banco de Dados do Azure para PostgreSQL com integração VNET ou pontos de extremidade privados.
    • Tipo de autenticação:
      • Básico (Autenticação PostgreSQL)
      • Conta organizacional (Autenticação do Entra)
    • Deixe a caixa de seleção Usar conexão criptografada selecionada e essa conexão pode ser usada com o gateway de dados local e o gateway de dados da VNET não selecionados.
  3. Selecione Conectar.

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 Espelhar banco de dados. 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ê as tabelas e o status de duplicação correspondente não estiverem visíveis, 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.

Importante

Qualquer segurança granular estabelecida no banco de dados de origem deverá ser reconfigurada no banco de dados espelhado no Microsoft Fabric. Consulte as permissões granulares do SQL no Microsoft 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, veja Monitorar a replicação de banco de dados espelhados do Fabric.

Conteúdo relacionado

  • Last updated on