Criar uma réplica somente leitura

Selecione uma versão da documentação:

Para aumentar a capacidade de processamento de leitura e a disponibilidade, crie um servidor de réplica do AlloyDB Omni para um servidor do AlloyDB Omni. Um servidor de réplica fornece um clone somente leitura do seu servidor de banco de dados primário. Ele atualiza continuamente os próprios dados para refletir alterações nos dados do servidor primário.

Nas seções a seguir, mostramos as etapas para configurar o servidor primário do AlloyDB Omni para replicação, configurar o servidor de réplica e verificar o status da replicação no servidor primário.

Configurar o servidor primário para replicação

  1. Atualize as configurações de rede ou firewall do host do servidor primário para permitir o tráfego de entrada do host do servidor de réplica pela porta TCP 5432.

  2. Adicione as seguintes linhas ao arquivo /var/alloydb/config/pg_hba.conf:

    host all                alloydbreplica     IP_RANGE trust
host replication        alloydbreplica     IP_RANGE trust
host alloydbmetadata    alloydbmetadata    IP_RANGE trust

    Substitua IP_RANGE pelo intervalo de IP, na notação CIDR, da sub-rede em que a máquina de réplica está localizada. Por exemplo, 203.0.113.0/24.

  3. Reinicie o servidor primário:

    sudo alloydb database-server stop
sudo alloydb database-server start

Criar e configurar o servidor de réplica

Para criar e configurar um servidor de réplica do AlloyDB Omni, siga estas etapas:

  1. Instale o AlloyDB Omni no sistema em que você quer hospedar a réplica.

    Ao executar o comando alloydb database-server install, inclua as flags específicas para criar uma réplica:

    sudo alloydb database-server install \
  --data-dir=DATA_DIR \
  --pg-port=PORT \
  --replica-source-ip=SOURCE_IP \
  --replica-source-port=SOURCE_PORT

    Substitua o seguinte:

    • DATA_DIR: o caminho do sistema de arquivos que você quer que esta réplica use para o diretório de dados.

    • PORT: a porta TCP em que você quer que o AlloyDB Omni aceite conexões. Se você não fornecer esse valor, o AlloyDB Omni vai aplicar o valor padrão 5432.

    • SOURCE_IP: o endereço IP da instância primária do AlloyDB Omni da qual será feita a replicação.

    • SOURCE_PORT: a porta TCP da instância primária do AlloyDB Omni da qual será feita a replicação. Se você não fornecer esse valor, o AlloyDB Omni vai aplicar o valor padrão 5432.

  2. Verifique se a réplica tem conectividade de rede com o servidor primário:

    ping SOURCE_IP

  3. Inicie a réplica:

    sudo alloydb database-server start

Verificar o status da replicação no servidor primário

Para verificar se a replicação está configurada corretamente, execute o seguinte comando no host do servidor primário:

  docker exec -it pg-service psql -h localhost -U alloydbadmin -c "select * from pg_stat_replication"

A tabela de resposta contém uma linha para cada réplica conectada ao servidor de banco de dados primário.

Depois que você configura a replicação, todas as inserções, atualizações e exclusões de linhas no servidor de banco de dados primário ficam legíveis na réplica em poucos segundos.