Créer une instance répliquée en lecture seule

Sélectionnez une version de la documentation :

Pour augmenter le débit de lecture et la disponibilité, vous pouvez créer un serveur répliqué AlloyDB Omni pour un serveur AlloyDB Omni existant. Un serveur répliqué fournit un clone en lecture seule de votre serveur de base de données principal. Il met à jour en continu ses propres données pour refléter les modifications apportées aux données de votre serveur principal.

Les sections suivantes décrivent les étapes à suivre pour configurer votre serveur principal AlloyDB Omni pour la réplication, configurer le serveur répliqué et vérifier l'état de la réplication sur le serveur principal.

Avant de commencer

Avant de continuer, installez et configurez AlloyDB Omni à l'aide du package RPM. Pour en savoir plus, consultez Installer AlloyDB Omni à l'aide de RPM.

Configurer votre serveur principal pour la réplication

  1. Mettez à jour les paramètres réseau ou de pare-feu de l'hôte de votre serveur principal afin qu'il autorise le trafic entrant de l'hôte du serveur répliqué via le port Postgres du serveur principal.

  2. Créez un utilisateur de réplication :

    psql -h localhost -U postgres -c "create user REPLICA_USER with replication password 'PASSWORD';
grant pg_read_all_settings to REPLICA_USER;"

  3. Ajoutez les lignes suivantes dans le fichier /DATA_DIR/pg_hba.conf du serveur principal avant host all all all scram-sha-256 qui existe dans le fichier :

    host alloydbmetadata    alloydbmetadata   IP_RANGE trust
host replication        REPLICA_USER    IP_RANGE scram-sha-256

    Remplacez les éléments suivants :

    • IP_RANGE: plage d'adresses IP, au format CIDR, du sous-réseau dans lequel se trouve votre machine répliquée. Exemple : 203.0.113.0/24.
    • DATA_DIR : chemin d'accès au répertoire de données du serveur principal.

  4. Redémarrez votre serveur principal :

    sudo systemctl restart alloydbomni18

Créer et configurer le serveur répliqué

Pour créer et configurer un serveur répliqué AlloyDB Omni, procédez comme suit :

  1. Assurez-vous que le serveur répliqué est connecté au réseau du serveur principal :

    ping SOURCE_IP

    Remplacez SOURCE_IP par l'adresse IP de l'instance AlloyDB Omni principale à partir de laquelle effectuer la réplication.

  2. Assurez-vous que le serveur répliqué peut se connecter au serveur principal :

    psql "host=SOURCE_IP user=REPLICA_USER replication=1" -c "IDENTIFY_SYSTEM;"

    Le résultat doit ressembler à ce qui suit :

           systemid       | timeline |  xlogpos  | dbname
 ---------------------+----------+-----------+--------
  7376500460465963036 |        1 | 0/454B670 |
  (1 row)

  3. Le serveur répliqué doit disposer d'un emplacement de stockage persistant sur le disque :

    sudo -u postgres pg_basebackup \
  --pgdata=DATA_DIR \
  --checkpoint=fast \
  --host="SOURCE_IP" \
  --port="SOURCE_PORT" \
  --username=REPLICA_USER \
  --create-slot \
  --write-recovery-conf \
  --slot="SLOT_NAME"

    Remplacez les éléments suivants :

    • SOURCE_PORT: port TCP de l'instance AlloyDB Omni principale à partir de laquelle effectuer la réplication. Si vous ne fournissez pas cette valeur, AlloyDB Omni applique la valeur par défaut 5432.
    • SLOT_NAME : libellé du nom de l'emplacement de réplication.
    • DATA_DIR : chemin d'accès au répertoire de données du serveur répliqué.

  4. Démarrez votre instance répliquée :

    sudo systemctl start alloydbomni18

Vérifier l'état de la réplication sur le serveur principal

Pour vérifier que la réplication est correctement configurée, exécutez la commande suivante sur l'hôte du serveur principal :

psql -h localhost -U postgres -c "select * from pg_stat_replication"

Le tableau de sortie contient une ligne pour chaque instance répliquée connectée à votre serveur de base de données principal.

Une fois la réplication configurée, toutes les insertions, mises à jour et suppressions de lignes dans votre serveur de base de données principal deviennent lisibles sur votre instance répliquée en quelques secondes.

Mettre à l'échelle les charges de travail de lecture à l'aide de pools de lecture

Pour mettre à l'échelle vos exigences en matière de création de rapports et de lecture seule, vous pouvez provisionner plusieurs instances répliquées de streaming asynchrone pour former un pool de lecture. Vous pouvez accéder au pool de lecture en vous connectant directement aux adresses IP de vos nœuds répliqués.

Avant de commencer

Assurez-vous d'avoir créé le REPLICA_USER avec les droits REPLICATION sur le serveur principal. Vous devez également vous assurer que le fichier pg_hba.conf du serveur principal est configuré pour autoriser les connexions de réplication à partir des adresses IP de vos nœuds répliqués.

Provisionner plusieurs instances répliquées en lecture seule

Pour créer plusieurs instances répliquées, répétez ces étapes pour chaque nœud répliqué que vous souhaitez inclure dans le pool.

Sur chaque nœud répliqué, exécutez la commande pg_basebackup, en veillant à fournir un nom d'emplacement de réplication unique pour chaque nœud :

  sudo -u postgres pg_basebackup \
   --pgdata=DATA_DIR \
   --checkpoint=fast \
   --host="SOURCE_IP" \
   --port="SOURCE_PORT" \
   --username=REPLICA_USER \
   --create-slot \
   --write-recovery-conf \
   --slot="UNIQUE_SLOT_NAME_PER_NODE"
   ```
Once the backup is complete, start the database service on each replica:
  ```posix-terminal
  sudo systemctl start alloydbomni18