Créer une tâche de migration

Database Migration Service utilise des jobs de migration pour migrer des données de vos bases de données sources vers l'instance Cloud SQL de destination. Les jobs de migration vous aident à organiser les profils de connexion source et de destination, à définir des paramètres spécifiques au processus de migration, à surveiller la progression et à finaliser l'ensemble de l'opération en toute sécurité.

La création d'un job de migration comprend les tâches suivantes :

  • Sélectionner des profils de connexion source et de destination.

  • Choisir les bases de données détectées dans votre instance source que vous souhaitez migrer.

  • Effectuer un test de job de migration pour vous assurer que Database Migration Service peut se connecter à votre source de données et à votre destination.

  • Démarrer le job de migration et surveiller sa progression

  • Promouvoir le job de migration lorsque vous souhaitez basculer votre application vers la nouvelle instance.

Avant de commencer

  1. Assurez-vous de remplir les conditions suivantes :
    • Vous disposez d'un bucket Cloud Storage pour les fichiers de sauvegarde SQL Server.
    • Vos fichiers de sauvegarde complète et de journal des transactions sont importés dans le bucket Cloud Storage.
    • Vous disposez d'un profil de connexion source pour le bucket Cloud Storage.
    • Vous avez créé et configuré votre instance Cloud SQL pour SQL Server de destination, et vous disposez d'un profil de connexion de destination pour l'instance.
  2. Dans la console Google Cloud , sur la page de sélection du projet, sélectionnez ou créez un projet Google Cloud .

    Accéder au sélecteur de projet

  3. Activez les API Database Migration Service, Compute Engine, Cloud Storage et Cloud SQL Admin.

    Activer les API

Rôles requis

Pour obtenir les autorisations nécessaires pour créer des jobs de migration dans Database Migration Service, demandez à votre administrateur de vous accorder les rôles IAM suivants sur votre projet :

Pour en savoir plus sur l'attribution de rôles, consultez la section Gérer les accès.

Ces rôles prédéfinis contiennent les autorisations requises pour effectuer des migrations SQL Server homogènes avec Database Migration Service. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

Autorisations requises

Vous devez disposer des autorisations suivantes pour effectuer des migrations SQL Server homogènes avec Database Migration Service :

  • datamigration.*
  • resourcemanager.projects.get
  • resourcemanager.projects.list
  • cloudsql.instances.create
  • cloudsql.instances.get
  • cloudsql.instances.list
  • cloudsql.databases.get
  • cloudsql.databases.delete
  • cloudsql.operations.get
  • compute.machineTypes.list
  • compute.machineTypes.get
  • compute.projects.get
  • storage.buckets.create
  • storage.buckets.list
  • storage.objects.list

Vous pouvez également obtenir ces autorisations avec des rôles personnalisés ou d'autres rôles prédéfinis.

Définir les paramètres et créer un job de migration

Pour créer un job de migration, procédez comme suit :

