GSP1084

Présentation

Dans Google Cloud, vous pouvez utiliser Database Migration Service pour migrer des bases de données PostgreSQL vers AlloyDB pour PostgreSQL. Pour ce faire, AlloyDB nécessite l'utilisation de l'accès aux services privés. Cet accès est implémenté sous la forme d'une connexion d'appairage VPC entre votre réseau VPC et le réseau VPC Google Cloud sous-jacent où résident vos ressources AlloyDB.

Dans cet atelier, vous ferez migrer une base de données PostgreSQL autonome (qui s'exécute sur une machine virtuelle) vers AlloyDB pour PostgreSQL en utilisant un job Database Migration Service continu ainsi que l'appairage de VPC pour assurer la connectivité.

La migration d'une base de données à l'aide de Database Migration Service nécessite de préparer la base de données source. Ces tâches ont été effectuées pour vous dans l'environnement source. La plus importante d'entre elles consiste à configurer le package pglogical sur l'instance source.

Après avoir créé et exécuté le job de migration, vous vérifierez qu'une copie initiale de votre base de données a bien été migrée sur l'instance AlloyDB pour PostgreSQL. Vous découvrirez également comment les jobs de migration continus transmettent les mises à jour de données effectuées dans la base de données source à l'instance AlloyDB pour PostgreSQL.

Objectifs de l'atelier

Dans cet atelier, vous apprendrez à configurer un job Database Migration Service continu pour migrer des bases de données d'une instance PostgreSQL vers AlloyDB pour PostgreSQL.

• Vérifier les données de l'instance source pour la migration
• Créer un profil de connexion source à une instance PostgreSQL (par exemple, PostgreSQL autonome)
• Créer et démarrer un job de migration continu
• Confirmer le chargement des données dans l'instance AlloyDB pour PostgreSQL
• Propager une mise à jour en temps réel à l'instance AlloyDB

Préparation

Avant de cliquer sur le bouton "Démarrer l'atelier"

Lisez ces instructions. Les ateliers sont minutés, et vous ne pouvez pas les mettre en pause. Le minuteur, qui démarre lorsque vous cliquez sur Démarrer l'atelier, indique combien de temps les ressources Google Cloud resteront accessibles.

Cet atelier pratique vous permet de suivre les activités dans un véritable environnement cloud, et non dans un environnement de simulation ou de démonstration. Des identifiants temporaires vous sont fournis pour vous permettre de vous connecter à Google Cloud le temps de l'atelier.

Pour réaliser cet atelier :

• Vous devez avoir accès à un navigateur Internet standard (nous vous recommandons d'utiliser Chrome).

Remarque : Ouvrez une fenêtre de navigateur en mode incognito (recommandé) ou de navigation privée pour effectuer cet atelier. Vous éviterez ainsi les conflits entre votre compte personnel et le compte temporaire de participant, qui pourraient entraîner des frais supplémentaires facturés sur votre compte personnel.

• Vous disposez d'un temps limité. N'oubliez pas qu'une fois l'atelier commencé, vous ne pouvez pas le mettre en pause.

Remarque : Utilisez uniquement le compte de participant pour cet atelier. Si vous utilisez un autre compte Google Cloud, des frais peuvent être facturés à ce compte.

Démarrer l'atelier et se connecter à la console Google Cloud

1. Cliquez sur le bouton Démarrer l'atelier. Si l'atelier est payant, une boîte de dialogue s'affiche pour vous permettre de sélectionner un mode de paiement. Sur la gauche, vous trouverez le panneau "Détails concernant l'atelier", qui contient les éléments suivants :

   • Le bouton "Ouvrir la console Google Cloud"
   • Le temps restant
   • Les identifiants temporaires que vous devez utiliser pour cet atelier
   • Des informations complémentaires vous permettant d'effectuer l'atelier

2. Cliquez sur Ouvrir la console Google Cloud (ou effectuez un clic droit et sélectionnez Ouvrir le lien dans la fenêtre de navigation privée si vous utilisez le navigateur Chrome).

   L'atelier lance les ressources, puis ouvre la page "Se connecter" dans un nouvel onglet.

   Conseil : Réorganisez les onglets dans des fenêtres distinctes, placées côte à côte.

   Remarque : Si la boîte de dialogue Sélectionner un compte s'affiche, cliquez sur Utiliser un autre compte.

3. Si nécessaire, copiez le nom d'utilisateur ci-dessous et collez-le dans la boîte de dialogue Se connecter.

   {{{user_0.username | "Username"}}}

   Vous trouverez également le nom d'utilisateur dans le panneau "Détails concernant l'atelier".

4. Cliquez sur Suivant.

5. Copiez le mot de passe ci-dessous et collez-le dans la boîte de dialogue Bienvenue.

   {{{user_0.password | "Password"}}}

   Vous trouverez également le mot de passe dans le panneau "Détails concernant l'atelier".

6. Cliquez sur Suivant.

   Important : Vous devez utiliser les identifiants fournis pour l'atelier. Ne saisissez pas ceux de votre compte Google Cloud. Remarque : Si vous utilisez votre propre compte Google Cloud pour cet atelier, des frais supplémentaires peuvent vous être facturés.

7. Accédez aux pages suivantes :

   • Acceptez les conditions d'utilisation.
   • N'ajoutez pas d'options de récupération ni d'authentification à deux facteurs (ce compte est temporaire).
   • Ne vous inscrivez pas à des essais sans frais.

Après quelques instants, la console Cloud s'ouvre dans cet onglet.

Remarque : Pour accéder aux produits et services Google Cloud, cliquez sur le menu de navigation ou saisissez le nom du service ou du produit dans le champ Recherche.

Activer Cloud Shell

Cloud Shell est une machine virtuelle qui contient de nombreux outils pour les développeurs. Elle comprend un répertoire d'accueil persistant de 5 Go et s'exécute sur Google Cloud. Cloud Shell vous permet d'accéder via une ligne de commande à vos ressources Google Cloud.

1. Cliquez sur Activer Cloud Shell  en haut de la console Google Cloud.

2. Passez les fenêtres suivantes :

   • Accédez à la fenêtre d'informations de Cloud Shell.
   • Autorisez Cloud Shell à utiliser vos identifiants pour effectuer des appels d'API Google Cloud.

Une fois connecté, vous êtes en principe authentifié et le projet est défini sur votre ID_PROJET : . Le résultat contient une ligne qui déclare l'ID_PROJET pour cette session :

Your Cloud Platform project in this session is set to {{{project_0.project_id | "PROJECT_ID"}}}

gcloud est l'outil de ligne de commande pour Google Cloud. Il est préinstallé sur Cloud Shell et permet la complétion par tabulation.

3. (Facultatif) Vous pouvez lister les noms des comptes actifs à l'aide de cette commande :

gcloud auth list

4. Cliquez sur Autoriser.

Résultat :

ACTIVE: * ACCOUNT: {{{user_0.username | "ACCOUNT"}}} To set the active account, run: $ gcloud config set account `ACCOUNT`

5. (Facultatif) Vous pouvez lister les ID de projet à l'aide de cette commande :

gcloud config list project

Résultat :

[core] project = {{{project_0.project_id | "PROJECT_ID"}}} Remarque : Pour consulter la documentation complète sur gcloud, dans Google Cloud, accédez au guide de présentation de la gcloud CLI.

Tâche 1 : Vérifier les données de l'instance source pour la migration

Vérifier les données de l'instance source

Dans cette étape, vous allez vous connecter à la base de données postgres sur l'instance de VM pg14-source et en vérifier les données.

1. Dans le menu de navigation (), sous Compute Engine, cliquez sur Instances de VM.

2. Pour l'instance nommée pg14-source, dans la colonne Connecter, cliquez sur SSH pour ouvrir une fenêtre de terminal.

3. Utilisez la commande suivante pour lancer le client PostgreSQL (psql).

sudo -u postgres psql

4. L'invite de terminal psql s'affiche, comme illustré ci-dessous.

psql (14.5 (Debian 14.5-1.pgdg110+1)) Type "help" for help.

5. Saisissez et exécutez la commande SQL suivante pour afficher les tables liées aux ressources humaines dans la base de données postgres.

\dt

6. Exécutez les requêtes suivantes pour déterminer le nombre de lignes de chaque table.

select count (*) as countries_row_count from countries; select count (*) as departments_row_count from departments; select count (*) as employees_row_count from employees; select count (*) as jobs_row_count from jobs; select count (*) as locations_row_count from locations; select count (*) as regions_row_count from regions;

7. Voici le nombre de lignes des tables sources :

Nom	Lignes
countries	25
services	27
employees	107
jobs	19
locations	23
regions	4

8. Saisissez \q pour quitter le client psql.

9. Saisissez exit pour fermer la fenêtre de terminal.

Tâche 2 : Créer un profil de connexion Database Migration Service pour une base de données PostgreSQL autonome

Dans cette tâche, vous allez créer un profil de connexion pour l'instance source PostgreSQL.

Récupérer les informations sur la connectivité et le déploiement de l'instance source PostgreSQL

Dans cette étape, vous allez identifier l'adresse IP interne de l'instance de base de données source que vous devez migrer vers AlloyDB.

1. Dans le menu de navigation (), sous Compute Engine, cliquez sur Instances de VM.

2. Repérez la ligne correspondant à l'instance pg14-source.

3. Copiez la valeur de l'Adresse IP interne (par exemple, 10.128.15.208).

Créer un profil de connexion pour l'instance source PostgreSQL

Un profil de connexion stocke des informations concernant l'instance de base de données source (par exemple, PostgreSQL autonome). Database Migration Service s'en sert pour migrer les données de la source vers votre instance AlloyDB pour PostgreSQL de destination. Après avoir créé un profil de connexion, vous pouvez le réutiliser dans d'autres jobs de migration.

Dans cette étape, vous allez créer un profil de connexion pour l'instance source PostgreSQL.

1. Dans la console Google Cloud, accédez au menu de navigation (), puis cliquez sur Afficher tous les produits. Dans la section "Bases de données", cliquez sur Migration de bases de données > Profils de connexion.

2. Cliquez sur + Créer un profil.

3. Pour Rôle du profil, sélectionnez Source.

4. Pour le Moteur de base de données, sélectionnez PostgreSQL.

5. Dans le champ Nom du profil de connexion, saisissez pg14-source.

6. Pour Région, sélectionnez .

7. Sous Définir les configurations de connexion, cliquez sur DÉFINIR.

8. Dans le champ Nom d'hôte ou adresse IP, saisissez l'adresse IP interne de l'instance source PostgreSQL, que vous avez copiée dans la tâche précédente (par exemple, 10.128.15.208)

9. Pour le Port, saisissez 5432.

10. Dans le champ Nom d'utilisateur, saisissez postgres.

11. Dans le champ Mot de passe, saisissez Change3Me.

12. Conservez toutes les autres valeurs par défaut.

13. Cliquez sur Enregistrer.

14. Cliquez sur Créer.

Un nouveau profil de connexion nommé pg14-source apparaît dans la liste "Profils de connexion".

12. Cliquez sur Vérifier ma progression pour valider l'objectif. Créer un profil de connexion pour l'instance source PostgreSQL

Tâche 3 : Créer et démarrer un job de migration continu

Lorsque vous créez un job de migration, vous devez d'abord définir l'instance de base de données source à l'aide d'un profil de connexion précédemment créé. Ensuite, vous créez une instance de base de données de destination, puis vous configurez la connectivité entre l'instance source et celle de destination.

Dans cette tâche, vous allez créer un cluster AlloyDB pour PostgreSQL à l'aide de l'interface du job de migration, puis le définir en tant que destination du job de migration continu depuis l'instance source PostgreSQL.

Créer un job de migration continu

Dans cette étape, vous allez créer un job de migration continu.

1. Dans la console Google Cloud, accédez au menu de navigation (), puis cliquez sur Afficher tous les produits. Dans la section "Bases de données", cliquez sur Migration de bases de données > Jobs de migration.

2. Cliquez sur + Créer un job de migration.

3. Dans le champ Nom du job de migration, saisissez postgres-to-alloydb.

4. Pour Moteur de base de données source, sélectionnez PostgreSQL.

5. Pour Moteur de base de données de destination, sélectionnez AlloyDB pour PostgreSQL.

6. Pour Région de destination, sélectionnez .

7. Pour l'instant, Continu est le seul Type de job de migration disponible pour la migration de PostgreSQL vers AlloyDB.

8. Conservez les valeurs par défaut des autres paramètres.

9. Cliquez sur Enregistrer et continuer.

Définir l'instance source

Au cours de cette étape, vous allez définir l'instance source de la migration.

1. Pour Sélectionner un profil de connexion source, sélectionnez le profil de connexion pg14-source que vous avez créé il y a quelques étapes.

2. Cliquez sur Enregistrer et continuer.

Créer l'instance de destination

À cette étape, l'assistant DMS va créer le cluster et l'instance AlloyDB à votre place.

1. Pour Type de cluster de destination, l'option Nouveau cluster est déjà sélectionnée.

2. Cliquez sur Continuer pour Vérifier la configuration du cluster.

3. Dans le champ ID du cluster, saisissez alloydb-target-cluster.

4. Dans le champ Mot de passe, saisissez Change3Me.

5. Pour le Réseau, sélectionnez peering-network.

6. Cliquez sur Continuer.

7. Dans le champ ID d'instance, saisissez alloydb-target-instance.

8. Sélectionnez 2 vCPU, 16 Go comme type de machine.

9. Cliquez sur Enregistrer et continuer.

10. Dans la fenêtre pop-up, cliquez sur Créer une destination et continuer pour continuer.

11. Pendant la création de votre instance et de votre cluster AlloyDB, vous pouvez choisir Appairage de VPC dans la liste des options de la Méthode de connectivité.

12. Veuillez attendre que le cluster et l'instance soient créés. Le lien Configurer et continuer sera disponible une fois la base de données disponible.

13. Cliquez sur Configurer et continuer.

14. Sur la page Sélectionner les objets à migrer, sous Bases de données à migrer, sélectionnez Toutes les bases de données.

15. Cliquez sur Enregistrer et continuer.

Tester et démarrer le job de migration continu

Dans cette étape, vous allez tester et démarrer le job de migration continu.

1. L'assistant Database Migration Service se trouve maintenant à l'étape Tester et créer le job de migration.

2. Cliquez sur Tester le job.

3. Si le test est concluant, cliquez sur Créer et démarrer un job.

Remarque : Vous devez cliquer sur Créer et démarrer un job pour que le job démarre. L'autre lien ne fera que créer et enregistrer les détails du job.

Si vous êtes invité à confirmer l'action, cliquez sur Créer et démarrer.

Vérifier l'état du job de migration continu

Au cours de cette étape, vous allez vous assurer que le job de migration continu est bien en cours d'exécution.

1. Dans la console Google Cloud, accédez au menu de navigation (), puis cliquez sur Afficher tous les produits. Dans la section "Bases de données", cliquez sur Migration de bases de données > Jobs de migration.

2. Cliquez sur le job de migration postgres-to-alloydb pour afficher la page des détails.

3. Vérifiez l'état du job de migration.

• Si vous ne l'avez pas lancé, le job sera à l'état Non démarré. Vous avez la possibilité de démarrer ou de supprimer le job.
• Une fois le job démarré, son état passera à Démarrage…. L'état passera ensuite à En cours d'exécution | Vidage complet en cours pour indiquer que le vidage initial de la base de données est en cours.
• L'état du job passera à En cours d'exécution | CDC en cours une fois le chargement initial terminé et DMS disponible pour les opérations continues.

Lorsque l'état du job passe à En cours d'exécution | CDC en cours, passez à la tâche suivante.

Tâche 4 : Confirmer le chargement des données dans l'instance AlloyDB pour PostgreSQL

Vérifier l'instance AlloyDB pour PostgreSQL

1. Dans le menu de navigation de la console Cloud (), cliquez sur Afficher tous les produits. Dans la section "Bases de données", cliquez sur AlloyDB pour PostgreSQL, puis sur Clusters pour examiner les détails du cluster.

2. Le cluster s'appelle alloydb-target-cluster et l'instance alloydb-target-cluster-primary.

3. Notez l'adresse IP privée dans la section "Instances". Copiez l'adresse IP privée dans un fichier texte. Vous pourrez ainsi coller la valeur à une étape ultérieure.

4. Dans le menu de navigation (), sous Compute Engine, cliquez sur Instances de VM.

5. Pour l'instance nommée alloydb-client, dans la colonne Connecter, cliquez sur SSH pour ouvrir une fenêtre de terminal.

6. Définissez la variable d'environnement suivante en remplaçant ALLOYDB_ADDRESS par l'adresse IP privée de l'instance AlloyDB.

export ALLOYDB=ALLOYDB_ADDRESS

7. Exécutez la commande suivante pour stocker l'adresse IP privée de l'instance AlloyDB sur la VM cliente AlloyDB afin qu'elle soit conservée tout au long de l'atelier.

echo $ALLOYDB > alloydbip.txt

8. Connectez-vous au client psql et exécutez la requête suivante pour vérifier que les cinq tables sources se trouvent désormais dans l'instance AlloyDB. Vous serez invité à fournir le mot de passe de l'utilisateur postgres (Change3Me) spécifié lors de la création du cluster.

psql -h $ALLOYDB -U postgres \dt List of relations Schema | Name | Type | Owner --------+-------------+-------+--------------------- public | countries | table | alloydbexternalsync public | departments | table | alloydbexternalsync public | employees | table | alloydbexternalsync public | jobs | table | alloydbexternalsync public | locations | table | alloydbexternalsync public | regions | table | alloydbexternalsync (6 rows)

9. Exécutez les requêtes suivantes pour déterminer le nombre de lignes des tables migrées. Les valeurs correspondront aux résultats de la requête sur l'instance source.

select count (*) as countries_row_count from countries; select count (*) as departments_row_count from departments; select count (*) as employees_row_count from employees; select count (*) as jobs_row_count from jobs; select count (*) as locations_row_count from locations; select count (*) as regions_row_count from regions;

10. Voici le nombre de lignes des tables cibles :

Nom	Lignes
countries	25
services	27
employees	107
jobs	19
locations	23
regions	4

11. Exécutez la requête suivante pour vérifier les données de la table "regions".

select region_id, region_name from regions; region_id | region_name -----------+------------------------ 1 | Europe 2 | Americas 3 | Asia 4 | Middle East and Africa (4 rows) .

Tâche 5 : Propager une mise à jour en temps réel à l'instance AlloyDB

1. Comme le job Database Migration Service est configuré pour des mises à jour continues, toutes les modifications que vous apportez à l'instance source sont appliquées à la cible AlloyDB.

2. Dans le menu de navigation (), sous Compute Engine, cliquez sur Instances de VM.

3. Pour l'instance nommée pg14-source, dans la colonne Connecter, cliquez sur SSH pour ouvrir une fenêtre de terminal.

4. Utilisez la commande suivante pour lancer le client PostgreSQL (psql).

sudo -u postgres psql

5. L'invite de terminal psql s'affiche. Saisissez et exécutez la commande SQL suivante pour ajouter une ligne de données à la table regions.

insert into regions values (5, 'Oceania');

6. Vérifiez que la ligne a été insérée localement.

select region_id, region_name from regions; region_id | region_name -----------+------------------------ 1 | Europe 2 | Americas 3 | Asia 4 | Middle East and Africa 5 | Oceania (5 rows)

Vérifier les données dans l'instance AlloyDB pour PostgreSQL

1. Revenez au shell du terminal pour alloydb-client. Le client psql reste ouvert. Exécutez la requête suivante pour vérifier que la ligne Oceania a été ajoutée à l'instance AlloyDB ciblée.

select region_id, region_name from regions; region_id | region_name -----------+------------------------ 1 | Europe 2 | Americas 3 | Asia 4 | Middle East and Africa 5 | Oceania (5 rows)

2. Cliquez sur Vérifier ma progression pour valider l'objectif. Tester la migration continue des données

Félicitations !

Vous avez réussi à migrer une base de données PostgreSQL autonome (s'exécutant sur une machine virtuelle) vers AlloyDB pour PostgreSQL à l'aide d'un job Database Migration Service continu.

Dernière mise à jour du manuel : 14 février 2025

Dernier test de l'atelier : 14 février 2025

Copyright 2025 Google LLC. Tous droits réservés. Google et le logo Google sont des marques de Google LLC. Tous les autres noms d'entreprises et de produits peuvent être des marques des entreprises auxquelles ils sont associés.