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
(
roles/resourcemanager.projectCreator
), which contains theresourcemanager.projects.create
permission. Learn how to grant roles.
-
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
(
roles/resourcemanager.projectCreator
), which contains theresourcemanager.projects.create
permission. Learn how to grant roles.
-
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 theserviceusage.services.enable
permission. Learn how to grant roles. - Assurez-vous que le rÎle "Administrateur de migration de bases de données" est bien attribué à votre compte utilisateur.
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.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, dans la liste RÎle du profil, sélectionnez Source.
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.
- (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.
- 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
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.
- 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
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
Cliquez sur CRĂER UNE TĂCHE 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.
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 Cloud SQL 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 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.
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.
Définir les paramÚtres de l'instance Cloud SQL de destination
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.
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.
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é.
Sélectionnez la zone Google Cloud souhaitée pour la nouvelle instance Cloud SQL (ou laissez l'option "Indifférent").
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.
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.
Définissez le type de stockage et la capacité de stockage de l'instance Cloud SQL.
Cliquez sur CRĂER ET CONTINUER pour crĂ©er l'instance.
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.
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é afin de sélectionner Liste d'autorisation d'adresses IP comme méthode de mise en réseau.
- 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 les connexions à partir de cette adresse IP.
- Mettez Ă jour le fichier
pg_hba.conf
ou les groupes de sécurité Amazon RDS pour accepter les connexions provenant de cette adresse IP. - 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.
- Mettez Ă jour le fichier
- 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 LE 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 Cloud SQL de destination.
- Accédez à la page Instances SQL dans Google Cloud console.
- 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 Google Cloud Shell, appuyez sur Entrée.
- Facultatif : Si une boĂźte de dialogue Autoriser Cloud Shell s'affiche, cliquez sur Autoriser.
- Connectez-vous à l'instance de base de données Cloud SQL de destination.
- 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.
- 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 depostgres
Ă 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 cloudsqlexternalsync to USER;
, car vous souhaitez autoriser cet utilisateur à accéder aux données des tables de cette instance. - 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 Cloud SQL 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.
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 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 :
- 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 l'état des jobs de migration
- En savoir plus sur les métriques des tùches de migration