Utilizzo della replica logica di PostgreSQL con cluster database multi-AZ

Utilizzando la funzionalità di replica logica di PostgreSQL con il cluster database multi-AZ, puoi replicare e sincronizzare singole tabelle anziché l'intera istanza database. La replica logica utilizza un modello di pubblicazione e sottoscrizione per replicare le modifiche da un'origine in uno o più destinatari. Funziona utilizzando i record di modifica del WAL (write-ahead log) PostgreSQL. Per ulteriori informazioni, consulta Esecuzione della replica logica per Amazon RDS for PostgreSQL.

Quando crei un nuovo slot di replica logica sull'istanza database di scrittura di un cluster database multi-AZ, lo slot viene copiato in modo asincrono su ogni istanza database di lettura nel cluster. Gli slot delle istanze database di lettura vengono continuamente sincronizzati con quelli dell'istanza database di scrittura.

La replica logica è supportata per i cluster database multi-AZ che eseguono RDS per PostgreSQL versione 14.8-R2 e versioni successive e 15.3-R2 e versioni successive.

Nota

Oltre alla funzionalità di replica logica nativa di PostgreSQL, i cluster database multi-AZ che eseguono RDS per PostgreSQL supportano anche l'estensione pglogical.

Per ulteriori informazioni sulla funzionalità di replica logica di PostgreSQL, consulta la sezione relativa alla replica logica nella documentazione di PostgreSQL.

Prerequisiti

Per configurare la funzionalità di replica logica di PostgreSQL per i cluster database multi-AZ, è necessario soddisfare i seguenti prerequisiti.

• L'account utente deve essere membro del gruppo rds_superuser e disporre dei privilegi rds_superuser. Per ulteriori informazioni, consulta Informazioni su ruoli e autorizzazioni di PostgreSQL.

• Il cluster database multi-AZ deve essere associato a un gruppo di parametri del cluster database personalizzato in modo da poter configurare i valori dei parametri descritti nella procedura seguente. Per ulteriori informazioni, consulta Utilizzo di gruppi di parametri cluster di database per cluster database Multi-AZ.

Configurazione della replica logica

Per configurare la replica logica per un cluster database multi-AZ, devi abilitare parametri specifici all'interno del gruppo di parametri del cluster database associato, quindi creare slot di replica logica.

Nota

A partire dalla versione 16 di PostgreSQL, è possibile utilizzare istanze Reader DB del cluster DB Multi-AZ per la replica logica.

Configurazione della replica logica per un cluster database multi-AZ RDS per PostgreSQL

1. Apri il gruppo di parametri del cluster database personalizzato associato al cluster database multi-AZ RDS per PostgreSQL.

2. Nel campo di ricerca Parametri, individua il parametro statico rds.logical_replication e imposta il relativo valore su 1. La modifica di questo parametro può aumentare la generazione di WAL, quindi abilita questo parametro la solo quando utilizzi slot logici.

3. Nell'ambito di questa modifica, configura i seguenti parametri del cluster database.

   • max_wal_senders

   • max_replication_slots

   • max_connections

   A secondo dell'utilizzo previsto, potrebbe anche essere necessario modificare i valori dei seguenti parametri. Tuttavia, in molti casi, i valori predefiniti sono sufficienti.

   • max_logical_replication_workers

   • max_sync_workers_per_subscription

4. Riavvia il cluster database multi-AZ per rendere effettivi i valori dei parametri. Per istruzioni, consulta Riavvio di un cluster di database multi-AZ e istanze database di lettura.

5. Crea uno slot di replica logica sull'istanza database di scrittura del cluster database multi-AZ come illustrato in Lavorare con gli slot di replica logica. Questo processo richiede che venga specificato un plug-in di decodifica. Attualmente RDS per PostgreSQL supporta i plugin test_decoding, wal2json e pgoutput forniti con PostgreSQL.

   Lo slot viene copiato in modo asincrono su ogni istanza database di lettura nel cluster.