Console

  1. Dans la console Google Cloud , accédez à la page Jobs de migration.

    Accéder à la page "Jobs de migration"

  2. Cliquez sur Créer un job de migration.

    La page de l'assistant de configuration du job de migration s'ouvre. Cet assistant contient plusieurs panneaux qui vous guident à travers chaque étape de configuration.

    Vous pouvez suspendre la création d'un job de migration à tout moment en cliquant sur ENREGISTRER ET QUITTER. Toutes les données que vous avez saisies jusqu'à ce stade sont enregistrées dans un brouillon de job de migration. Vous pourrez terminer votre brouillon de job de migration plus tard. Consultez Mettre à jour un job de migration brouillon.

  3. Sur la page Premiers pas, saisissez les informations suivantes :
    • Nom de la tâche de migration

      Il s'agit d'un nom lisible par l'humain pour votre job de migration. Cette valeur s'affiche dans la console Google Cloud .

    • ID du job de migration

      Il s'agit d'un identifiant lisible par machine pour votre job de migration. Vous utilisez cette valeur pour travailler avec des jobs de migration à l'aide des commandes de la Google Cloud CLI ou de l'API Database Migration Service.

    • Dans la liste Moteur de base de données source, sélectionnez SQL Server ou Amazon RDS pour SQL Server.

    Les champs Moteur de base de données de destination et Type de mission de migration sont renseignés automatiquement et ne peuvent pas être modifiés.

  4. Cliquez sur Enregistrer et continuer.
  5. Sur la page Définir votre source, procédez comme suit :
    1. Utilisez le menu déroulant pour sélectionner votre profil de connexion source.

      Si vous n'avez pas encore de profil de connexion source, vous pouvez cliquer sur Créer un profil de connexion directement dans le menu déroulant. Pour en savoir plus sur la création de profils de connexion, consultez Créer un profil de connexion source.

    2. Si vous souhaitez utiliser un fichier de sauvegarde différentielle dans votre migration, cochez la case Utiliser des sauvegardes différentielles dans la section Personnaliser les configurations sources.

      Les sauvegardes différentielles sont utiles si vous devez répliquer une grande quantité de données apparues dans votre base de données depuis la sauvegarde complète et que vous souhaitez les traiter de manière groupée plutôt que d'importer plusieurs fichiers journaux de transactions. Pour en savoir plus sur les types de sauvegardes compatibles, consultez Types de fichiers de sauvegarde compatibles.

      Si vous utilisez des sauvegardes différentielles, veillez à créer le dossier diff dans votre bucket Cloud Storage. Consultez Stocker des fichiers de sauvegarde dans un bucket Cloud Storage.

    3. Cliquez sur Enregistrer et continuer.
  6. Sur la page Définir une destination, sélectionnez votre profil de connexion de destination dans le menu déroulant.

    Si vous ne disposez pas encore d'un profil de connexion de destination, vous pouvez cliquer sur Créer un profil de connexion directement dans le menu déroulant. Pour en savoir plus sur la création de profils de connexion, consultez Créer un profil de connexion de destination.

  7. Cliquez sur Enregistrer et continuer.
  8. Sur la page Configurer des bases de données de migration, procédez comme suit :
    1. Dans la section Sélectionner les bases de données à migrer, cochez les cases correspondant aux bases de données que vous souhaitez inclure dans ce job de migration. Cette liste est renseignée en fonction des dossiers que vous avez créés dans le bucket Cloud Storage pour vos fichiers de sauvegarde.

      Vous pourrez ajouter et supprimer des bases de données du job de migration ultérieurement. Consultez Ajouter ou supprimer des bases de données d'un job de migration.

    2. (Facultatif) Si vous utilisez des sauvegardes chiffrées, fournissez les clés de chiffrement de vos sauvegardes. Pour en savoir plus sur l'utilisation des sauvegardes chiffrées, consultez Utiliser des sauvegardes chiffrées.

      Effectuez les actions suivantes :

      • Cliquez sur Modifier les détails à côté de la base de données que vous avez sélectionnée pour la migration.

        Le panneau latéral Chiffrement s'ouvre.

      • Utilisez les menus déroulants Clé de chiffrement pour sélectionner vos clés.
      • Dans le champ Password (Mot de passe), saisissez le mot de passe de la clé de chiffrement.
      • Cliquez sur Enregistrer et quitter.
  9. Cliquez sur Enregistrer et continuer.
  10. Dans l'onglet Tester et créer le job de migration, procédez comme suit :
    1. (Facultatif) Cliquez sur Tester le job pour vérifier si Database Migration Service peut identifier correctement tous les fichiers de sauvegarde et établir les connexions réseau nécessaires.

      Si le test échoue, vous pouvez consulter les messages d'erreur pour résoudre le problème, puis l'exécuter à nouveau. Pour en savoir plus sur les erreurs possibles, consultez Diagnostiquer les problèmes.

    2. Cliquez sur Créer et démarrer le job pour lancer la migration.

      Si vous souhaitez effectuer le job de migration à un autre moment, cliquez sur Enregistrer et revenez plus tard pour l'exécuter. Consultez Démarrer un job de migration.

gcloud

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 des 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 Database Migration Service dans la console Google Cloud .
  • SOURCE_CONNECTION_PROFILE_ID par un identifiant lisible par machine du profil de connexion source.
  • DESTINATION_CONNECTION_PROFILE_ID par un identifiant lisible par machine du profil de connexion de destination.
  • COMMA_SEPARATED_DATABASE_ID_LIST par une liste d'identifiants de base de données SQL Server séparés par une virgule que vous souhaitez migrer à partir de vos fichiers de sauvegarde. Ces identifiants doivent être identiques aux noms des dossiers de base de données dans votre bucket Cloud Storage.

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

  • Configuration de la sauvegarde différentielle : si vous utilisez des fichiers de sauvegarde différentielle pour la migration, ajoutez l'option --sqlserver-diff-backup à votre commande. Par défaut, les jobs de migration n'utilisent pas de fichiers de sauvegarde différentielle et ignorent le dossier diff de votre bucket Cloud Storage.

    Pour en savoir plus sur les fichiers de sauvegarde compatibles, consultez Types de fichiers de sauvegarde compatibles.

  • (Facultatif) MAPPING_FILE_FOR_PATHS_TO_ENCRYPTION_KEYS par le chemin d'accès de votre disque local vers un fichier de configuration qui mappe les chemins d'accès aux clés de chiffrement dans Cloud Storage avec leurs identifiants de base de données pertinents. Pour en savoir plus sur la création de ce fichier de mappage, consultez Utiliser des sauvegardes chiffrées.

    Par exemple : --sqlserver-encrypted-databases=~/encryption-keys-mapping-file.json

Exécutez la commande suivante :

Linux, macOS ou Cloud Shell

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 \
  --sqlserver-databases=COMMA_SEPARATED_DATABASE_ID_LIST \
  --sqlserver-encrypted-databases=MAPPING_FILE_FOR_PATHS_TO_ENCRYPTION_KEYS \
  --type=CONTINUOUS

Windows (PowerShell)

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 `
  --sqlserver-databases=COMMA_SEPARATED_DATABASE_ID_LIST `
  --sqlserver-encrypted-databases=MAPPING_FILE_FOR_PATHS_TO_ENCRYPTION_KEYS `
  --type=CONTINUOUS

Windows (cmd.exe)

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 ^
  --sqlserver-databases=COMMA_SEPARATED_DATABASE_ID_LIST ^
  --sqlserver-encrypted-databases=MAPPING_FILE_FOR_PATHS_TO_ENCRYPTION_KEYS ^
  --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ésultat

Le job de migration est maintenant créé. Vous pouvez procéder à la migration :

Étapes suivantes