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

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

MySQL | PostgreSQL | PostgreSQL vers AlloyDB

Migrer une base de données vers AlloyDB pour PostgreSQL

Avant de commencer

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.

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

Roles required to select or create a project

Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

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

Roles required to select or create a project

Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Database Migration Service API.
Roles required to enable APIs
To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.
Enable the API
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 est compatible avec 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 pour le moteur de base de données source, AlloyDB pour PostgreSQL pour le 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 générez 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.

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

Accéder à la page "Profils de connexion" de Database Migration Service
Cliquez sur CRÉER UN PROFIL.
Sur la page Créer un profil de connexion, sélectionnez Source dans la liste Rôle du profil.
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
- Une instance Amazon RDS pour PostgreSQL
Pour ce guide de démarrage rapide, sélectionnez PostgreSQL.

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 une 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 répliquez des données à 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.
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.
Cliquez sur CRÉER.

Créer un job 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 du job
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 le job de migration pour vous assurer que les informations de connexion fournies pour le job sont valides

Définir les paramètres du job de migration

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

Accéder à la page "Jobs de migration" de Database Migration Service
Cliquez sur CRÉER UN JOB DE MIGRATION.
Dans le champ Nom du job de migration, saisissez un nom pour le job de migration (par exemple, My Migration Job).
Conservez l'ID de job de migration généré automatiquement.
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.
Sélectionnez la région de destination dans laquelle l'instance de destination doit être créée.
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.
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 conditions préalables à cette étape. Toutefois, vous pouvez les appliquer à tout moment avant de tester ou démarrer un job de migration. Pour en savoir plus sur ces conditions préalables, consultez Configurer votre source.
Cliquez sur ENREGISTRER ET CONTINUER.

Spécifier des informations sur le profil de connexion source

Ouvrez la liste déroulante Sélectionner le profil de connexion source, puis sélectionnez le profil de connexion que vous avez créé.
Cliquez sur 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 :

Choisissez un type de cluster. Database Migration Service est actuellement compatible avec les clusters AlloyDB haute disponibilité. Elles peuvent diffuser des données à partir de plusieurs zones d'une région, sans pool de lecture.
Cliquez sur CONTINUER.
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 du 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 prévoyez 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.
Configurez votre instance principale. Une instance principale détermine la capacité de calcul d'un cluster, et accepte les opérations de lecture et d'écriture :

Dans le champ ID d'instance, saisissez un ID pour votre instance principale.
Sélectionnez un type de machine.
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 option :
1. Cliquez sur AJOUTER UN FLAG.
2. Sélectionnez un indicateur dans la liste Nouvel indicateur de base de données.
3. Indiquez une valeur pour l'option.
4. Cliquez sur OK.

Cliquez sur ENREGISTRER ET CONTINUER.
Confirmez votre choix en cliquant sur CRÉER UNE DESTINATION ET CONTINUER.
Attendez la fin de la création de l'instance de destination.

Votre cluster AlloyDB sera à l'état "Amorçage" lorsqu'il sera géré par Database Migration Service. Lorsque l'état est "Bootstrapping", vous ne pouvez 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é

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 de VPC comme méthode de mise en réseau.
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.

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.
Cliquez sur Enregistrer et continuer.

Tester et créer le job de migration

Vérifiez les paramètres que vous avez choisis pour le job de migration.
Cliquez sur TEST JOB (TESTER LE JOB) pour vérifier que la source a été correctement configurée, que les instances source et de destination sont en mesure de communiquer entre elles et que le job de migration est valide.
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.
Cliquez sur CRÉER ET DÉMARRER UN JOB pour créer le job de migration et le démarrer immédiatement.
Cliquez sur DÉMARRER dans la boîte de dialogue suivante.
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 à "En cours d'exécution".

Vérifier le job de migration

Dans cette section, vous allez vérifier 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.

Accédez à la page Clusters AlloyDB dans la console Google Cloud .
Accéder à la page "Clusters AlloyDB"
Cliquez sur l'entrée correspondant à l'instance dupliquée avec accès en lecture de votre job de migration.
Cliquez sur l'icône Activer Cloud Shell qui s'affiche en haut à droite de la page.
À l'invite Cloud Shell, appuyez sur Entrée.
Facultatif : Si une boîte de dialogue Autoriser Cloud Shell s'affiche, cliquez sur Autoriser.
Lorsque l'invite Saisir un mot de passe s'affiche, 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.

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.

Lorsque vous y êtes invité, saisissez \connect SOURCE_DB_NAME dans le champ postgres pour afficher les tables associées à cette instance de base de données. Le nom de l'invite passe de postgres à SOURCE_DB_NAME.

Dans l'invite SOURCE_DB_NAME, saisissez \dt pour afficher les tables de cette instance.

Dans l'invite SOURCE_DB_NAME, saisissez GRANT alloydbexternalsync to USER;, car vous souhaitez 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.

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.

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.

Revenez à la page Jobs de migration.
Cliquez sur le job de migration que vous souhaitez promouvoir. La page Informations sur le job de migration s'affiche.
Attendez que le délai de réplication tende vers zéro.
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.
Attendez que le délai de réplication soit nul.
Cliquez sur le job de migration que vous souhaitez promouvoir. L'état de ce job doit être "En cours d'exécution".
Cliquez sur PROMOUVOIR pour promouvoir le job de migration.
Dans la boîte de dialogue suivante, cliquez de nouveau sur PROMOUVOIR.
Vérifiez que le job de migration est à l'état "Promotion 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 dans cette démonstration soient facturées sur votre compte Google Cloud , procédez comme suit :

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.

Étapes suivantes

Découvrez comment gérer les profils de connexion.
En savoir plus sur les états des jobs de migration
En savoir plus sur les métriques des jobs de migration