logical decoding
.
Per saperne di più sulla replica, consulta Informazioni sulla replica in Cloud SQL.
Configura la replica esterna
Prima di iniziare
Prima di iniziare questa attività, devi disporre di un'istanza Cloud SQL e di un'istanza PostgreSQL esterna che soddisfi i requisiti per le repliche esterne.
Configura l'istanza principale
- Vai alla pagina Istanze Cloud SQL nella console Google Cloud .
- Abilita l'accesso all'istanza primaria per l'indirizzo IP della replica esterna.
Per informazioni sull'attivazione dell'accesso IP, consulta la pagina Configurazione dell'accesso per connessioni IP.
- Registra l'indirizzo IP pubblico e l'indirizzo IP pubblico in uscita dell'istanza principale per utilizzarli in seguito. Puoi trovare questi valori nella pagina Panoramica dell'istanza.
- Fai clic sull'icona di Cloud Shell
nell'angolo in alto a destra.
- Al prompt di Cloud Shell, utilizza il client PostgreSQL integrato per
connetterti all'istanza primaria:
gcloud sql connect PRIMARY_INSTANCE_NAME \ --user=postgres
- Inserisci la password root. Dovresti quindi visualizzare il prompt di postgres.
- Crea un utente PostgreSQL con l'attributo
REPLICATION
.CREATE USER REPLICATION_USER WITH REPLICATION IN ROLE cloudsqlsuperuser LOGIN PASSWORD 'REPLICATION_USER_PASSWORD';
- Installa e configura l'estensione pglogical:
Modifica l'istanza Cloud SQL per aggiungere e impostare i seguenti flag:
cloudsql.enable_pglogical
cloudsql.logical_decoding
max_replication_slots
max_worker_processes
max_wal_senders
-
Per saperne di più su questi flag, consulta la pagina Risorse PostgreSQL.
Riavvia il database, poi accedi, passa a replication_user, crea l'estensione
pglogical
:CREATE EXTENSION pglogical;
- Crea un nodo pglogical:
Un _nodo_ pglogical rappresenta un'istanza PostgreSQL fisica e memorizza i dettagli di connessione per quell'istanza.
SELECT pglogical.create_node( node_name := 'provider', dsn := 'host=PRIMARY_PUBLIC_IP_ADDRESS port=5432 dbname=DATABASE_NAME user=REPLICATION_USER password=REPLICATION_USER_PASSWORD' );
- Se inizi con un nuovo database, crea lo stesso database e le stesse tabelle
sia nell'istanza primaria che in quella di replica. Ad esempio:
CREATE DATABASE test; \connect test; CREATE TABLE replica_test (id SERIAL PRIMARY KEY, data text); INSERT INTO replica_test (data) VALUES ('apple'), ('banana'), ('cherry'); CREATE EXTENSION pglogical;
- Se hai già un database nell'istanza primaria, devi creare lo stesso nella replica. Per farlo, esporta il database dall'istanza principale in un bucket Cloud Storage e importalo nella replica. Scopri di più su Esportazione di dati da Cloud SQL in un file di dump SQL in Cloud Storage.
-
Per supportare la replica di diversi set di dati in destinazioni diverse,
pglogical ha il concetto di set di replica. Ad esempio, per aggiungere una tabella
al set di replica predefinito:
SELECT pglogical.replication_set_add_table('default', 'replica_test', true);
Configura la replica esterna
- Crea un utente speciale per la replica e concedi i privilegi di replica:
CREATE USER REPLICATION_USER WITH REPLICATION SUPERUSER LOGIN PASSWORD 'REPLICATION_USER_PASSWORD';
- Se inizi con un nuovo database, utilizza
REPLICATION_USER per creare lo stesso database e
le stesse tabelle sia nell'istanza primaria sia in quella di replica. Ad esempio:
CREATE DATABASE test; \connect test; CREATE TABLE replica_test (id SERIAL PRIMARY KEY, data text); INSERT INTO replica_test (data) VALUES ('apple'), ('banana'), ('cherry');
- Se stai inizializzando l'istanza di replica esterna
con un file esportato dall'istanza primaria, scarica il
file esportato da Cloud Storage. Se la replica esterna si trova su un'istanza Compute Engine, puoi scaricare il file utilizzando il comando
gcloud storage
:gcloud storage cp gs://BUCKET_NAME/DUMP_FILE_NAME .
- Importa il file nel database.
psql --user=postgres --password < DUMP_FILE_NAME.
- Installa
pglogical
in base al tuo sistema operativo. Ad esempio, sui sistemi Debian che eseguono PostgreSQL versione 13,sudo apt-get install postgresql-13-pglogical
. - Accedi al database come replication_user e imposta i
seguenti parametri:
ALTER SYSTEM SET shared_preload_libraries = 'pglogical'; ALTER SYSTEM SET max_replication_slots = #; (where # is the same as you set on the primary). ALTER SYSTEM SET max_worker_processes = #; (where # is the same as you set on the primary). # Logout of the database and restart it. For example, #
sudo /etc/init.d/postgresql restart
# Log back in the database as the replication_user. # Since the pglogical extension is created local to each database, you need to # executeCREATE EXTENSION pglogical
in each database you create, so if you # haven't already done that: CREATE EXTENSION pglogical;For more information about these flags, see the PostgreSQL resources page.
- Crea un nodo pglogical:
SELECT pglogical.create_node( node_name := 'subscriber', dsn := 'host=REPLICA_PUBLIC_IP_ADDRESS port=5432 dbname=DATABASE_NAME user=REPLICATION_USER password=REPLICATION_USER_PASSWORD' );
- Crea un abbonamento pglogical:
SELECT pglogical.create_subscription( subscription_name := 'SUBSCRIPTION_NAME', provider_dsn := 'host=PRIMARY_PUBLIC_IP_ADDRESS port=5432 dbname=DATABASE_NAME user=REPLICATION_USER password=REPLICATION_USER_PASSWORD' );
- Controlla lo stato dell'abbonamento:
SELECT * FROM pglogical.show_subscription_status('SUBSCRIPTION_NAME');
- Se lo stato è
replicating
, la configurazione è andata a buon fine. - Inserisci alcuni dati nell'istanza primaria e controlla la replica per assicurarti che i dati vengano visualizzati anche lì.
Risoluzione dei problemi
Consulta la sezione Risoluzione dei problemi relativi a pglogicalPassaggi successivi
- Scopri come gestire le repliche.
- Scopri di più sui requisiti e sulle best practice per la configurazione della replica esterna.
- Scopri di più sulla replica PostgreSQL.
- Scopri di più sulle impostazioni di configurazione della replica.
- Scopri di più sulla replica da un server esterno.