Migrer une base de données vers Cloud SQL pour PostgreSQL

MySQL   |  PostgreSQL   |  PostgreSQL vers AlloyDB

Migrer une base de données vers Cloud SQL pour PostgreSQL

Ce guide de démarrage rapide vous explique comment utiliser Database Migration Service pour migrer des données vers Cloud SQL 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

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.

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

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.

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

Verify that billing is enabled for your Google Cloud project.

1. 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

2. 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 et Liste d'adresses IP autorisées 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 Cloud SQL 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" de Database Migration Service

2. Cliquez sur CRÉER UN PROFIL.

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

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
   • Une instance 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 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.
   • (Facultatif) Si vous prévoyez de transférer des informations sensibles sur un réseau public (à l'aide de listes d'autorisations d'adresses IP), nous vous recommandons d'utiliser le chiffrement SSL/TLS pour la connexion entre les bases de données source et de destination. Sinon, conservez la valeur par défaut Aucun.

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 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 Cloud SQL 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 Cloud SQL 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

1. 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

2. Cliquez sur CRÉER UN JOB 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 job 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.

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 Cloud SQL 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 conditions préalables peuvent inclure la configuration de la base de données source et la connexion à l'instance de base de données Cloud SQL 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.

9. Cliquez sur 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 ENREGISTRER ET CONTINUER.

Définir les paramètres de l'instance Cloud SQL de destination

1. Indiquez un ID d'instance de destination pour l'instance Cloud SQL. Par défaut, l'ID du job de migration est prérempli dans ce champ. Vous pouvez conserver ce nom ou en saisir un autre.

2. Fournissez un mot de passe alphanumérique pour l'instance Cloud SQL de destination. Il s'agit du mot de passe du compte administrateur postgres dans l'instance.

   Vous pouvez saisir le mot de passe manuellement ou cliquer sur GÉNÉRER pour que Database Migration Service en crée un automatiquement.

   Conseil : Pour afficher le mot de passe en texte clair, cliquez sur l'icône Afficher. Cette icône ressemble à un œil.

3. Choisissez la version de la base de données pour l'instance de destination dans la liste des versions Cloud SQL compatibles avec le moteur de base de données spécifié.

4. Sélectionnez la zone souhaitée pour la nouvelle instance Cloud SQL (ou laissez l'option "Indifférent"). Google Cloud

5. Cochez la case Adresse IP publique, car pour ce guide de démarrage rapide, vous utilisez la liste d'autorisation d'adresses IP comme méthode de mise en réseau. Cette méthode consiste à configurer le serveur de base de données source pour accepter les connexions à partir de l'adresse IP sortante de l'instance Cloud SQL.

   Pour les autres méthodes de mise en réseau, telles que le tunnel SSH inversé, l'appairage de VPC ou le VPN, cochez la case Adresse IP privée.

6. Sélectionnez le type de machine pour l'instance Cloud SQL. La taille du disque doit être supérieure ou égale à la taille de la base de données source.

7. Définissez le type de stockage et la capacité de stockage de l'instance Cloud SQL.

8. Cliquez sur CRÉER ET CONTINUER pour créer l'instance.

9. Dans la boîte de dialogue qui s'affiche, cliquez sur CRÉER UNE DESTINATION ET CONTINUER. La création de l'instance peut prendre plusieurs minutes.

   Important : Cette procédure crée une instance Cloud SQL. Vous êtes facturé en fonction de la configuration sélectionnée.
   Remarque : Une fois l'instance de destination créée, certains paramètres du job de migration ne peuvent plus être modifiés. Vous ne pouvez pas modifier le moteur de base de données ni le type de migration.

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 Liste d'autorisation d'adresses IP comme méthode de mise en réseau.

   La liste d'autorisation d'adresses IP est une fonctionnalité de sécurité souvent utilisée pour limiter et contrôler l'accès aux données de vos bases de données source et de destination aux utilisateurs de confiance uniquement. Vous pouvez utiliser des listes d'autorisation d'adresses IP pour créer des listes d'adresses IP ou de plages d'adresses IP de confiance à partir desquelles vos utilisateurs peuvent accéder à ces données. De plus, pour utiliser des listes d'autorisation d'adresses IP, vous devez ouvrir la base de données source ou le pare-feu aux connexions entrantes de l'instance Cloud SQL de destination.

   L'affichage d'une adresse IP dans le champ Adresse IP de destination sortante peut prendre quelques minutes.

2. Si l'adresse IP source n'est pas préremplie dans ce champ, copiez l'adresse IP sortante de l'instance Cloud SQL depuis la console et utilisez-la pour configurer le pare-feu du réseau afin de permettre au serveur de base de données source d'accepter des connexions à partir de cette adresse IP.
   
   1. Mettez à jour le fichier pg_hba.conf ou les groupes de sécurité Amazon RDS pour accepter les connexions provenant de cette adresse IP.
   2. Dans vos règles de pare-feu, créez une règle entrante (ou d&#Ingress) pour autoriser les connexions sur le port 5432 à partir de l'adresse IP de connectivité de l'instance Cloud SQL de destination.
3. 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 le job de migration

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

2. 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.

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 CRÉER ET DÉMARRER UN JOB pour créer le job de migration et le démarrer immédiatement.

5. Cliquez sur DÉMARRER dans la boîte de dialogue suivante.

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 à "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 les données de votre instance de base de données source vers l'instance de base de données Cloud SQL de destination.

1. Accédez à la page Instances SQL dans Google Cloud console.
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. À l'invite Google Cloud Shell, appuyez sur Entrée.
5. Facultatif : Si une boîte de dialogue Autoriser Cloud Shell s'affiche, cliquez sur Autoriser.
6. Connectez-vous à l'instance de base de données Cloud SQL de destination.
7. 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 les paramètres de l'instance Cloud SQL de destination.

8. 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.
9. 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.
10. Dans l'invite SOURCE_DB_NAME, saisissez \dt pour afficher les tables de cette instance.
11. Dans l'invite SOURCE_DB_NAME, saisissez GRANT cloudsqlexternalsync 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.

12. 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.
13. 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 Cloud SQL 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 Cloud SQL 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 ce job doit être "En cours d'exécution".

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

8. Dans la boîte de dialogue suivante, cliquez de nouveau sur PROMOUVOIR.

9. 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 Cloud SQL 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 :

1. Utilisez la console Google Cloud pour supprimer votre job de migration, votre profil de connexion, votre instance Cloud SQL 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