Créer un job de migration vers une instance de destination existante

MySQL   |  PostgreSQL   |  PostgreSQL vers AlloyDB

Présentation

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 de destination.

La création d'un job de migration pour une instance de destination existante comprend les éléments suivants :

• Définir les paramètres du job de migration
• Sélectionner le profil de connexion de la base de données source
• Sélectionner l'instance de base de données de destination existante
• Rétrogradation de l'instance existante pour la convertir en instance répliquée avec accès en lecture
• 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

Vous devez tenir compte de certaines limites lorsque vous souhaitez migrer vers une instance de destination créée en dehors de Database Migration Service. Pour en savoir plus, consultez Limites connues.

L'assistant Database Migration Service vous aide à créer un job de migration. Cet assistant se compose des volets suivants : Premiers pas, Définir une source, Créer une destination, Définir la méthode de connectivité, Configurer les bases de données de migration et Tester et créer un job de migration. Les sections suivantes de cette page expliquent comment renseigner chaque volet.

Créer un job de migration à l'aide de la console Google Cloud

Vous pouvez suspendre la création d'un job de migration en cliquant sur Enregistrer et quitter. Toutes les données renseignées jusqu'à ce point sont enregistrées dans un brouillon de job de migration, auquel vous pouvez accéder dans l'onglet Brouillons.

Pour terminer la création d'un job de migration, accédez à l'onglet, puis cliquez sur le job. Le flux de création reprend là où il s'était arrêté. Le job reste un brouillon jusqu'à ce que vous cliquiez sur Créer ou Créer et démarrer.

Définir les paramètres du job de migration

1. Accédez à Jobs de migration dans la console Google Cloud .

2. Cliquez sur Créer un job de migration en haut de la page.

3. Indiquez un nom pour le job de migration. Choisissez un nom convivial qui vous aidera à identifier le job de migration. N'incluez pas d'informations sensibles ou permettant d'identifier personnellement l'utilisateur dans le nom du job.

4. Conservez l'ID du job de migration généré automatiquement.

5. Sélectionnez le moteur de base de données source.

6. Sélectionnez AlloyDB pour PostgreSQL comme moteur de destination.

7. Sélectionnez la région de destination de votre migration. Cette région doit être la même que celle où se trouve votre base de données de destination. Une fois que vous avez choisi la région de destination, vous ne pouvez plus modifier cette sélection.

8. Sélectionnez Continu (instantané + modifications en cours) comme type de mission de migration.

9. Dans la section Avant de continuer, consultez les conditions préalables, cliquez sur Ouvrir pour afficher les instructions générées automatiquement qui peuvent vous aider à préparer votre base de données source pour la migration. 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, consultez Configurer votre source.

10. Cliquez sur Enregistrer et continuer.

Spécifier des informations sur le profil de connexion source

1. Si vous avez créé un profil de connexion, sélectionnez-le dans la liste des profils de connexion existants.

   Si vous n'avez pas créé de profil de connexion, créez-en un en cliquant sur Créer un profil de connexion au bas de la liste déroulante, puis suivez les mêmes étapes que dans Créer un profil de connexion source.

   Nous vous recommandons de créer un profil de connexion dédié pour votre migration AlloyDB.

2. Dans la section Personnaliser les configurations de vidage des données, cliquez sur Afficher les configurations de vidage des données.

   La vitesse du parallélisme du vidage des données est liée à la quantité de charge sur votre base de données source. Vous pouvez utiliser les paramètres suivants :

   • Optimal (recommandé) : performances équilibrées avec une charge optimale sur la base de données source.
   • Maximum : fournit les vitesses de vidage les plus élevées, mais peut entraîner une charge accrue sur la base de données source.
   • Minimum : utilise la plus faible quantité de ressources de calcul sur la base de données source, mais peut avoir un débit de vidage plus lent.

   Si vous souhaitez utiliser des paramètres de parallélisme de vidage des données ajustés, veillez à augmenter les paramètres max_replication_slots, max_wal_senders et max_worker_processes sur votre base de données source. Vous pouvez vérifier votre configuration en exécutant le test du job de migration à la fin de la création du job de migration.

3. Cliquez sur Enregistrer et continuer.

Si votre base de données source est une instance Cloud SQL et que seule l'adresse IP publique est activée, veillez à activer son adresse IP privée avant de passer à la section suivante. N'oubliez pas de mettre à jour le profil de connexion avec l'adresse IP privée.

