Migrer une base de données vers AlloyDB pour PostgreSQL à l'aide de Database Migration Service

MySQL   |  PostgreSQL   |  PostgreSQL vers AlloyDB

Ce guide de démarrage rapide vous explique comment utiliser Database Migration Service pour migrer des données vers AlloyDB pour PostgreSQL. Les ressources créées dans ce guide de démarrage rapide coûtent généralement moins d'un dollar (USD), en supposant que vous effectuiez les étapes, y compris le nettoyage, en temps opportun.

Avant de commencer

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

4. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

5. Make sure that billing is enabled for your Google Cloud project.

6. Enable the Database Migration Service API.

   Enable the API

7. Assurez-vous que le rôle "Administrateur de migration de bases de données" est bien attribué à votre compte utilisateur.

   Accéder à la page IAM

Conditions requises

Database Migration Service propose diverses options de base de données source et méthodes de connectivité. Les différentes sources fonctionnent mieux avec certaines méthodes de connectivité qu'avec d'autres. Dans ce guide de démarrage rapide, nous partons du principe que vous utilisez une base de données PostgreSQL autonome dans un environnement où vous pouvez configurer votre réseau afin d'ajouter une règle de pare-feu entrante. La base de données source peut être sur site ou chez un fournisseur de services cloud. Ne connaissant pas les spécificités de votre environnement, nous ne pouvons pas fournir de procédure détaillée pour la configuration de votre réseau.

Dans ce guide de démarrage rapide, vous allez sélectionner PostgreSQL comme moteur de base de données source, AlloyDB pour PostgreSQL comme moteur de base de données de destination et Appairage de VPC comme méthode de mise en réseau.

Créer un profil de connexion source

En créant un profil de connexion, vous créez un enregistrement contenant des informations sur la base de données source. Database Migration Service utilise les informations du profil de connexion pour migrer les données de votre base de données source vers l'instance de base de données AlloyDB de destination.

1. Accédez à la page "Profils de connexion" de Database Migration Service dans la console Google Cloud.

   Accéder à la page "Profils de connexion du service de migration de bases de données"

2. Cliquez sur CRÉER UN PROFIL.

3. Sur la page Créer un profil de connexion, dans la liste Rôle du profil, sélectionnez Source.

4. Dans la liste Moteur de base de données, sélectionnez l'un des types de classification suivants pour votre base de données source:

   • Une instance PostgreSQL autonome (PostgreSQL)
   • Une instance Cloud SQL pour PostgreSQL existante (Cloud SQL pour PostgreSQL)
   • Une instance Amazon RDS pour PostgreSQL (Amazon RDS pour PostgreSQL)

   Pour ce guide de démarrage rapide, sélectionnez PostgreSQL.

4. Indiquez les informations suivantes :
   • Dans le champ Nom du profil de connexion, saisissez un nom pour le profil de connexion de votre base de données source, tel que My Connection Profile.
   • Conservez l'ID du profil de connexion généré automatiquement.
   • Saisissez les informations de connectivité :
     • Si vous effectuez la réplication à partir d'une base de données auto-hébergée, saisissez le nom d'hôte ou l'adresse IP (domaine ou adresse IP) et le port pour accéder à l'hôte. (Le port PostgreSQL par défaut est 5432.)
     • Si vous effectuez la réplication à partir d'une base de données Cloud SQL, sélectionnez l'instance Cloud SQL dans la liste déroulante.
   • Saisissez un nom d'utilisateur et un mot de passe pour vous authentifier auprès de votre instance source.

5. Dans la section Région du profil de connexion de la page, sélectionnez la région dans laquelle vous souhaitez enregistrer le profil de connexion.

   Comme toutes les ressources, les profils de connexion sont enregistrés dans une région. La sélection de la région n'a pas d'incidence sur les tâches de migration qui peuvent les utiliser, ni sur les régions qui peuvent se connecter à l'emplacement de données lui-même. Cependant, elle peut avoir un impact sur la disponibilité en cas de temps d'arrêt régional.

6. Cliquez sur CRÉER.

Créer une tâche de migration

Database Migration Service utilise des jobs de migration pour migrer des données de votre instance de base de données source vers l'instance de base de données AlloyDB de destination.

La création d'un job de migration comprend les étapes suivantes:

• Définir les paramètres de la tâche
• Sélectionner le profil de connexion que vous avez créé pour votre base de données source (profil de connexion source)
• Définir les paramètres de l'instance de base de données AlloyDB de destination
• Configurer la connectivité entre les instances de base de données source et de destination
• Tester la tâche de migration pour vous assurer que les informations de connexion fournies pour la tâche sont valides

Définir les paramètres du job de migration

1. Accédez à la page "Jobs de migration" de Database Migration Service dans la console Google Cloud.

   Accéder à la page "Tâches de migration de Database Migration Service"

