Es posible que parte de la información de esta página (o toda) no se aplique a Trusted Cloud de S3NS.

Se usó la API de Cloud Translation para traducir esta página.

Configurar réplicas externas

MySQL | PostgreSQL | SQL Server

En esta página, se describe cómo configurar una instancia de Cloud SQL para replicar a una réplica externa de Cloud SQL mediante la extensión pglogical con logical decoding.

Para obtener más información sobre la replicación, consulta Acerca de la replicación en Cloud SQL.

Establece la configuración de la réplica externa

Antes de comenzar

Antes de comenzar con esta tarea, debes contar con una instancia de Cloud SQL y una instancia externa de PostgreSQL que cumpla con los requisitos para réplicas externas.

Requisitos de la instancia de origen

La instancia de origen de una réplica de lectura externa debe ser una instancia principal o independiente. No puedes usar una réplica de lectura de Cloud SQL como instancia de origen para una réplica de lectura externa. A veces, las réplicas de lectura se vuelven a crear a partir del clon de disco de su instancia principal, y la réplica de lectura no puede mantener su estado de replicación en una réplica de lectura externa.

Configura la instancia principal

Ve a la página Instancias de Cloud SQL en la Trusted Cloud consola.
En la instancia principal, habilita el acceso de la dirección IP de la réplica externa.
Si quieres obtener más información sobre cómo habilitar el acceso de IP, consulta Configura el acceso para conexiones IP públicas.
Registra la dirección IP pública y la dirección IP saliente pública de la instancia principal para usarla más adelante. Puedes encontrar estos valores en la página Descripción general de la instancia.
Haz clic en el ícono de Cloud Shell () en la esquina superior derecha.
En el mensaje de Cloud Shell, usa el cliente PostgreSQL incorporado para conectarte a tu instancia principal:
```
   
gcloud sql connect PRIMARY_INSTANCE_NAME \
--user=postgres
   
   
```
Ingresa tu contraseña raíz. Deberías ver el mensaje de postgres.

Crea un usuario de PostgreSQL con el atributo REPLICATION.

CREATE USER REPLICATION_USER WITH REPLICATION IN ROLE cloudsqlsuperuser LOGIN PASSWORD 'REPLICATION_USER_PASSWORD';

Instala y configura la extensión pglogical:
Edita la instancia de Cloud SQL para agregar y configurar las siguientes marcas:
- cloudsql.enable_pglogical
- cloudsql.logical_decoding
- max_replication_slots
- max_worker_processes
- max_wal_senders
- Para obtener más información sobre estas marcas, consulta la página Recursos de PostgreSQL.
Reinicia la base de datos, accede, cambia a replication_user y crea la extensión pglogical:
```
CREATE EXTENSION pglogical;
   
```

Crea un nodo pglogical:

Un _node_ pglogical representa una instancia física de PostgreSQL y almacena los detalles de conexión para esa instancia.

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'
   );

Si estás comenzando con una base de datos nueva, crea la misma base de datos y las mismas tablas en las instancias principal y de réplica. Por ejemplo:

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;

Si ya tienes una base de datos en la instancia principal, debes crear la misma en la réplica. Para ello, exporta la base de datos de la instancia principal a un bucket de Cloud Storage y, luego, impórtala en la réplica. Obtén más información sobre la exportación de datos desde Cloud SQL a un archivo de volcado de SQL en Cloud Storage.
Para admitir la replicación de diferentes conjuntos de datos en diferentes destinos, pglogical tiene el concepto de un conjunto de replicación. Por ejemplo, para agregar una tabla al conjunto de replicación predeterminado:
```
SELECT pglogical.replication_set_add_table('default', 'replica_test', true);
   
```

Configura la réplica externa

Crea un usuario especial para la replicación y otorga privilegios de replicación:

CREATE USER REPLICATION_USER WITH REPLICATION SUPERUSER LOGIN PASSWORD 'REPLICATION_USER_PASSWORD';

Si comienzas con una base de datos nueva, usa REPLICATION_USER para crear la misma base de datos y las mismas tablas en las instancias principal y de réplica. Por ejemplo:

CREATE DATABASE test;
\connect test;
CREATE TABLE replica_test (id SERIAL PRIMARY KEY, data text);
INSERT INTO replica_test (data) VALUES ('apple'), ('banana'), ('cherry');

Si propagas la instancia de réplica externa con un archivo que exportaste desde la instancia principal, descarga el archivo exportado desde Cloud Storage. Si tu réplica externa está en una instancia de Compute Engine, puedes descargar el archivo con el comando gcloud storage:
```
gcloud storage cp gs://BUCKET_NAME/DUMP_FILE_NAME .
    
```

Importa el archivo a la base de datos.

psql --user=postgres --password < DUMP_FILE_NAME.

Instala pglogical según tu SO. Por ejemplo, en sistemas Debian que ejecutan la versión 13 de PostgreSQL, sudo apt-get install postgresql-13-pglogical.

Accede a la base de datos como replication_user y configura los siguientes parámetros:

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 # execute CREATE 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 una suscripción a 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'
);

Verifica el estado de la suscripción:

SELECT * FROM pglogical.show_subscription_status('SUBSCRIPTION_NAME');

Si el estado aparece como replicating, la configuración se realizó correctamente.
Inserta algunos datos en la instancia principal y verifica la instancia de réplica para asegurarte de que los datos también aparezcan allí.

Solucionar problemas

Consulta Solución de problemas de pglogical

¿Qué sigue?

Obtén información sobre cómo administrar réplicas.
Obtén más información sobre los requisitos y las prácticas recomendadas para la configuración de réplicas externas.
Obtén más información sobre la replicación en PostgreSQL.
Obtén más información sobre la configuración de replicación.
Obtén más información sobre cómo replicar desde un servidor externo.