6. Verifica lo stato dello slot su tutte le istanze database di lettura del cluster database multi-AZ. A tale scopo, verifica la vista pg_replication_slots su tutte le istanze database di lettura e assicurati che lo stato confirmed_flush_lsn stia progredendo mentre l'applicazione sta utilizzando attivamente le modifiche logiche.

   I seguenti comandi mostrano come controllare lo stato di replica sulle istanze database di lettura.

   % psql -h test-postgres-instance-2.abcdefabcdef.us-west-2.rds.amazonaws.com
   
   postgres=> select slot_name, slot_type, confirmed_flush_lsn from pg_replication_slots;
     slot_name   | slot_type | confirmed_flush_lsn
   --------------+-----------+---------------------
    logical_slot | logical   | 32/D0001700
   (1 row)
   
   postgres=> select slot_name, slot_type, confirmed_flush_lsn from pg_replication_slots;
     slot_name   | slot_type | confirmed_flush_lsn
   --------------+-----------+---------------------
    logical_slot | logical   | 32/D8003628
   (1 row)
   
   % psql -h test-postgres-instance-3.abcdefabcdef.us-west-2.rds.amazonaws.com
   
   postgres=> select slot_name, slot_type, confirmed_flush_lsn from pg_replication_slots;
     slot_name   | slot_type | confirmed_flush_lsn
   --------------+-----------+---------------------
    logical_slot | logical   | 32/D0001700
   (1 row)
   
   postgres=> select slot_name, slot_type, confirmed_flush_lsn from pg_replication_slots;
     slot_name   | slot_type | confirmed_flush_lsn
   --------------+-----------+---------------------
    logical_slot | logical   | 32/D8003628
   (1 row)

Dopo aver completato le attività di replica, interrompi il processo di replica, elimina gli slot di replica e disattiva la replica logica. Per disattivare la replica logica, modifica il gruppo di parametri del cluster database e reimposta il valore di rds.logical_replication su 0. Riavvia il cluster database per applicare la modifica apportata al parametro.

Limitazioni e consigli

Le seguenti limitazioni e raccomandazioni si applicano all'utilizzo della replica logica con cluster DB Multi-AZ che eseguono PostgreSQL versione 16:

• È possibile utilizzare solo istanze Writer DB per creare o eliminare slot di replica logica. Ad esempio, il CREATE SUBSCRIPTION comando deve utilizzare l'endpoint cluster writer nella stringa di connessione host.

• È necessario utilizzare l'endpoint cluster writer durante qualsiasi sincronizzazione o risincronizzazione delle tabelle. Ad esempio, è possibile utilizzare i seguenti comandi per risincronizzare una tabella appena aggiunta:

  Postgres=>ALTER SUBSCRIPTION subscription-name CONNECTION host=writer-endpoint
  Postgres=>ALTER SUBSCRIPTION subscription-name REFRESH PUBLICATION

• È necessario attendere il completamento della sincronizzazione della tabella prima di utilizzare le istanze DB del lettore per la replica logica. È possibile utilizzare la tabella del pg_subscription_rel catalogo per monitorare la sincronizzazione delle tabelle. La sincronizzazione della tabella è completa quando la srsubstate colonna è impostata su ready ()r.

• Si consiglia di utilizzare gli endpoint dell'istanza per la connessione di replica logica una volta completata la sincronizzazione iniziale della tabella. Il comando seguente riduce il carico sull'istanza DB di Writer affidando la replica a una delle istanze DB Reader:

  Postgres=>ALTER SUBSCRITPION subscription-name CONNECTION host=reader-instance-endpoint

  Non è possibile utilizzare lo stesso slot su più di un'istanza DB alla volta. Quando due o più applicazioni replicano le modifiche logiche da diverse istanze DB del cluster, alcune modifiche potrebbero andare perse a causa di un failover del cluster o di un problema di rete. In queste situazioni, è possibile utilizzare gli endpoint dell'istanza per la replica logica nella stringa di connessione host. L'altra applicazione che utilizza la stessa configurazione mostrerà il seguente messaggio di errore:

  replication slot slot_name is already active for PID x providing immediate feedback.

• Durante l'utilizzo dell'pglogicalestensione, è possibile utilizzare solo l'endpoint cluster writer. L'estensione presenta limitazioni note che possono creare slot di replica logica inutilizzati durante la sincronizzazione delle tabelle. Gli slot di replica obsoleti riservano i file WAL (write-ahead log) e possono causare problemi di spazio su disco.