2. Cliquez sur CRÉER UNE TÂCHE DE MIGRATION.

3. Dans le champ Nom du job de migration, saisissez un nom pour le job de migration (par exemple, My Migration Job).

4. Conservez l'ID de tâche de migration généré automatiquement.

5. Ouvrez la liste déroulante Moteur de base de données source et sélectionnez le type de classification de votre base de données source. Dans ce guide de démarrage rapide, sélectionnez AlloyDB pour PostgreSQL.

6. Sélectionnez la région de destination dans laquelle l'instance de destination doit être créée.

7. Définissez le type de job de migration sur "Continu", car vous souhaitez que les modifications en cours dans votre base de données source soient migrées vers l'instance de base de données AlloyDB de destination.

8. Passez en revue les conditions préalables générées automatiquement, qui reflètent la façon dont l'environnement doit être préparé pour un job de migration. Ces prérequis peuvent inclure la configuration de la base de données source et la connexion à l'instance de base de données AlloyDB de destination. Il est préférable d'appliquer ces prérequis dès la présente étape, mais vous pouvez le faire à tout moment avant de tester ou de démarrer le job de migration. Pour en savoir plus sur ces conditions préalables, consultez la section Configurer votre source.

9. Cliquez sur SAVE AND CONTINUE (ENREGISTRER ET CONTINUER).

Spécifier des informations sur le profil de connexion source

1. Ouvrez la liste déroulante Sélectionner le profil de connexion source, puis sélectionnez le profil de connexion que vous avez créé.

2. Cliquez sur SAVE AND CONTINUE (ENREGISTRER ET CONTINUER).

Créer un cluster AlloyDB de destination

Les clusters sont la ressource de premier niveau dans AlloyDB. Pour créer un cluster de destination:

1. Choisissez un type de cluster. Actuellement, Database Migration Service est compatible avec les clusters AlloyDB haute disponibilité. Ils peuvent diffuser des données de plusieurs zones d'une région, sans pool de lecture.
2. Cliquez sur CONTINUER.
3. Configurez votre cluster :
   1. Dans le champ ID du cluster, saisissez un ID pour votre cluster.
   2. Dans le champ Mot de passe, saisissez un mot de passe pour l'utilisateur postgres par défaut. Vous aurez besoin de ce mot de passe pour vous connecter à votre base de données.
   3. Dans le champ Réseau, sélectionnez un chemin réseau pour définir les ressources disponibles lorsque vous configurez la connectivité de la migration. Les clusters ne peuvent être configurés qu'avec un chemin de réseau IP privé Si vous envisagez de vous connecter à la base de données source via l'appairage de VPC, sélectionnez le VPC où elle se trouve.
   4. Vous pouvez éventuellement sélectionner un nom de plage d'adresses IP allouée pour spécifier les adresses IP auxquelles votre instance peut se connecter.
   5. Cliquez sur CONTINUER.
4. Configurez votre instance principale. Une instance principale détermine la capacité de calcul d'un cluster et accepte les opérations de lecture/d'écriture:
1. Dans le champ ID d'instance, saisissez un ID pour votre instance principale.
2. Sélectionnez un type de machine.
3. Facultatif: Définissez des indicateurs pour votre instance. Vous pouvez utiliser des options pour personnaliser votre instance. Pour en savoir plus sur les options compatibles, consultez la documentation AlloyDB. Pour chaque indicateur :
   1. Cliquez sur AJOUTER UNE OPTION.
   2. Sélectionnez un indicateur dans la liste Nouveau flag de base de données.
   3. Indiquez une valeur pour l'indicateur.
   4. Cliquez sur OK.
5. Cliquez sur SAVE AND CONTINUE (ENREGISTRER ET CONTINUER).
6. Confirmez votre choix en cliquant sur CRÉER UNE DESTINATION ET CONTINUER.
7. Attendez la fin de la création de l'instance de destination.

Votre cluster AlloyDB est dans l'état "Amorçage" lorsqu'il est géré par Database Migration Service. Pendant la phase de démarrage, vous ne pourrez effectuer aucune opération sur votre cluster. Si vous souhaitez toujours supprimer le cluster, vous pouvez le faire à l'aide de gcloud avec l'option --force.

Configurer la connectivité

1. Choisissez la méthode de mise en réseau que vous souhaitez utiliser pour établir la connectivité entre les bases de données source et de destination. Pour ce guide de démarrage rapide, utilisez la liste Méthode de connectivité pour sélectionner Appairage VPC comme méthode de mise en réseau.
2. Vérifiez le réseau VPC de votre base de données source. Cliquez sur CONFIGURER ET CONTINUER pour terminer la configuration du profil de connexion.

Configurer des bases de données de migration

Vous pouvez sélectionner les bases de données que vous souhaitez migrer.

1. Dans la liste Bases de données à migrer, sélectionnez Toutes les bases de données.

   Toutes les bases de données existantes sur la source sont sélectionnées pour la migration.

