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.
    • Votre sauvegarde complète et vos fichiers journaux de 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 Google Cloud console, sur la page de sélection du projet, sélectionnez ou créez un Google Cloud projet.

    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 homogènes de SQL Server avec Database Migration Service. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

Autorisations requises

Les autorisations suivantes sont requises pour effectuer des migrations homogènes de SQL Server migrations 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 Google Cloud console, 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 à chaque étape de la configuration.

    Vous pouvez mettre en pause la création d'un job de migration à tout moment en cliquant sur ENREGISTRER ET QUITTER. Toutes les données que vous saisissez jusqu'à ce point sont enregistrées dans un brouillon de job de migration. Vous pourrez terminer votre brouillon de job de migration ultérieurement. Consultez la section Mettre à jour un brouillon de job de migration.

  3. Sur la page Premiers pas, saisissez les informations suivantes :
    • Nom du job de migration

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

    • 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 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 for 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 ne disposez 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 un grand nombre de données qui sont apparues dans votre base de données depuis la sauvegarde complète et que vous souhaitez les gérer en bloc plutôt que d'importer plusieurs fichiers journaux de transactions. Pour en savoir plus sur les types de sauvegarde compatibles, consultez la section Types de fichiers de sauvegarde acceptés.

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

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

    Si vous ne disposez pas encore de 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 les 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 généré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 la section 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 pour vos sauvegardes. Pour en savoir plus sur l'utilisation de sauvegardes chiffrées, consultez la section Utiliser des sauvegardes chiffrées.

      Effectuez les actions suivantes :

      • Cliquez sur Modifier les détails à côté de la base de données 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 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. Sur la page 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 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 exécuter à nouveau le test. Pour en savoir plus sur les erreurs possibles, consultez la section Diagnostiquer les problèmes.

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

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

gcloud

Cet exemple utilise l'option facultative --no-async afin 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 les commandes de manière asynchrone. Si vous le faites, vous devez utiliser la gcloud database-migration operations describe commande 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 :

  • 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 pour votre job de migration. Cette valeur s'affiche dans Database Migration Service dans la Google Cloud console.
  • 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 à partir desquels vous souhaitez migrer vos fichiers de sauvegarde. Ces identifiants doivent être identiques aux noms des dossiers de base de données dans votre 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 diff dossier dans votre bucket Cloud Storage.

    Pour en savoir plus sur les fichiers de sauvegarde acceptés, consultez la section Types de fichiers de sauvegarde acceptés.

  • (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 la section 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 poursuivre le processus de migration :

Étape suivante