Sélectionner l'instance de destination

Pour les sources Cloud SQL : si vous migrez d'une instance Cloud SQL qui utilise une connexion IP privée vers une instance Cloud SQL qui utilise une plage d'adresses IP non-RFC 1918, ajoutez la plage non-RFC 1918 à la configuration réseau de votre instance Cloud SQL source. Consultez Configurer les réseaux autorisés dans la documentation Cloud SQL.

1. Dans le menu Type de cluster de destination, sélectionnez Cluster existant.
2. Dans la section Sélectionner un cluster de destination, sélectionnez votre cluster de destination.
3. Examinez les informations sur votre cluster, puis cliquez sur Sélectionner et continuer.
4. Pour migrer vers une base de données de destination existante, Database Migration Service rétrograde l'instance cible et la convertit en réplica. Pour indiquer que la rétrogradation peut être effectuée sans risque, saisissez l'identifiant de l'instance de destination dans la fenêtre de confirmation.
5. Cliquez sur Confirmer et continuer.

Configurer la connectivité entre les instances de base de données source et de destination

Remarque : Si votre source est Cloud SQL pour PostgreSQL, les options de connectivité sont limitées à l'appairage de réseaux VPC et au proxy TCP via une VM hébergée dans le cloud, selon que votre instance source Cloud SQL utilise l'ancienne ou la nouvelle architecture réseau.

1. Dans le menu déroulant Méthode de connectivité, sélectionnez une méthode de connectivité réseau. Cette méthode définit la manière dont le cluster AlloyDB nouvellement créé se connectera à la base de données source. Les méthodes de connectivité réseau actuelles incluent les listes d'autorisation IP, l'appairage de VPC, les interfaces Private Service Connect, le tunnel SSH inversé et le proxy TCP via une VM hébergée dans le cloud.
2. Si vous sélectionnez la méthode de connectivité réseau "Liste d'adresses IP autorisées", vous devez spécifier l'adresse IP sortante de votre instance de destination. Copiez les adresses IP sortantes des instances principale et secondaire, et utilisez-les pour configurer le pare-feu réseau de votre serveur de base de données source et dans le fichier pg_hba.conf, afin que la source puisse accepter les connexions provenant de ces adresses.

3. Si vous sélectionnez la méthode de connectivité réseau par tunnel SSH inversé, sélectionnez l'instance de VM Compute Engine qui hébergera le tunnel.

   Après avoir spécifié l'instance, Google fournit un script qui effectue les étapes de configuration du tunnel entre les bases de données source et de destination. Vous devrez exécuter le script dans la Google Cloud CLI.

   Exécutez les commandes à partir d'une machine connectée à la fois à la base de données source et à Google Cloud.

4. Si vous utilisez l'une des méthodes de connexion IP privée, sélectionnez Appairage de VPC ou Interface PSC.
5. Si vous sélectionnez la méthode de connectivité réseau par appairage de VPC, sélectionnez le réseau VPC dans lequel réside la base de données source. L'instance Cloud SQL sera mise à jour pour se connecter à ce réseau.

6. Si vous sélectionnez la méthode de connectivité "Proxy TCP via une VM hébergée dans le cloud", saisissez les informations requises pour la nouvelle instance de VM Compute Engine qui hébergera le proxy TCP.

   Après avoir spécifié les détails, la console Google Cloud fournira un script qui effectue les étapes de configuration du proxy entre les bases de données source et de destination. Vous devrez exécuter le script sur une machine dotée d'une Google Cloud CLI à jour.

   Une fois le script exécuté, l'adresse IP privée de la VM nouvellement créée s'affiche. Saisissez l'adresse IP, puis cliquez sur Configurer et continuer.

7. Après avoir sélectionné la méthode de connectivité réseau et fourni des informations supplémentaires pour la méthode, cliquez sur CONFIGURER ET CONTINUER.

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 l'une des options suivantes :
   • Toutes les bases de données : sélectionne toutes les bases de données existantes dans la source.
   • Bases de données spécifiques : vous permet de sélectionner des bases de données spécifiques parmi toutes celles qui existent dans la source.

