Puoi utilizzare le funzionalità di decodifica e replica logica in Cloud SQL per PostgreSQL. Queste funzionalità consentono i flussi di lavoro di replica logica e di CDC (Change Data Capture).
Per informazioni generali sulla replica, consulta Informazioni sulla replica in Cloud SQL.
Introduzione
Quando PostgreSQL esegue la replica logica, le modifiche trasmesse in streaming alle repliche vengono estratte dai log WAL utilizzando la decodifica logica. Le modifiche decodificate sono indipendenti dal formato di archiviazione fisico sottostante. Le modifiche riflettono solo le modifiche ai dati a livello di SQL, in termini di INSERT, UPDATE ed DELETE. Questa indipendenza dal livello di archiviazione offre una grande flessibilità e consente ai consumatori degli modifiche in tempo reale di utilizzare un'ampia gamma di funzionalità.
La replica logica è la funzionalità principale basata sulla decodifica logica.
A differenza della funzionalità di replica fisica di PostgreSQL, che richiede che i database di origine e di destinazione siano della stessa versione, la replica logica consente la replica tra le principali versioni di PostgreSQL. La replica logica in Cloud SQL è supportata dall'estensione pglogical, disponibile in tutte le versioni di PostgreSQL, e dalla replica logica nativa di PostgreSQL, aggiunta in PostgreSQL 10.
Il formato in cui le modifiche vengono trasmesse in streaming può essere configurato con diversi plug-in. Ciò consente architetture flessibili di acquisizione dei dati sulle modifiche (CDC).
Ad esempio, l'estensione wal2json consente di trasmettere in streaming tutte le modifiche di un database a un consumer, in formato JSON. Cloud SQL supporta il decodificatore pgoutput integrato, il modulo contrib test_decoding e wal2json. Al momento Cloud SQL supporta entrambe le varianti wal2json dell'output JSON: format-version 1 che codifica l'intera transazione come un singolo oggetto JSON e format-version 2 che genera un oggetto JSON per comando. Questi plug-in consentono la replica a database non PostgreSQL.
Configura l'istanza PostgreSQL
PostgreSQL supporta la decodifica logica scrivendo informazioni aggiuntive nel suo log write-ahead (WAL).
In Cloud SQL, puoi attivare questa funzionalità impostando il flag cloudsql.logical_decoding su on. Questa impostazione è diversa da quella utilizzata in PostgreSQL standard.
Se modifichi un'istanza PostgreSQL esterna, attiva questa funzionalità impostando il parametro di configurazione wal_level su logical.
Se prevedi di utilizzare l'estensione pglogical, pglogical deve essere aggiunto a
shared_preload_libraries. Poiché Cloud SQL non consente la modifica diretta di questo flag, pglogical viene attivato impostando cloudsql.enable_pglogical su on. (su una VM, sudo apt-get install postgresql-13-pglogical) e riavvia il database.
Se utilizzi pglogical per eseguire la replica tra due istanze PostgreSQL, la decodifica logica deve essere abilitata solo sull'istanza principale e non sull'istanza della replica (a meno che l'istanza stessa non sia principale per altre repliche). Tuttavia, l'estensione pglogical deve essere attivata su entrambe le istanze. Per esempi di come vengono utilizzati i termini "principale" e "replica" e i relativi significati, consulta Informazioni sulla replica in Cloud SQL.
Attiva la connettività di rete
Assicurati che le istanze principali accettino le connessioni dall'istanza replica.
| Principale | Replica | Configurazione |
|---|---|---|
| Cloud SQL (IP pubblico) | Cloud SQL (IP pubblico) | Aggiungi l'indirizzo IP in uscita della replica alle reti autorizzate della principale. |
| Cloud SQL (IP privato) | Cloud SQL (IP privato) | Se entrambe le istanze si trovano nello stesso progetto Google Cloud, aggiungi l'
intervallo IP allocato della rete VPC della replica alla rete autorizzata che ospita le istanze.
Per trovare l'intervallo IP allocato nella console Google Cloud:
|
| Esterno | Cloud SQL | Puoi utilizzare il servizio Database Migration Service. |
| Cloud SQL | Esterno | Per ulteriori informazioni, consulta Configurare le repliche esterne. |
Ottenere l'indirizzo IP in uscita di un'istanza replica
Se l'istanza replica è un'istanza Cloud SQL e ha un indirizzo IP pubblico, esegui i passaggi che seguono per ottenere il relativo indirizzo IP in uscita.
Console
Apri la pagina Istanze Cloud SQL.
Accanto all'indirizzo IP pubblico della replica Cloud SQL, passa il mouse sopra la descrizione comando Altre informazioni e recupera l'indirizzo IP in uscita. Tieni presente che l'indirizzo IP in uscita non è quello visualizzato nella scheda principale della replica nella console Cloud.
Se l'istanza di replica non è un'istanza Cloud SQL, consulta la documentazione pertinente.
Per ulteriori informazioni su come ottenere l'indirizzo IP pubblico di un'istanza, consulta Ottenere l'indirizzo IP in uscita della replica Cloud SQL.
gcloud
Puoi utilizzare il seguente comando gcloud:
gcloud sql instances describe [REPLICA_NAME] --format="default(ipAddresses)"
Consenti connessioni
Se l'istanza principale è un'istanza Cloud SQL, puoi consentire l'accesso dall'indirizzo IP in uscita della replica aggiungendolo come rete autorizzata.
Attivare le connessioni di replica per PostgreSQL 9.6 e versioni precedenti
Se l'istanza principale non è in esecuzione in Cloud SQL ed è in esecuzione PostgreSQL 9.6 o versioni precedenti, devi assicurarti che il file pg_hba.conf
dell'istanza sia impostato per accettare le connessioni di replica. Aggiungi la seguente riga al file, utilizzando all all solo per i test iniziali. Per una maggiore sicurezza, limita gli utenti e gli indirizzi IP solo a quelli necessari, come in questo esempio:
host replication all all md5
Per ulteriori informazioni, consulta Il file pg_hba.conf.
Creare un utente di replica
Per utilizzare le funzionalità di decodifica logica, crea un utente PostgreSQL con l'attributo REPLICATION.
Esempi
CREATE USER replication_user WITH REPLICATION
IN ROLE cloudsqlsuperuser LOGIN PASSWORD 'secret';
In alternativa, puoi impostare questo attributo su un utente esistente:
ALTER USER existing_user WITH REPLICATION;
Risorse PostgreSQL
Quando viene utilizzata la decodifica logica, un processo in background nell'istanza PostgreSQL principale trasforma le modifiche WAL in modifiche logiche, utilizzando il plug-in di decodifica selezionato, e le inoltra a un consumatore (che potrebbe anche essere un'istanza non PostgreSQL). Questo processo in background è chiamato mittente WAL. Il numero di mittenti WAL simultanei che possono essere attivi in un'istanza PostgreSQL è limitato dal flag max_wal_senders. Il valore predefinito di questo flag è 10 e il relativo limite aumenta in modo lineare con la memoria dell'istanza Cloud SQL, consentendo 8 mittenti WAL per GB di memoria.
Per assicurarsi che i segmenti WAL non vengano eliminati prima di essere inviati a tutti i consumatori, PostgreSQL utilizza gli slot di replica logica per monitorare i dati inviati a ciascun consumatore (e gli slot di replica fisici per le repliche di lettura). Il numero di slot di replica che puoi creare per un'istanza PostgreSQL è limitato dal flag max_replication_slots. Il valore predefinito di questo flag è 10 e il relativo limite aumenta con la memoria dell'istanza Cloud SQL, consentendo da 2 a 8 slot di replica per GB di memoria.
La seguente tabella mostra la relazione tra la memoria massima di un'istanza Cloud SQL e gli slot di replica massimi per l'istanza.
In genere esiste uno slot di replica e un mittente WAL per consumatore, pertanto questi indicatori devono essere impostati su valori approssimativamente uguali. Tuttavia, PostgreSQL consiglia di fornire un piccolo buffer per max_wal_senders da gestire quando le connessioni si interrompono in modo imprevisto e vengono create nuove connessioni. La replica fisica, utilizzata dalle repliche di lettura Cloud SQL, utilizza anche uno slot di replica e un mittente WAL, quindi conteggiali quando calcoli quante risorse di ogni tipo ti occorrono.
La replica logica nativa di PostgreSQL e pglogical richiedono l'esecuzione di processi aggiuntivi in background, sia nelle istanze principali che nelle repliche. Il numero di processi in background che possono essere eseguiti è limitato dal max_worker_processes. Il valore predefinito è 8 e il limite aumenta in modo lineare con la memoria dell'istanza Cloud SQL, consentendo due processi aggiuntivi per GB di memoria. Il numero esatto di processi worker utilizzati con questi approcci è spiegato nelle rispettive sezioni.
Se questo flag è impostato su un valore troppo basso e la replica non riesce con il messaggio di errore
worker registration failed nei log, probabilmente dovrai
aumentare l'impostazione max_worker_processes.
Tieni presente che i mittenti WAL non vengono conteggiati come processi di lavoro. I worker generati per l'esecuzione di query parallele vengono conteggiati, pertanto se il valore di max_worker_processes è impostato su un valore troppo basso, potresti riscontrare prestazioni scadenti perché PostgreSQL non può sfruttare l'esecuzione di query parallele.
Utilizzando la funzione pg_ls_waldir (),
puoi determinare l'utilizzo del disco WAL. Questa funzione è limitata agli utenti cloudsqlsuperuser, ad esempio l'utente amministratore predefinito postgres. Questa funzione è disponibile solo in PostgreSQL versione 10 e successive.
Per calcolare l'utilizzo totale del disco WAL:
postgres=> select * from pg_ls_waldir();
| nome | dimensioni | modifica |
|---|---|---|
| 00000001000000000000000A | 16777216 | 11-08-2021 15:16:49+00 |
| 000000010000000000000009 | 16777216 | 12-08-2021 06:23:24+00 |
(2 righe)
postgres=> select pg_size_pretty(sum(size)) as "Total WAL disk usage" from pg_ls_waldir();
| Utilizzo totale del disco WAL |
|---|
| 32 MB |
(1 riga)
Configurare la replica logica con una replica esterna
Consulta Configurazione delle repliche esterne per un esempio completo che utilizza pglogical e la decodifica logica.
Configurare la replica logica con pglogical
Per configurare la replica logica con pglogical, la decodifica logica deve essere attivata
sull'istanza principale. Imposta cloudsql.logical_decoding=on sull'istanza Cloud SQL o wal_level=logical su un'istanza esterna. Inoltre,
pglogical deve essere abilitato sia nell'istanza principale che in quella di replica; imposta
cloudsql.enable_pglogical=on su un'istanza Cloud SQL o aggiungi pglogical a
shared_preload_libraries su un'istanza esterna. Tieni presente che la modifica di questi flag richiede il riavvio sia dell'istanza principale sia di quella di replica.
Se riscontri problemi con questi passaggi, consulta Risolvere i problemi relativi a pglogical.
Creare un utente con privilegi di replica
Quando utilizzi pglogical, devi avere un utente con privilegi di replica e il ruolo cloudsqlsuperuser su entrambe le istanze principali e di replica. Tutti i comandi
descritti di seguito devono essere eseguiti da questo utente.
Installa l'estensione pglogical
Devi installare l'estensione pglogical sia sull'istanza principale sia su quella di replica. Sul principale, l'utente di replica (ovvero l'utente che si connette al database) deve installarlo.
CREATE EXTENSION pglogical;
Crea un nodo pglogical su ogni istanza
Un nodo pglogical rappresenta un'istanza PostgreSQL fisica e memorizza i dettagli di connessione per quell'istanza. Sia l'istanza principale sia l'istanza replica devono registrarsi come nodi:
source-instance$ SELECT pglogical.create_node(
node_name := 'primary',
dsn := 'host=<primary-ip> port=5432 dbname=postgres user=replication_user password=secret'
);
dest-instance$ SELECT pglogical.create_node(
node_name := 'replica',
dsn := 'host=<replica-ip> port=5432 dbname=postgres user=replication_user password=secret'
);
Crea una tabella con i dati da replicare
L'estensione pglogical consente di replicare solo un sottoinsieme di tabelle in una destinazione. Ad esempio, creeremo una tabella simulata nell'istanza principale e la completeremo con alcuni dati da testare:
CREATE TABLE replica_test (id SERIAL PRIMARY KEY, data text);
INSERT INTO replica_test (data) VALUES ('apple'), ('banana'), ('cherry');
La tabella deve essere creata anche nell'istanza replica.
Aggiungi la tabella a un set di replica
Per supportare la replica di set di dati diversi in destinazioni diverse, pglogical ha il concetto di un set di replica. Possiamo aggiungere la tabella di test al set di replica predefinito.
SELECT pglogical.replication_set_add_table('default', 'replica_test', true);
Crea la sottoscrizione pglogical
Crea l'abbonamento pglogical sull'istanza di destinazione fornendo i dettagli di connessione all'istanza principale.
SELECT pglogical.create_subscription(
subscription_name := 'test_sub',
provider_dsn := 'host=<primary-ip> port=5432 dbname=postgres user=replication_user password=replicapassword'
);
SELECT * FROM pglogical.show_subscription_status('test_sub');
Se lo stato visualizzato è "In corso di replica", la configurazione è andata a buon fine. Esegui una query sulla tabella
replica_test per assicurarti che i dati siano stati replicati. Inserisci e modifica
i record nell'istanza principale e verifica che vengano visualizzati nell'istanza
di replica.
Nella tabella principale, esegui una query sulla tabella pg_replication_slots per visualizzare lo slot di replica creato dalla sottoscrizione.
Esegui la pulizia
Una volta completato il test, elimina l'abbonamento sulla replica utilizzando
pglogical.drop_subscription('test_sub'). Verifica che lo slot di replica sia stato eliminato anche sulla principale. In caso contrario, i segmenti WAL continuano ad accumularsi sull'istanza di replica.
Per saperne di più su set di replica, replica dei dati parziale, replica DDL, altre configurazioni avanzate e limitazioni, consulta la documentazione di pglogical.
Utilizzo delle risorse
L'estensione pglogical esegue più processi in background che vengono conteggiati ai fini del limite di max_worker_processes.
In stato stabile, esegue un processo "supervisor" se abilitato, un processo "manager" per ogni database PostgreSQL in cui è installata l'estensione (ad esempio, potrebbero essercene D) e un processo "apply" per ogni abbonamento pglogical nell'istanza replica (ad esempio, potrebbero essercene D).S
Tuttavia, l'estensione potrebbe generare processi di lavoro aggiuntivi durante l'esecuzione di una sincronizzazione iniziale e, in effetti, genera processi "di gestione" per ogni database nell'istanza, ma se nel database non è installata l'estensione, esce immediatamente.
Di conseguenza, alloca un numero maggiore di processi di lavoro rispetto a quanto necessario in stato stazionario. I processi di lavoro vengono utilizzati da PostgreSQL per altri scopi, ad esempio l'elaborazione di query in parallelo. Se max_worker_processes è impostato su un valore troppo basso, la replica potrebbe non riuscire in modo silenzioso o PostgreSQL potrebbe non essere in grado di eseguire l'elaborazione parallela delle query.
In sintesi, ti consigliamo di impostare i seguenti valori:
max_worker_processes
>= 1 + D + 8 (on the source instance)
>= 1 + D + S + 8 (on the destination instance)
max_wal_senders >= S + 2 (on the source instance)
max_replication_slots >= S (on the source instance)
Risolvere i problemi di pglogical
Impossibile creare l'estensione pglogical
Quando provi a installare l'estensione pglogical, potresti visualizzare l'errore:
ERROR: pglogical is not in shared_preload_libraries
Quando installi pglogical su un'istanza Cloud SQL, assicurati di aver impostato
cloudsql.enable_pglogical=on. Se utilizzi un'istanza esterna, aggiungila direttamente al flag shared_preload_libraries, ad esempio shared_preload_libraries=pg_stat_statements,pglogical.
Queste modifiche richiedono il riavvio dell'istanza principale.
Impossibile creare l'abbonamento pglogical
Quando crei un abbonamento, pglogical verifica innanzitutto di poter utilizzare i dettagli di connessione per connettersi all'istanza. Innanzitutto, tenta di creare una connessione normale e, se non riesce, si verifica un errore: ERROR: could not
connect to the postgresql server.
Se si verifica questo errore, assicurati che l'istanza principale sia configurata per consentire le connessioni dall'istanza replica e che i dettagli di connessione forniti siano corretti. Vengono forniti ulteriori dettagli sul motivo per cui PostgreSQL non è stato in grado di stabilire una connessione.
Dopo aver creato una connessione normale, pglogical tenta di creare una connessione di replica speciale. In PostgreSQL 9.6 e versioni precedenti, questo tipo di connessione potrebbe avere una configurazione di autenticazione diversa. Se viene visualizzato questo errore: ERROR: could
not connect to the postgresql server in replication mode, devi aggiornare il file pg_hba.conf nell'istanza di origine.
Il file pg_hba.conf utilizzato da Cloud SQL contiene già le modifiche necessarie.
Questo errore si verifica solo quando ci si connette a un'istanza esterna non gestita da Cloud SQL.
In alternativa, la connessione in modalità di replica potrebbe non riuscire se l'istanza di origine
non consente mittenti WAL sufficienti. Se vedi FATAL: number of requested
standby connections exceeds max_wal_senders, aumenta max_wal_senders sull'istanza principale.
L'abbonamento pglogical non è attivo
La replica di un abbonamento pglogical potrebbe non riuscire. Per risolvere il problema, assicurati innanzitutto che un processo in background sia in esecuzione nell'istanza replica. Esegui una query su
pg_stat_activity per verificare che un processo pglogical apply sia in esecuzione. In caso contrario, controlla i log sul nodo di destinazione. Se vedi il messaggio worker
registration failed,, puoi aumentare l'impostazione max_worker_processes.
Assicurati quindi di aver creato uno slot di replica nell'istanza principale. Nell'istanza replica, la riga in pglogical.subscription contiene il nome dello slot che l'abbonamento tenta di creare e nell'istanza principale puoi eseguire query su pg_replication_slots per verificare che lo slot sia stato creato correttamente.
Se non è stato creato uno slot di replica, controlla i log nell'istanza principale.
Un errore ERROR: logical decoding requires wal_level >= logical implica
che il flag wal_level non è stato impostato su logical. Per risolvere il problema, imposta cloudsql.logical_decoding=on sull'istanza principale se si tratta di un'istanza Cloud SQL.
In alternativa, se l'istanza è esterna, imposta wal_level=logical.
In caso contrario, potresti visualizzare ERROR: all replication slots are in use, insieme al utile HINT: Free one or increase max_replication_slots.
Configurare la replica logica nativa di PostgreSQL
A partire da PostgreSQL 10, PostgreSQL supporta la replica logica integrata nativa. Per configurare la replica logica nativa, la decodifica logica deve essere abilitata sull'istanza principale impostando cloudsql.logical_decoding=on su un'istanza Cloud SQL o wal_level=logical su un'istanza esterna. Tieni presente che la modifica di questi flag richiede il riavvio dell'istanza principale.
Assicurati che le istanze siano configurate correttamente (per la connettività di rete e così via) esaminando le sezioni di Configurare l'istanza PostgreSQL. Questa pagina fornisce i passaggi per una prova di concetto. Se riscontri problemi durante la procedura descritta in queste sezioni, consulta Risolvere i problemi di pglogical. Per ulteriori informazioni, consulta la sezione Replicazione logica nella documentazione di PostgreSQL.
Crea una tabella con i dati da replicare
La replica logica PostgreSQL nativa supporta un intero database o solo singole tabelle. Ad esempio, creeremo una tabella fittizia nell'istanza principale e la completeremo con i dati da testare.
CREATE TABLE native_test (id SERIAL PRIMARY KEY, data text);
INSERT INTO native_test (data) VALUES ('apple'), ('banana'), ('cherry');
La tabella deve essere creata anche nell'istanza replica.
Creare una pubblicazione nell'istanza principale
La replica logica nativa di PostgreSQL gestisce publisher e sottoscrittori.
Crea una pubblicazione dei dati in native_test:
CREATE PUBLICATION pub FOR TABLE native_test;
Crea una sottoscrizione nell'istanza replica
Ecco un esempio di creazione di un abbonamento nell'istanza replica:
CREATE SUBSCRIPTION sub
CONNECTION 'host=<primary-ip> port=5432 dbname=postgres user=replication_user password=replicapassword'
PUBLICATION pub;
Per creare l'abbonamento nell'istanza di replica è necessario il ruolo cloudsqlsuperuser. Dopo aver creato l'abbonamento, esegui una query sulla tabella native_test per verificare che i dati siano visualizzati nell'istanza della replica.
Nella tabella principale, puoi eseguire query sulla tabella pg_replication_slots per visualizzare lo slot di replica creato dall'abbonamento.
Esegui la pulizia
Una volta superato il test, inserisci l'abbonamento nella replica utilizzando DROP
SUBSCRIPTION sub;. Verifica che lo slot di replica venga eliminato anche sul primario. In caso contrario, i segmenti WAL continuano ad accumularsi nell'istanza principale.
Limitazioni alla replica logica nativa di PostgreSQL
L'accesso alla colonna subconninfo della tabella di sistema
pg_subscription
non è disponibile.
L'esecuzione di pg_dump non può scaricare le informazioni sugli abbonamenti perché controlla se l'utente che si connette dispone delle autorizzazioni di superutente.
Ricevere modifiche WAL decodificate per Change Data Capture (CDC)
Come caso d'uso alternativo per la tecnologia CDC, la decodifica logica può trasmettere le modifiche da un'istanza PostgreSQL. Lo strumento standard utilizzato per questo scopo è pg_recvlogical.
Puoi utilizzare lo strumento pg_recvlogical per creare uno slot di replica e per eseguire lo streaming delle modifiche monitorate da questo slot. Il formato delle modifiche è determinato dalla scelta del plug-in di decodifica. Puoi utilizzare:
wal2json per eseguire lo streaming delle modifiche formattate come JSON oppure
test_decoding per eseguire lo streaming delle modifiche formattate con un formato di testo essenziale
Crea uno slot di replica
Per creare uno slot di replica, esegui:
pg_recvlogical
-h <instance_ip> \
-U <replication_user> \
-p 5432 \
-d postgres \
--slot test_slot \
--create-slot \
-P <decoder_plugin>
Modifiche allo stream
In un terminale Cloud Shell, esegui:
pg_recvlogical
-h <instance_ip> \
-U <replication_user> \
-p 5432 \
-d postgres \
--slot test_slot \
--start \
-f -
In un altro terminale Cloud Shell, connettiti al tuo database ed esegui i seguenti comandi:
CREATE TABLE cdc_test (id SERIAL PRIMARY KEY, data text);
INSERT INTO cdc_test (data) VALUES ('apple', 'banana');
UPDATE cdc_test SET data = 'cherry' WHERE id = 2;
DELETE FROM cdc_test WHERE id = 1;
DROP TABLE cdc_test;
Se utilizzi il plug-in di decodifica wal2json, nel primo terminale Cloud Shell viene visualizzato un output simile al seguente:
{"change":[]}
{"change":[{"kind":"insert","schema":"public","table":"cdc_test","columnnames":["id","data"],"columntypes":["integer","text"],"columnvalues":[1,"apple"]},{"kind":"insert","schema":"public","table":"cdc_test","columnnames":["id","data"],"columntypes":["integer","text"],"columnvalues":[2,"banana"]}]}
{"change":[{"kind":"update","schema":"public","table":"cdc_test","columnnames":["id","data"],"columntypes":["integer","text"],"columnvalues":[2,"cherry"],"oldkeys":{"keynames":["id"],"keytypes":["integer"],"keyvalues":[2]}}]}
{"change":[{"kind":"delete","schema":"public","table":"cdc_test","oldkeys":{"keynames":["id"],"keytypes":["integer"],"keyvalues":[1]}}]}
{"change":[]}
Se utilizzi il plug-in di decodifica test_decoding, nel primo terminale Cloud Shell viene visualizzato un output simile al seguente:
BEGIN 19460
COMMIT 19460
BEGIN 19461
table public.cdc_test: INSERT: id[integer]:1 data[text]:'apple'
table public.cdc_test: INSERT: id[integer]:2 data[text]:'banana'
COMMIT 19461
BEGIN 19462
table public.cdc_test: UPDATE: id[integer]:2 data[text]:'cherry'
COMMIT 19462
BEGIN 19463
table public.cdc_test: DELETE: id[integer]:1
COMMIT 19463
BEGIN 19464
COMMIT 19464
(Gli ID transazione potrebbero essere diversi).
Esegui la pulizia
Al termine dei test, elimina lo slot di replica che hai creato eseguendo:
pg_recvlogical
-h <instance_ip> \
-U <replication_user> \
-p 5432 \
-d postgres \
--slot test_slot \
--drop-slot
Note e limitazioni
Le note e le limitazioni riportate in questa sezione si applicano alle funzionalità di replica e decodifica logica di Cloud SQL per PostgreSQL.
L'estensione
pglogicalnon funziona nelle istanze in cui è attivata l'applicazione dei connettori. Questa limitazione non si applica alle istanze in cui è configurato l'accesso privato ai servizi.Quando ripristini un'istanza in cui è attivato
cloudsql.logical_decodingocloudsql.enable_pglogicale che attualmente agisce come publisher per la replica logica, devi prima disattivare la replica su tutte le istanze di destinazione. In caso contrario, il ripristino nell'istanza non va a buon fine e viene visualizzato un errore, ma al momento i dettagli dell'errore non sono visibili.Quando ripristini un backup di un'istanza in cui erano abilitati
cloudsql.logical_decodingocloudsql.enable_pglogical(al momento del backup) e lo stai ripristinando in una nuova istanza, lo stato di replica non viene ripristinato nella nuova istanza. Successivamente, dovrai riconfigurare manualmente la replica.In un'istanza Cloud SQL con una o più repliche di lettura Cloud SQL (utilizzando la replica fisica), se attivi
cloudsql.logical_decodingocloudsql.enable_pglogical, questi flag vengono attivati anche sulla replica di lettura.Le istanze di replica di lettura Cloud SQL non possono fungere da publisher per la replica logica perché PostgreSQL non supporta la decodifica logica nelle repliche di lettura. Tuttavia, i flag vengono attivati sull'istanza della replica di lettura per assicurarsi che possa sostituire l'istanza principale se e quando viene promossa.
L'attivazione di
cloudsql.logical_decodingocloudsql.enable_pglogicalsull'istanza principale comporta l'attivazione degli indicatori su tutte le repliche di lettura, con conseguente riavvio delle repliche principali e di lettura in rapida successione. Per evitare questa situazione e controllare quando viene riavviata ciascuna istanza, puoi (1) impostare i flag su ogni replica di lettura in sequenza e solo successivamente (2) impostare i flag sull'istanza principale.La disattivazione di
cloudsql.logical_decodingocloudsql.enable_pglogicalnell'istanza principale non comporta la disattivazione degli indicatori su tutte le repliche di lettura. Per disattivare gli indicatori nelle istanze, devi eseguire la procedura opposta a quella descritta sopra: (1) disattiva gli indicatori nell'istanza principale e poi (2) disattiva gli indicatori in ciascuna replica di lettura.