Cette page a été traduite par l'API Cloud Translation.

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.

Lancez le conteneur du proxy :

Activez Cloud Shell dans le projet client.
Exécutez le script suivant pour créer le proxy TCP et désactiver la mise en réseau en pont afin d'éviter les problèmes de connectivité :

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'

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
  --metadata=startup-script='#! /bin/bash
  mkdir -p /etc/docker
  cat <<EOF > /etc/docker/daemon.json
  {"bridge":"none"}
  EOF
  systemctl restart docker'

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.
Utilisez cette adresse IP dans la configuration du profil de connexion Datastream.

(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

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

Remarque :La mise à jour de l'option alloydb.logical_decoding redémarre l'instance.
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.
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;
```
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 indiquer 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 les tables que vous créerez à l'avenir :
```
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;
```
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 fournir ce nom lorsque vous créerez un flux dans Datastream l'assistant de création de flux.

Créer un utilisateur Datastream

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 souhaité à créer.
- USER_PASSWORD: mot de passe de connexion de l'utilisateur Datastream que vous souhaitez créer.
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
La première commande peut entraîner l'affichage d'avertissements, mais vous pouvez les ignorer.

Étape suivante

Découvrez comment Datastream fonctionne avec les sources PostgreSQL.