2. Si vous souhaitez migrer des bases de données spécifiques, vous pouvez filtrer la liste qui s'affiche et sélectionner les bases de données que vous souhaitez que Database Migration Service migre vers votre destination.

   Si la liste ne s'affiche pas et qu'une erreur de découverte de base de données s'affiche, cliquez sur Actualiser. Si la découverte de la base de données échoue, le job migre toutes les bases de données. Vous pouvez continuer à créer un job de migration et corriger les erreurs de connectivité plus tard.

3. Cliquez sur Enregistrer et continuer.

Tester et créer le job de migration

Lors de cette dernière étape, vérifiez le récapitulatif des paramètres du job de migration, de la source, de la destination et de la méthode de connectivité, puis testez la validité de la configuration du job de migration. En cas de problème, vous pouvez modifier les paramètres du job de migration. Tous les paramètres ne sont pas modifiables.

1. Cliquez sur TESTER LE JOB pour vérifier que :

   • La base de données source a été configurée correctement, en fonction des prérequis.
   • Les instances source et de destination peuvent communiquer entre elles.
   • Toutes les modifications nécessaires des adresses IP privées sur la destination ont été effectuées.
   • Le job de migration est valide, et les versions source et de destination sont compatibles.

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

   Pour en savoir plus sur les raisons pour lesquelles le test peut échouer et sur la manière de résoudre les problèmes associés à l'échec du test, consultez Diagnostiquer les problèmes pour AlloyDB.

   Le job de migration peut être créé même si le test échoue, mais une fois le job démarré, il peut échouer à un moment donné de l'exécution.