2. Cliquez sur Enregistrer et continuer.

Tester et créer la tâche de migration

1. Vérifiez les paramètres que vous avez choisis pour le job de migration.

2. Cliquez sur TEST JOB (TESTER LA MISSION) pour vérifier que la source a été correctement configurée, que les instances source et de destination peuvent communiquer entre elles et que la tâche de migration est valide.

3. Vérifiez que l'état "Tests réussis !" s'affiche.

   Si le test échoue, vous pouvez résoudre le problème dans la partie appropriée du flux, puis revenir au test.

4. Cliquez sur CREATE & START JOB (CRÉER ET DÉMARRER LA TÂCHE) pour créer la tâche de migration et la démarrer immédiatement.

5. Cliquez sur DÉMARRER dans la boîte de dialogue qui s'affiche.

6. Sur la page Jobs de migration, vérifiez que l'état de votre job de migration est "Démarrage". Après quelques minutes, vérifiez que l'état passe à "Running" (En cours d'exécution).

Vérifier le job de migration

Dans cette section, vous vérifiez que Database Migration Service a utilisé le job de migration pour migrer des données de votre instance de base de données source vers l'instance de base de données AlloyDB de destination.

1. Accédez à la page Clusters AlloyDB dans la console Google Cloud.

   Accéder à la page "Clusters AlloyDB"

2. Cliquez sur l'entrée correspondant à l'instance dupliquée avec accès en lecture de votre job de migration.
3. Cliquez sur l'icône Activer Cloud Shell qui s'affiche en haut à droite de la page.
4. Lorsque Cloud Shell vous y invite, appuyez sur Entrée.
5. Facultatif: Si une boîte de dialogue Autoriser Cloud Shell s'affiche, cliquez sur Autoriser.
6. À l'invite Saisir un mot de passe, saisissez le mot de passe que vous avez fourni ou que Database Migration Service a généré pour vous dans Définir et créer l'instance AlloyDB de destination.

7. Lorsque l'invite postgres s'affiche, saisissez \list pour répertorier les bases de données et vérifier que votre instance de base de données source est bien affichée.
8. Dans l'invite postgres, saisissez \connect SOURCE_DB_NAME pour afficher les tables associées à cette instance de base de données. Le nom de l'invite passe de postgres à SOURCE_DB_NAME.
9. Dans l'invite SOURCE_DB_NAME, saisissez \dt pour afficher les tables de cette instance.
10. Dans l'invite SOURCE_DB_NAME, saisissez GRANT alloydbexternalsync to USER; pour autoriser cet utilisateur à accéder aux données des tables de cette instance.

    Remplacez USER par le nom de l'utilisateur que vous avez utilisé pour vous connecter à l'instance de base de données de destination.

11. Dans l'invite SOURCE_DB_NAME, saisissez SELECT * from TABLE_NAME; pour afficher les informations répliquées à partir d'une table de votre instance de base de données source.
12. Vérifiez que les informations qui s'affichent dans le tableau sont correctes.

Cela confirme que Database Migration Service a migré les données.

Promouvoir la tâche de migration

Vous êtes prêt à promouvoir le job de migration. Par conséquent, l'instance de base de données AlloyDB de destination remplace l'instance de base de données source en tant que base de données principale.

1. Revenez à la page Jobs de migration.

2. Cliquez sur le job de migration que vous souhaitez promouvoir. La page Informations sur le job de migration s'affiche.

3. Attendez que le délai de réplication tende vers zéro.

4. Arrêtez toutes les opérations en écriture dans la base de données source.

   Vous devez arrêter toutes les écritures dans la base de données source, car en appliquant la promotion du job de migration, la base de données AlloyDB de destination deviendra votre base de données principale.

5. Attendez que le délai de réplication soit nul.

6. Cliquez sur le job de migration que vous souhaitez promouvoir. L'état de cette tâche doit être "Running" (En cours d'exécution).

7. Cliquez sur PROMOUVOIR pour promouvoir le job de migration.

8. Cliquez de nouveau sur PROMOUVOIR dans la boîte de dialogue suivante.

9. Vérifiez que l'état de la tâche de migration est "Promouvoir en cours". Après quelques minutes, vérifiez que l'état passe à "Terminé".

Votre nouvelle instance de base de données AlloyDB est prête à l'emploi.

Effectuer un nettoyage

Pour éviter que les ressources utilisées sur cette page ne soient facturées sur votre compte Google Cloud , procédez comme suit :

1. Utilisez la console Google Cloud pour supprimer votre job de migration, votre profil de connexion, votre cluster AlloyDB et votre projet si vous n'en avez pas besoin.

Étape suivante

• Découvrez comment gérer les profils de connexion.
• En savoir plus sur les états des tâches de migration
• En savoir plus sur les métriques de tâche de migration