Configura una base de datos de AlloyDB para PostgreSQL

En las siguientes secciones, se explica cómo configurar una base de datos de AlloyDB para PostgreSQL.

Configura la conectividad entre Datastream y AlloyDB

Para permitir que Datastream se conecte a la instancia de AlloyDB, debes configurar un proxy TCP en el proyecto del consumidor. La imagen de proxy TCP está disponible de forma pública para todos los clientes.

  1. Inicia el contenedor del proxy:

    1. Activa Cloud Shell en el proyecto del consumidor.
    2. Ejecuta la siguiente secuencia de comandos para crear el proxy TCP y, luego, inhabilita la red de puente para evitar problemas de conectividad:
    gcloud compute instances create-with-container \
  --zone=REGION_ID VM_NAME \
  --container-image gcr.io/dms-images/tcp-proxy \
  --tags=dms-tcp-proxy \
  --container-env=SOURCE_CONFIG=ALLOYDB_IP:ALLOYDB_PORT \
  --can-ip-forward \
  --network=SOURCE_AND_DEST_VPC \
  --machine-type=VM_TIER \
  --metadata=startup-script='#! /bin/bash
  mkdir -p /etc/docker
  cat <<EOF > /etc/docker/daemon.json
  {"bridge":"none"}
  EOF
  systemctl restart docker'

    Reemplaza lo siguiente:

    • REGION_ID: Es la región en la que deseas crear el proxy TCP.
    • VM_NAME: Es el nombre de la máquina virtual.
    • ALLOYDB_IP: Es la dirección IP de la instancia de AlloyDB para PostgreSQL.
    • ALLOYDB_PORT: Es el número de puerto de la instancia de AlloyDB para PostgreSQL.
    • SOURCE_AND_DEST_VPC: Es la red de VPC a la que están conectados el origen y el destino.
    • VM_TIER: Es el tipo de tu máquina virtual.

    Un comando de ejemplo con parámetros actualizados:

    gcloud compute instances create-with-container \
  --zone=us-central1-c ds-tcp-proxy \
  --container-image gcr.io/dms-images/tcp-proxy \
  --tags=ds-tcp-proxy \
  --container-env=SOURCE_CONFIG=10.16.0.5:5432 \
  --can-ip-forward \
  --network=default \
  --machine-type=e2-micro
  --metadata=startup-script='#! /bin/bash
  mkdir -p /etc/docker
  cat <<EOF > /etc/docker/daemon.json
  {"bridge":"none"}
  EOF
  systemctl restart docker'

  2. Ejecuta la secuencia de comandos para imprimir la dirección IP del proxy TCP con las siguientes entradas:

    gcloud compute instances describe VM_NAME \
  --format="yaml(networkInterfaces[].networkIP)" \
  --zone=REGION_ID

    Reemplaza lo siguiente:

    • VM_NAME: Es el nombre de tu máquina virtual.
    • REGION_ID: Es la región en la que creaste el proxy TCP.

  3. (Opcional) Crea una regla de firewall para limitar el tráfico de entrada al proxy TCP:

    gcloud compute firewall-rules create FIREWALL_RULE_NAME \
  --direction=INGRESS \
  --priority=1000 \
  --target-tags=dms-tcp-proxy \
  --network=SOURCE_VPC \
  --action=ALLOW \
  --rules=tcp:ALLOYDB_PORT \
  --source-ranges=IP_RANGE

    Reemplaza lo siguiente:

    • FIREWALL_RULE_NAME: Es el nombre de la regla de firewall.
    • SOURCE_VPC: Es la red de VPC a la que está conectada tu fuente.
    • ALLOYDB_PORT: Es el número de puerto de la instancia de AlloyDB para PostgreSQL.
    • IP_RANGE: Es el rango de direcciones IP al que deseas limitar el tráfico entrante.

    Un comando de ejemplo para permitir el tráfico de entrada desde todas las direcciones IP:

    gcloud compute firewall-rules create ds-proxy1 \
  --direction=INGRESS \
  --priority=1000 \
  --target-tags=ds-tcp-proxy \
  --network=default \
  --action=ALLOW \
  --rules=tcp:5432

Configura AlloyDB para la replicación

  1. Habilita la decodificación lógica para la instancia principal de AlloyDB. En Google Cloud, establece el valor de la marca alloydb.logical_decoding en ON. Para obtener información sobre cómo actualizar las marcas de la base de datos, consulta Configura las marcas de la base de datos de una instancia.

  2. Ejecuta el siguiente comando desde cualquier VM en la misma VPC para conectarte a la instancia de AlloyDB con la dirección IP del proxy TCP:

      psql -h PROXY_IP \
    -U DB_USER \
    -d DB_NAME

    Reemplaza lo siguiente:

    • PROXY_IP: Es la dirección IP del proxy TCP.
    • DB_USER: El nombre de usuario de la base de datos de AlloyDB.
    • DB_NAME: Es el nombre de la base de datos de AlloyDB.

  3. Ejecuta el siguiente comando para otorgar privilegios de replicación al usuario de tu base de datos:

    ALTER USER DB_USER WITH REPLICATION;

  4. Crea una publicación. Te recomendamos que crees una publicación solo para las tablas que quieras replicar. Esto permite que Datastream lea solo los datos relevantes y disminuya la carga en la base de datos y Datastream:

    CREATE PUBLICATION PUBLICATION_NAME
FOR TABLE SCHEMA1.TABLE1, SCHEMA2.TABLE2;

    Reemplaza lo siguiente:

    • PUBLICATION_NAME: El nombre de tu publicación. Deberás proporcionar este nombre cuando crees un flujo en el asistente de creación de flujos de Datastream.
    • SCHEMA: Es el nombre del esquema que contiene la tabla.
    • TABLE: Es el nombre de la tabla que deseas replicar.

    También puedes crear una publicación para todas las tablas de tu base de datos. Ten en cuenta que este enfoque aumenta la carga en la base de datos de origen y en Datastream:

    CREATE PUBLICATION PUBLICATION_NAME FOR ALL TABLES;

  5. Crea una ranura de replicación mediante la ejecución del siguiente comando.

    SELECT PG_CREATE_LOGICAL_REPLICATION_SLOT('REPLICATION_SLOT_NAME', 'pgoutput');

    Reemplaza lo siguiente:

    • REPLICATION_SLOT_NAME: Es el nombre de tu ranura de replicación. Deberás proporcionar este nombre cuando crees un flujo en el asistente de creación de flujos de Datastream.

Crea un usuario de Datastream

  1. Para crear un usuario de Datastream, ingresa el siguiente comando de PostgreSQL:

    CREATE USER USER_NAME WITH REPLICATION LOGIN PASSWORD 'USER_PASSWORD';

    Reemplaza lo siguiente:

    • USER_NAME: Es el nombre del usuario de Datastream que deseas crear.
    • USER_PASSWORD: La contraseña de acceso del usuario de Datastream que deseas crear.

  2. Otorga los siguientes privilegios al usuario que creaste:

    GRANT SELECT ON ALL TABLES IN SCHEMA SCHEMA_NAME TO USER_NAME;
GRANT USAGE ON SCHEMA SCHEMA_NAME TO USER_NAME;
ALTER DEFAULT PRIVILEGES IN SCHEMA SCHEMA_NAME GRANT SELECT ON TABLES TO USER_NAME;

    Reemplaza lo siguiente:

    • SCHEMA_NAME: Es el nombre del esquema al que deseas otorgar los privilegios.
    • USER_NAME: Es el usuario al que deseas otorgar los privilegios.

¿Qué sigue?