2. Cliquez sur CRÉER ET DÉMARRER LE JOB pour créer le job de migration et le démarrer immédiatement, ou sur CRÉER LE JOB pour créer le job de migration sans le démarrer immédiatement.

   Si le job n'est pas démarré au moment de sa création, il peut l'être depuis la page Jobs de migration en cliquant sur DÉMARRER.

   Quel que soit le moment où le job de migration démarre, votre organisation est facturée pour l'existence de l'instance de destination.

   Lorsque vous démarrez le job de migration, Database Migration Service lance le vidage complet, ce qui verrouille brièvement la base de données source. Si votre source se trouve dans Amazon RDS ou Amazon Aurora, Database Migration Service nécessite également un court temps d'arrêt d'écriture (environ moins d'une minute) au début de la migration. Pour en savoir plus, consultez Considérations relatives au parallélisme du vidage des données.

3. Le job de migration est ajouté à la liste des jobs de migration et peut être consulté directement.

4. Passez à Vérifier le job de migration.

Créer un job de migration à l'aide de la Google Cloud CLI

Lorsque vous effectuez une migration vers une instance existante à l'aide de la Google Cloud CLI, vous devez créer manuellement le profil de connexion pour l'instance de destination. Cette étape n'est pas nécessaire lorsque vous utilisez la console Google Cloud , car Database Migration Service se charge de créer et de supprimer le profil de connexion de destination pour vous.

Avant de commencer

Avant d'utiliser gcloud CLI pour créer un job de migration vers une instance de base de données de destination existante, assurez-vous d'effectuer les opérations suivantes :

• Créez votre instance de base de données de destination.
• Préparez votre instance de base de données source. Consultez les ressources suivantes :
  • Configurer votre source
  • Créez le profil de connexion source (l'identifiant du profil de connexion source est requis pour créer un job de migration).
  • Configurer la connectivité

Créer un profil de connexion de destination

Créez le profil de connexion de destination pour votre instance de destination existante en exécutant la commande gcloud database-migration connection-profiles create :

Cet exemple utilise l'option facultative --no-async pour que toutes les opérations soient effectuées de manière synchrone. Cela signifie que l'exécution de certaines commandes peut prendre un certain temps. Vous pouvez ignorer l'option --no-async pour exécuter des commandes de manière asynchrone. Si c'est le cas, vous devez utiliser la commande gcloud database-migration operations describe pour vérifier si votre opération a réussi.

Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :

• CONNECTION_PROFILE_ID par un identifiant lisible par machine pour votre profil de connexion.
• REGION par l'identifiant de la région dans laquelle vous souhaitez enregistrer le profil de connexion.
• DESTINATION_INSTANCE_ID avec l'identifiant d'instance de votre instance de destination.
• (Facultatif) CONNECTION_PROFILE_NAME par un nom lisible par l'humain pour votre profil de connexion. Cette valeur s'affiche dans la console Google Cloud .

Exécutez la commande suivante :

Linux, macOS ou Cloud Shell

Remarque : Assurez-vous d'avoir initialisé la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes gcloud auth login et gcloud config set project.

gcloud database-migration connection-profiles \
create postgresql CONNECTION_PROFILE_ID \
  --no-async \
  --alloydb-cluster=DESTINATION_INSTANCE_ID \
  --region=REGION \
  --display-name=CONNECTION_PROFILE_NAME

Windows (PowerShell)

Remarque : Assurez-vous d'avoir initialisé la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes gcloud auth login et gcloud config set project.

gcloud database-migration connection-profiles `
create postgresql CONNECTION_PROFILE_ID `
  --no-async `
  --alloydb-cluster=DESTINATION_INSTANCE_ID `
  --region=REGION `
  --display-name=CONNECTION_PROFILE_NAME

Windows (cmd.exe)

Remarque : Assurez-vous d'avoir initialisé la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes gcloud auth login et gcloud config set project.

gcloud database-migration connection-profiles ^
create postgresql CONNECTION_PROFILE_ID ^
  --no-async ^
  --alloydb-cluster=DESTINATION_INSTANCE_ID ^
  --region=REGION ^
  --display-name=CONNECTION_PROFILE_NAME

Vous devriez obtenir un résultat semblable à celui-ci :

Waiting for connection profile [CONNECTION_PROFILE_ID]
to be created with [OPERATION_ID]

Waiting for operation [OPERATION_ID] to complete...done.

Created connection profile CONNECTION_PROFILE_ID [OPERATION_ID]

Créer le job de migration

Remarque : Les exemples suivants représentent un scénario de migration dans lequel vous utilisez la connectivité par adresse IP privée entre les bases de données source et de destination. Si vous utilisez un autre type de connectivité (par exemple, l'appairage de VPC ou un tunnel SSH inversé), veillez à ajouter les options requises, telles que --peer-vpc ou --vm, --vm-ip, --vm-port, --vpc. Pour en savoir plus, consultez Configurer la connectivité et Exemples Google Cloud CLI.

Remarque : Seul le type de migration continue est compatible avec les migrations vers AlloyDB.

Cet exemple utilise l'option facultative --no-async pour que toutes les opérations soient effectuées de manière synchrone. Cela signifie que l'exécution de certaines commandes peut prendre un certain temps. Vous pouvez ignorer l'option --no-async pour exécuter des commandes de manière asynchrone. Si vous le faites, vous devez utiliser la commande gcloud database-migration operations describe pour vérifier si l'opération a réussi.

Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :

• MIGRATION_JOB_ID par un identifiant lisible par machine pour votre job de migration. Vous utilisez cette valeur pour travailler avec les jobs de migration à l'aide des commandes Google Cloud CLI ou de l'API Database Migration Service.
• REGION par l'identifiant de la région dans laquelle vous souhaitez enregistrer le job de migration.
• MIGRATION_JOB_NAME par un nom lisible par l'humain pour votre job de migration. Cette valeur s'affiche dans la console Google Cloud de Database Migration Service.
• SOURCE_CONNECTION_PROFILE_ID avec un identifiant lisible par machine du profil de connexion source.
• DESTINATION_CONNECTION_PROFILE_ID avec un identifiant lisible par machine du profil de connexion de destination.

• Facultatif : Database Migration Service migre toutes les bases de données de votre source par défaut. Si vous ne souhaitez migrer que des bases de données spécifiques, utilisez l'option --databases-filter et spécifiez leurs identifiants sous la forme d'une liste d'éléments séparés par une virgule.

  Par exemple : --databases-filter=my-business-database,my-other-database

  Vous pourrez modifier ultérieurement les jobs de migration que vous avez créés avec l'option --databases-filter à l'aide de la commande gcloud database-migration migration-jobs update.

Exécutez la commande suivante :

Linux, macOS ou Cloud Shell

Remarque : Assurez-vous d'avoir initialisé la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes gcloud auth login et gcloud config set project.

gcloud database-migration migration-jobs \
create MIGRATION_JOB_ID \
  --no-async \
  --region=REGION \
  --display-name=MIGRATION_JOB_NAME \
  --source=SOURCE_CONNECTION_PROFILE_ID \
  --destination=DESTINATION_CONNECTION_PROFILE_ID \
  --type=CONTINUOUS \

Windows (PowerShell)

Remarque : Assurez-vous d'avoir initialisé la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes gcloud auth login et gcloud config set project.

gcloud database-migration migration-jobs `
create MIGRATION_JOB_ID `
  --no-async `
  --region=REGION `
  --display-name=MIGRATION_JOB_NAME `
  --source=SOURCE_CONNECTION_PROFILE_ID `
  --destination=DESTINATION_CONNECTION_PROFILE_ID `
  --type=CONTINUOUS `

Windows (cmd.exe)

Remarque : Assurez-vous d'avoir initialisé la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes gcloud auth login et gcloud config set project.

gcloud database-migration migration-jobs ^
create MIGRATION_JOB_ID ^
  --no-async ^
  --region=REGION ^
  --display-name=MIGRATION_JOB_NAME ^
  --source=SOURCE_CONNECTION_PROFILE_ID ^
  --destination=DESTINATION_CONNECTION_PROFILE_ID ^
  --type=CONTINUOUS ^

Vous devriez obtenir un résultat semblable à celui-ci :

Waiting for migration job [MIGRATION_JOB_ID]
to be created with [OPERATION_ID]

Waiting for operation [OPERATION_ID] to complete...done.

Created migration job MIGRATION_JOB_ID [OPERATION_ID]

Rétrograder la base de données de destination

Database Migration Service exige que l'instance de base de données de destination fonctionne comme une instance répliquée avec accès en lecture pendant la migration. Avant de démarrer le job de migration, exécutez la commande gcloud database-migration migration-jobs demote-destination pour rétrograder l'instance de base de données de destination.

Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :

• MIGRATION_JOB_ID par l'identifiant de votre job de migration.

  Si vous ne connaissez pas l'identifiant, vous pouvez utiliser la commande gcloud database-migration migration-jobs list pour lister tous les jobs de migration d'une région donnée et afficher leurs identifiants.

• REGION par l'identifiant de la région dans laquelle votre profil de connexion est enregistré.

Exécutez la commande suivante :

Linux, macOS ou Cloud Shell

Remarque : Assurez-vous d'avoir initialisé la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes gcloud auth login et gcloud config set project.

gcloud database-migration migration-jobs \
demote-destination MIGRATION_JOB_ID \
  --region=REGION

Windows (PowerShell)

Remarque : Assurez-vous d'avoir initialisé la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes gcloud auth login et gcloud config set project.

gcloud database-migration migration-jobs `
demote-destination MIGRATION_JOB_ID `
  --region=REGION

Windows (cmd.exe)

Remarque : Assurez-vous d'avoir initialisé la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes gcloud auth login et gcloud config set project.

gcloud database-migration migration-jobs ^
demote-destination MIGRATION_JOB_ID ^
  --region=REGION

Résultat

L'action est effectuée de manière asynchrone. Par conséquent, cette commande renvoie une entité d'opération qui représente une opération de longue durée :

done: false
metadata:
  '@type': type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata
  apiVersion: v1
  createTime: '2024-02-20T12:20:24.493106418Z'
  requestedCancellation: false
  target: MIGRATION_JOB_ID
  verb: demote-destination
name: OPERATION_ID

Pour vérifier si l'opération a réussi, vous pouvez interroger l'objet d'opération renvoyé ou vérifier l'état du job de migration :

• Utilisez la commande gcloud database-migration migration-jobs describe pour afficher l'état du job de migration.
• Utilisez gcloud database-migration operations describe avec OPERATION_ID pour afficher l'état de l'opération elle-même.

Gérer les tâches de migration

À ce stade, votre job de migration est configuré et connecté à votre instance de base de données de destination. Vous pouvez le gérer à l'aide des opérations suivantes :

1. Facultatif : Vérifiez le job de migration.
   Nous vous recommandons de commencer par vérifier votre job de migration en exécutant la commande gcloud database-migration migration-jobs verify.

   Pour en savoir plus, développez la section suivante :

   gcloud database-migration migration-jobs verify

   Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :

   • MIGRATION_JOB_ID par l'identifiant de votre job de migration.

     Si vous ne connaissez pas l'identifiant, vous pouvez utiliser la commande gcloud database-migration migration-jobs list pour lister tous les jobs de migration d'une région donnée et afficher leurs identifiants.

   • REGION par l'identifiant de la région dans laquelle votre profil de connexion est enregistré.

   Exécutez la commande suivante :

   Linux, macOS ou Cloud Shell

   Remarque : Assurez-vous d'avoir initialisé la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes gcloud auth login et gcloud config set project.

   gcloud database-migration migration-jobs \
   verify MIGRATION_JOB_ID \
     --region=REGION

   Windows (PowerShell)

   Remarque : Assurez-vous d'avoir initialisé la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes gcloud auth login et gcloud config set project.

   gcloud database-migration migration-jobs `
   verify MIGRATION_JOB_ID `
     --region=REGION

   Windows (cmd.exe)

   Remarque : Assurez-vous d'avoir initialisé la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes gcloud auth login et gcloud config set project.

   gcloud database-migration migration-jobs ^
   verify MIGRATION_JOB_ID ^
     --region=REGION

   Résultat

   L'action est effectuée de manière asynchrone. Par conséquent, cette commande renvoie une entité Operation qui représente une opération de longue durée :

   done: false
   metadata:
     '@type': type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata
     apiVersion: v1
     createTime: '2024-02-20T12:20:24.493106418Z'
     requestedCancellation: false
     target: MIGRATION_JOB_ID
     verb: verify
   name: OPERATION_ID
   

   Pour savoir si votre opération a réussi, vous pouvez interroger l'objet d'opération renvoyé ou vérifier l'état du job de migration :

   • Utilisez la commande gcloud database-migration migration-jobs describe avec MIGRATION_JOB_ID pour afficher l'état du job de migration.
   • Utilisez la commande gcloud database-migration operations describe avec l'option OPERATION_ID pour afficher l'état de l'opération elle-même.

2. Facultatif : Récupérez des informations sur les bases de données sélectionnées pour la migration.
   Lorsque vous migrez des bases de données spécifiques, Database Migration Service doit récupérer les détails des bases de données que vous avez sélectionnées pour le job de migration à l'aide de l'option --database-filter.

   Avant de démarrer le job de migration, exécutez la commande gcloud database-migration migration-jobs fetch-source-objects.

   Pour en savoir plus, développez la section suivante :

   gcloud database-migration migration-jobs fetch-source-objects

   Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :

   • MIGRATION_JOB_ID par l'identifiant de votre job de migration.

     Si vous ne connaissez pas l'identifiant, vous pouvez utiliser la commande gcloud database-migration migration-jobs list pour lister tous les jobs de migration dans une région donnée et afficher leurs identifiants.

   • REGION par l'identifiant de la région dans laquelle votre profil de connexion est enregistré.

   Exécutez la commande suivante :

   Linux, macOS ou Cloud Shell

   Remarque : Assurez-vous d'avoir initialisé la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes gcloud auth login et gcloud config set project.

   gcloud database-migration migration-jobs \
   fetch-source-objects MIGRATION_JOB_ID \
     --region=REGION

   Windows (PowerShell)

   Remarque : Assurez-vous d'avoir initialisé la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes gcloud auth login et gcloud config set project.

   gcloud database-migration migration-jobs `
   fetch-source-objects MIGRATION_JOB_ID `
     --region=REGION

   Windows (cmd.exe)

   Remarque : Assurez-vous d'avoir initialisé la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes gcloud auth login et gcloud config set project.

   gcloud database-migration migration-jobs ^
   fetch-source-objects MIGRATION_JOB_ID ^
     --region=REGION

   Résultat

   Le résultat ressemble à ce qui suit :

   Waiting for migration job MIGRATION_JOB_ID
   to fetch source objects with OPERATION_ID
   
   Waiting for operation OPERATION_ID to complete...done.
   
   SOURCE_OBJECT                                      STATE         PHASE              ERROR
   {'database': 'DATABASE_NAME', 'type': 'DATABASE'}  NOT_SELECTED  PHASE_UNSPECIFIED
   {'database': 'DATABASE_NAME', 'type': 'DATABASE'}  STOPPED       CDC                {'code': 1, 'message': 'Internal error'}
   

   Pour savoir si votre opération a réussi, vous pouvez interroger l'objet d'opération renvoyé ou vérifier l'état du job de migration :

   • Utilisez la commande gcloud database-migration migration-jobs describe avec MIGRATION_JOB_ID pour afficher l'état du job de migration.
   • Utilisez la commande gcloud database-migration operations describe avec l'option OPERATION_ID pour afficher l'état de l'opération elle-même.

3. Démarrez le job de migration.
   Démarrez le job de migration en exécutant la commande gcloud database-migration migration-jobs start.

   Pour en savoir plus, développez la section suivante :

   gcloud database-migration migration-jobs start

   Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :

   • MIGRATION_JOB_ID par l'identifiant de votre job de migration.

     Si vous ne connaissez pas l'identifiant, vous pouvez utiliser la commande gcloud database-migration migration-jobs list pour lister tous les jobs de migration dans une région donnée et afficher leurs identifiants.

   • REGION par l'identifiant de la région où votre profil de connexion est enregistré.

   Exécutez la commande suivante :

   Linux, macOS ou Cloud Shell

   Remarque : Assurez-vous d'avoir initialisé la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes gcloud auth login et gcloud config set project.

   gcloud database-migration migration-jobs \
   start MIGRATION_JOB_ID \
     --region=REGION

   Windows (PowerShell)

   Remarque : Assurez-vous d'avoir initialisé la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes gcloud auth login et gcloud config set project.

   gcloud database-migration migration-jobs `
   start MIGRATION_JOB_ID `
     --region=REGION

   Windows (cmd.exe)

   Remarque : Assurez-vous d'avoir initialisé la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes gcloud auth login et gcloud config set project.

   gcloud database-migration migration-jobs ^
   start MIGRATION_JOB_ID ^
     --region=REGION

   Résultat

   L'action est effectuée de manière asynchrone. Par conséquent, cette commande renvoie une entité d'opération qui représente une opération de longue durée :

   done: false
   metadata:
     '@type': type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata
     apiVersion: v1
     createTime: '2024-02-20T12:20:24.493106418Z'
     requestedCancellation: false
     target: MIGRATION_JOB_ID
     verb: start
   name: OPERATION_ID
   

   Pour vérifier si l'opération a réussi, vous pouvez interroger l'objet d'opération renvoyé ou vérifier l'état du job de migration :

   • Utilisez la commande gcloud database-migration migration-jobs describe avec MIGRATION_JOB_ID pour afficher l'état du job de migration.
   • Utilisez la commande gcloud database-migration operations describe avec OPERATION_ID pour afficher l'état de l'opération elle-même.

Promouvoir la tâche de migration

Une fois que la migration atteint la phase de capture des données modifiées (CDC), vous pouvez promouvoir l'instance de base de données de destination d'instance dupliquée avec accès en lecture en instance autonome. Exécutez la commande gcloud database-migration migration-jobs promote :

Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :

• MIGRATION_JOB_ID par l'identifiant de votre job de migration.

  Si vous ne connaissez pas l'identifiant, vous pouvez utiliser la commande gcloud database-migration migration-jobs list pour lister tous les jobs de migration dans une région donnée et afficher leurs identifiants.

• REGION par l'identifiant de la région où votre profil de connexion est enregistré.

Exécutez la commande suivante :

Linux, macOS ou Cloud Shell

Remarque : Assurez-vous d'avoir initialisé la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes gcloud auth login et gcloud config set project.

gcloud database-migration migration-jobs \
promote MIGRATION_JOB_ID \
  --region=REGION

Windows (PowerShell)

Remarque : Assurez-vous d'avoir initialisé la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes gcloud auth login et gcloud config set project.

gcloud database-migration migration-jobs `
promote MIGRATION_JOB_ID `
  --region=REGION

Windows (cmd.exe)

Remarque : Assurez-vous d'avoir initialisé la Google Cloud CLI avec l'authentification et un projet en exécutant la commande gcloud init, ou les commandes gcloud auth login et gcloud config set project.

gcloud database-migration migration-jobs ^
promote MIGRATION_JOB_ID ^
  --region=REGION

Résultat

L'action est effectuée de manière asynchrone. Par conséquent, cette commande renvoie une entité Operation qui représente une opération de longue durée :

done: false
metadata:
  '@type': type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata
  apiVersion: v1
  createTime: '2024-02-20T12:20:24.493106418Z'
  requestedCancellation: false
  target: MIGRATION_JOB_ID
  verb: start
name: OPERATION_ID

Pour vérifier si l'opération a réussi, vous pouvez interroger l'objet d'opération renvoyé ou vérifier l'état du job de migration :

• Utilisez la commande gcloud database-migration migration-jobs describe avec MIGRATION_JOB_ID pour afficher l'état du job de migration.
• Utilisez la commande gcloud database-migration operations describe avec l'option OPERATION_ID pour afficher l'état de l'opération elle-même.