Configurer une base de données AlloyDB pour PostgreSQL

Les sections suivantes expliquent comment configurer une base de données AlloyDB pour PostgreSQL.

Configurer la connectivité entre Datastream et AlloyDB

Pour permettre à Datastream de se connecter à l'instance AlloyDB, vous devez configurer un proxy TCP dans le projet client. L'image de proxy TCP est disponible pour tous les clients.

  1. Lancez le conteneur du proxy :

    1. Activez Cloud Shell dans le projet client.
    2. Exécutez le script suivant pour créer le proxy TCP:
    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
    

    Remplacez les éléments suivants :

    • REGION_ID: région dans laquelle vous souhaitez créer le proxy TCP.
    • VM_NAME: nom de la machine virtuelle.
    • ALLOYDB_IP: adresse IP de l'instance AlloyDB pour PostgreSQL.
    • ALLOYDB_PORT: numéro de port de l'instance AlloyDB pour PostgreSQL.
    • SOURCE_AND_DEST_VPC: réseau VPC auquel la source et la destination sont connectées.
    • VM_TIER: type de votre machine virtuelle.

    Exemple de commande avec des paramètres mis à jour :

    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
    
  2. Exécutez le script pour imprimer l'adresse IP du proxy TCP avec les entrées suivantes :

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

    Remplacez les éléments suivants :

    • VM_NAME: nom de votre machine virtuelle.
    • REGION_ID: région dans laquelle vous avez créé le proxy TCP.
  3. (Facultatif) Créez une règle de pare-feu pour limiter le trafic entrant vers le 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
    

    Remplacez les éléments suivants :

    • FIREWALL_RULE_NAME: nom de votre règle de pare-feu
    • SOURCE_VPC: réseau VPC auquel votre source est connectée.
    • ALLOYDB_PORT: numéro de port de l'instance AlloyDB pour PostgreSQL.
    • IP_RANGE: plage d'adresses IP à laquelle vous souhaitez limiter le trafic entrant.

    Exemple de commande autorisant le trafic entrant provenant de toutes les adresses IP :

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

Configurer AlloyDB pour la réplication

  1. Activez le décodage logique pour l'instance principale AlloyDB. Dans Google Cloud, définissez la valeur de l'option alloydb.logical_decoding sur ON. Pour en savoir plus sur la mise à jour des indicateurs de base de données, consultez Configurer les indicateurs de base de données d'une instance.

  2. Connectez-vous à l'instance AlloyDB à l'aide de l'adresse IP du proxy TCP en exécutant la commande suivante à partir de n'importe quelle VM du même VPC:

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

    Remplacez les éléments suivants :

    • PROXY_IP: adresse IP du proxy TCP.
    • DB_USER: nom d'utilisateur de la base de données AlloyDB.
    • DB_NAME: nom de la base de données AlloyDB.
  3. Exécutez la commande suivante pour accorder des droits de réplication à votre utilisateur de base de données:

    ALTER USER DB_USER WITH REPLICATION;
    
  4. Créez une publication. Nous vous recommandons de créer une publication uniquement pour les tables que vous souhaitez répliquer. Cela permet à Datastream de lire uniquement les données pertinentes, et de réduire la charge sur la base de données et Datastream:

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

    Remplacez les éléments suivants :

    • PUBLICATION_NAME: nom de votre publication. Vous devrez fournir ce nom lorsque vous créerez un flux dans l'assistant de création de flux Datastream.
    • SCHEMA: nom du schéma contenant la table.
    • TABLE: nom de la table que vous souhaitez répliquer.

    Vous pouvez créer une publication pour toutes les tables d'un schéma. Cette approche vous permet de répliquer les modifications apportées aux tables de la liste de schémas spécifiée, y compris aux tables que vous créerez par la suite:

    CREATE PUBLICATION PUBLICATION_NAME
    FOR TABLES IN SCHEMA1, SCHEMA2;

    Vous pouvez également créer une publication pour toutes les tables de votre base de données. Notez que cette approche augmente la charge sur la base de données source et sur Datastream:

    CREATE PUBLICATION PUBLICATION_NAME FOR ALL TABLES;
    
  5. Créez un emplacement de réplication en exécutant la commande suivante.

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

    Remplacez les éléments suivants :

    • REPLICATION_SLOT_NAME: nom de votre emplacement de réplication. Vous devrez indiquer ce nom lorsque vous créerez un flux dans l'assistant de création de flux Datastream.

Créer un utilisateur Datastream

  1. Pour créer un utilisateur Datastream, saisissez la commande PostgreSQL suivante :

    CREATE USER USER_NAME WITH REPLICATION LOGIN PASSWORD 'USER_PASSWORD';
    

    Remplacez les éléments suivants :

    • USER_NAME: nom de l'utilisateur Datastream que vous souhaitez créer.
    • USER_PASSWORD: mot de passe de connexion de l'utilisateur Datastream que vous souhaitez créer.
  2. Accordez les droits suivants à l'utilisateur que vous avez créé :

    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;
    

    Remplacez les éléments suivants :

    • SCHEMA_NAME: nom du schéma auquel vous souhaitez accorder les droits.
    • USER_NAME: utilisateur auquel vous souhaitez accorder les droits