Migrer des charges de travail Oracle vers Cloud SQL pour PostgreSQL à l'aide de Database Migration Service

Ce guide de démarrage rapide vous explique comment utiliser Database Migration Service pour migrer des charges de travail Oracle 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

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

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   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

3. Make sure that billing is enabled for your Google Cloud project.

4. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   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

5. Make sure that billing is enabled for your Google Cloud project.

6. Enable the Database Migration Service API.

   Enable the API

7. 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 propose diverses options de base de données source, de base de données de destination et de connectivité. Les différentes sources et destinations 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 Oracle 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 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.

Nous supposons également que vous souhaitez migrer vos charges de travail Oracle vers une base de données Cloud SQL pour PostgreSQL de destination.

Dans ce guide de démarrage rapide, vous allez sélectionner Liste d'autorisation d'adresses IP comme méthode de mise en réseau.

Créer des profils de connexion

En créant des profils de connexion, vous créez des enregistrements contenant des informations sur les bases de données source et de destination. Database Migration Service utilise les informations des profils de connexion pour migrer les données de votre base de données Oracle source vers l'instance de base de données Cloud SQL pour PostgreSQL de destination.

Dans cette section, vous allez apprendre à créer des profils de connexion pour :

• Une base de données Oracle source
• Une base de données Cloud SQL pour PostgreSQL de destination

Créer un profil de connexion Oracle

1. Accédez à la page "Profils de connexion" de Database Migration Service dans la console Google Cloud .

   Accéder à la page "Profils de connexion du service de migration de bases de données"

2. Cliquez sur CRÉER UN PROFIL.

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

4. Dans la liste Moteur de base de données, sélectionnez Oracle.

5. Indiquez les informations ci-dessous.

   1. Dans le champ Nom du profil de connexion, saisissez un nom pour le profil de connexion de votre base de données Oracle source, tel que My Oracle Connection Profile.

   2. Conservez l'ID du profil de connexion généré automatiquement.

   3. Sélectionnez la région dans laquelle le profil de connexion est stocké.

      Comme toutes les ressources, les profils de connexion sont enregistrés dans une région. Un job de migration ou un espace de travail de conversion ne peut utiliser que des profils de connexion stockés dans la même région. La sélection de la région n'affecte pas la capacité de Database Migration Service de se connecter à la source, mais peut affecter la connectivité à la destination et la disponibilité si la région subit un temps d'arrêt. Ce choix est définitif et ne peut pas être modifié.

   4. Saisissez le nom d'hôte ou l'adresse IP (domaine ou adresse IP) et le port pour accéder à la base de données Oracle source. (Le port Oracle par défaut est 1521.)

   5. Saisissez un nom d'utilisateur et un mot de passe pour vous authentifier auprès de votre base de données source.

   6. Dans le champ Service name (Nom du service), saisissez le service qui garantit que la base de données Oracle source est protégée et surveillée. Pour les bases de données Oracle, le service de base de données est généralement ORCL.

6. Cliquez sur CONTINUER.

7. Dans la liste Connectivity method (Méthode de connectivité), sélectionnez une méthode de connectivité réseau. Cette méthode définit la manière dont Database Migration Service se connectera à la base de données Oracle source.

   Pour ce guide de démarrage rapide, sélectionnez 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 ou de plages d'adresses IP approuvées à partir desquelles vos utilisateurs peuvent accéder à ces données. Pour utiliser des listes d'autorisation d'adresses IP, vous devez également ouvrir la base de données source ou le pare-feu aux connexions entrantes provenant des adresses IP publiques de Database Migration Service pour la région que vous avez spécifiée pour ce profil de connexion.

8. Cliquez sur RUN TEST (EXÉCUTER LE TEST) pour vérifier que Database Migration Service peut communiquer avec la source.

   Si le test échoue, il indique à quel niveau du processus un problème est survenu. Vous pouvez apporter les modifications nécessaires, puis effectuer un nouveau test sur la page Créer un profil de connexion.

   Accédez à la partie du flux en question pour résoudre le problème, puis effectuez un nouveau test.

9. Cliquez sur CRÉER.

Créer un profil de connexion Cloud SQL pour PostgreSQL

1. Accédez à la page "Profils de connexion" de Database Migration Service dans la console Google Cloud .

   Accéder à la page "Profils de connexion du service de migration de bases de données"

2. Cliquez sur CRÉER UN PROFIL.

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

4. Dans la liste Moteur de base de données, sélectionnez Cloud SQL pour PostgreSQL (car vous souhaitez créer un profil de connexion pour une base de données Cloud SQL pour PostgreSQL de destination).

5. Indiquez les informations ci-dessous.

   1. Dans le champ Nom du profil de connexion, saisissez un nom pour le profil de connexion de votre base de données Cloud SQL pour PostgreSQL de destination, tel que My Cloud SQL for PostgreSQL Connection Profile.

   2. Conservez l'ID du profil de connexion généré automatiquement.

   3. Sélectionnez la région dans laquelle le profil de connexion est stocké.

   4. Sélectionnez l'instance Cloud SQL pour PostgreSQL que vous souhaitez utiliser comme base de données de destination de la migration.

   5. Saisissez le nom d'hôte ou l'adresse IP (domaine ou adresse IP) et le port pour accéder à la base de données de destination. (Le port par défaut de Cloud SQL pour PostgreSQL est 5432.)

   6. Saisissez un nom d'utilisateur et un mot de passe pour vous authentifier auprès de votre base de données de destination.

      Le nom d'utilisateur correspond au nom de l'utilisateur Database Migration Service que vous avez créé pour la base de données de destination (par exemple, postgres).

      Pour en savoir plus sur la création de cet utilisateur, consultez Configurer votre base de données Cloud SQL pour PostgreSQL de destination.

6. Cliquez sur CONTINUER.

7. Dans la section Sécurisez votre connexion, cliquez sur Continuer.

8. 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 Database Migration Service se connectera à la base de données.

   Pour ce démarrage rapide, sélectionnez Adresse IP publique comme méthode de connectivité, car vous utilisez ce profil de connexion pour migrer des données à partir d'un autre type de base de données source, comme Oracle.

   Cette méthode fonctionne si vous avez configuré votre instance Cloud SQL pour PostgreSQL de destination pour qu'elle accepte les connexions via une adresse IP publique. Pour en savoir plus sur l'activation des connexions via une adresse IP publique, consultez la section Configurer une adresse IP publique.

9. Cliquez sur RUN TEST (EXÉCUTER LE TEST) pour vérifier que Database Migration Service peut communiquer avec la base de données de destination.

   Si le test échoue, il indique à quel niveau du processus un problème est survenu. Vous pouvez apporter les modifications nécessaires, puis effectuer un nouveau test sur la page Créer un profil de connexion.

   Accédez à la partie du flux en question pour résoudre le problème, puis effectuez un nouveau test.

10. Cliquez sur CRÉER.

Créer un espace de travail de conversion

Les espaces de travail de conversion vous aident à convertir le schéma et les objets de votre base de données source dans un format compatible avec votre base de données de destination. Cette conversion permet à Database Migration Service de migrer vos données entre les bases de données source et de destination.

Pour créer un espace de travail de conversion, procédez comme suit:

• Définissez les paramètres de l'espace de travail de conversion.
• Connectez-vous à la base de données source et extrayez les informations de votre schéma dans Database Migration Service.

• Effectuez des conversions automatiques avec des ajustements facultatifs à l'aide des éléments suivants:

  • Éditeur de l'espace de travail de conversion : espace d'édition en direct dans lequel vous pouvez modifier le code SQL utilisé pour la conversion
  • Fichiers de configuration Ora2Pg pour fournir des mappages de conversion supplémentaires

• Appliquer le schéma converti à votre base de données de destination: Database Migration Service utilise le code SQL généré pour créer toutes les entités requises dans votre base de données de destination afin de s'assurer que les données de migration peuvent être correctement chargées dans la base de données.

Définir les paramètres de l'espace de travail de conversion

1. Accédez à la page "Espaces de travail de conversion Database Migration Service" dans la console Google Cloud .

   Accéder à la page "Espaces de travail de conversion de Database Migration Service"

2. Cliquez sur CRÉER UN ESPACE DE TRAVAIL.

3. Indiquez les informations ci-dessous.

   1. Dans le champ Nom de l'espace de travail de conversion, saisissez un nom pour l'espace de travail de conversion (par exemple, My Conversion Workspace).

   2. Conservez l'ID de l'espace de travail de conversion généré automatiquement.

   3. Sélectionnez la région dans laquelle l'espace de travail de conversion est stocké.

   4. La liste déroulante Moteur de base de données source est automatiquement renseignée avec Oracle.

   5. Dans la liste déroulante Moteur de base de données de destination, sélectionnez Cloud SQL pour PostgreSQL.

4. 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 espace de travail de conversion. Ces prérequis incluent les éléments suivants:

   • Créer un profil de connexion à la base de données Oracle source

   • Configurez votre base de données Oracle source afin que l'espace de travail de conversion puisse en extraire des données.

   • (Facultatif) Utilisez l'outil de migration Ora2Pg pour créer des mappages supplémentaires pour l'éditeur de l'espace de travail de conversion.

5. Cliquez sur CRÉER UN ESPACE DE TRAVAIL ET CONTINUER.

Se connecter à la source et convertir des objets

1. Ouvrez la liste déroulante Profil de connexion source, puis sélectionnez le profil de connexion que vous avez créé.

2. Cliquez sur RUN TEST (EXÉCUTER LE TEST) pour vérifier que Database Migration Service peut communiquer avec la source.

   Si un test échoue, il indique la partie du processus où un problème est survenu. Vous pouvez apporter les modifications nécessaires, puis effectuer un nouveau test.

   Accédez à la partie du flux en question pour corriger le problème, puis recommencez le test.

3. Cliquez sur Extraire le schéma et continuer.

   Database Migration Service commence à se connecter à votre base de données source pour télécharger des informations de schéma. Cette opération peut prendre quelques minutes, en fonction de facteurs tels que la connectivité réseau ou la taille de la base de données.

   Une fois que Database Migration Service a extrait les informations de schéma, la section Sélectionner et convertir des objets s'ouvre.

4. Utilisez la vue arborescente du schéma pour sélectionner toutes les entités que vous souhaitez que Database Migration Service convertisse en schéma compatible avec le moteur SQL de votre base de données de destination.

5. Cliquez sur Convertir et continuer.

   Database Migration Service crée votre espace de travail de conversion et effectue la conversion de schéma. Vous pouvez désormais prévisualiser le code SQL généré automatiquement dans l'éditeur de l'espace de travail de conversion.

Appliquer à la destination

Une fois le schéma que vous souhaitez utiliser dans la base de données de destination converti, utilisez l'option Appliquer à la destination pour exécuter les instructions SQL générées sur votre base de données de destination:

1. Cliquez sur Appliquer à la destination, puis sélectionnez l'une des options suivantes:

   • Test (recommandé): cette opération effectue un test pour vérifier si votre schéma peut être créé dans la base de données de destination.
   • Appliquer: cette opération tente de créer votre schéma converti dans la base de données de destination.

2. Dans la section Définir la destination, sélectionnez le profil de connexion qui pointe vers votre base de données de destination.

3. Cliquez sur Définir et continuer.

4. Dans la section Examiner les objets et appliquer la conversion à la destination, sélectionnez les schémas des entités de base de données que vous souhaitez créer dans votre base de données de destination.

5. Cliquez sur Appliquer à la destination.

Créer une tâche 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 pour PostgreSQL de destination.

La création d'un job de migration comprend les étapes suivantes:

• Définir les paramètres de la tâche
• Spécifier des informations sur le profil de connexion que vous avez créé pour votre base de données source (profil de connexion source)
• Spécifier des informations sur le profil de connexion que vous avez créé pour votre base de données de destination (profil de connexion de destination)
• Configurer les objets que vous souhaitez migrer à partir de la base de données source
• Tester la tâche de migration pour vous assurer que les informations de connexion fournies pour la tâche 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 "Tâches de migration de Database Migration Service"

2. Cliquez sur CRÉER UNE TÂCHE 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 tâche de migration généré automatiquement.

5. Dans le menu Moteur de base de données source, sélectionnez Oracle.

6. Dans le menu Moteur de base de données de destination, sélectionnez Cloud SQL pour PostgreSQL.

7. Sélectionnez la région dans laquelle l'instance de destination doit être créée.

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 pour PostgreSQL de destination. Il est préférable d'appliquer ces prérequis dès la présente étape, mais vous pouvez le faire à tout moment avant de tester ou de démarrer le job de migration. Pour en savoir plus sur ces conditions préalables, consultez la section Configurer votre base de données Oracle source.

9. Cliquez sur SAVE AND CONTINUE (ENREGISTRER ET CONTINUER).

Définir les paramètres de la source

Sur la page Définir votre source, procédez comme suit:

1. Dans le menu déroulant Profil de connexion source, sélectionnez le profil de connexion source de votre instance Oracle.
2. Cliquez sur Enregistrer et continuer.
3. (Facultatif) Dans la section Tester le profil de connexion, cliquez sur Exécuter le test pour vérifier si Database Migration Service peut établir une connexion réseau avec votre instance source.

   Vous pouvez créer la tâche de migration même si le test de connexion échoue, mais vous devez résoudre les problèmes de connectivité avant d'exécuter la tâche de migration.

4. Dans la section Personnaliser la configuration de la source, configurez les paramètres suivants :
   • Dans la section Configuration du dump complet, sélectionnez Automatique.
   • Dans les paramètres de lecture de la source, utilisez les valeurs par défaut de simultanéité suggérées.
5. Cliquez sur Enregistrer et continuer.

Définir les paramètres de destination

Sur la page Définir votre destination, procédez comme suit:

1. Dans le menu déroulant Profil de connexion de destination, sélectionnez le profil de connexion de destination.
2. Cliquez sur Enregistrer et continuer.
3. (Facultatif) Dans la section Tester le profil de connexion, cliquez sur Exécuter le test pour vérifier si Database Migration Service peut établir une connexion réseau avec votre destination.

   Vous pouvez créer la tâche de migration même si le test de connexion échoue, mais vous devez résoudre les problèmes de connectivité avant d'exécuter la tâche de migration.

4. Dans la section Personnaliser la configuration de la destination, configurez les paramètres suivants :
   • Dans la section Nombre maximal de connexions de destination simultanées, utilisez les valeurs par défaut de simultanéité suggérées.
   • Dans la section Délai avant expiration de la transaction, utilisez les valeurs par défaut suggérées.
5. Cliquez sur Enregistrer et continuer.

Sélectionner les objets à migrer

1. Sélectionnez votre espace de travail de conversion dans la liste déroulante Espace de travail de conversion.

   Une fois que vous avez sélectionné un espace de travail de conversion, la région Sélectionner les objets à migrer de la page liste tous les objets (schémas et tables) de la base de données source Oracle pouvant être migrés vers la destination.

2. Dans la liste, sélectionnez les objets de base de données que vous souhaitez que Database Migration Service migre.

3. Cliquez sur SAVE AND CONTINUE (ENREGISTRER ET CONTINUER).

Tester et créer la tâche de migration

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

2. Cliquez sur JOB DE TEST pour vérifier les points suivants:

   • La source a été configurée en fonction des conditions préalables.

   • Database Migration Service peut se connecter à la source.

   • Database Migration Service peut se connecter à la destination.

   • La tâche 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.

3. Cliquez sur CREATE & START JOB (CRÉER ET DÉMARRER LA TÂCHE) pour créer la tâche de migration et la démarrer immédiatement.

4. Cliquez sur CRÉER ET DÉMARRER dans la boîte de dialogue qui s'affiche.

5. 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 à "Running" (En cours d'exécution).

Vérifier le job de migration

Dans cette section, vous vérifiez 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 pour PostgreSQL de destination.

Valider à l'aide de l'outil de validation des données

Vous pouvez utiliser un outil de validation des données Open Source pour vérifier plus précisément que les données correspondent entre la source et la destination.

Les étapes suivantes présentent un exemple minimal pour exécuter des validations plus exactes:

1. Déployez ou utilisez une machine virtuelle ayant accès à la source et à la destination.

2. Dans la machine virtuelle, créez un dossier dans lequel installer l'outil de validation des données.

3. Accédez à ce dossier.

4. Utilisez pip pour installer l'outil de validation des données.

   pip install google-pso-data-validator
   

5. Créez des connexions à la base de données Oracle source et à la base de données Cloud SQL pour PostgreSQL de destination.

   data-validation connections add -c source Oracle --host 'ip-address' --port port --user username --password pswd --database database-name
   data-validation connections add -c target Postgres --host 'ip-address' --port port --user username --password pswd --database database-name
   

   Exemple :

   data-validation connections add -c source Oracle --host '10.10.10.11' --port 1521 --user system --password pswd --database XE
   data-validation connections add -c target Postgres --host '10.10.10.12' --port 5432 --user postgres --password pswd --database postgres
   

6. Créez ou générez une liste de tables pour comparer les données entre les bases de données source et de destination.

   export TABLES_LIST=$(data-validation find-tables --source-conn target --target-conn target --allowed-schemas schema-name)
   

   Exemple :

   export TABLES_LIST=$(data-validation find-tables --source-conn target --target-conn target --allowed-schemas public)
   

7. Exécutez une validation complète sur toutes les tables.

   data-validation validate column --source-conn source --target-conn target --tables-list "${TABLES_LIST}"
   

Nous vous suggérons d'exécuter cette validation lors de la réplication pour garantir une cohérence relative. Les requêtes de table volumineuses peuvent prendre trop de temps à s'exécuter pendant une courte période de promotion. Dans ce cas, utilisez l'outil de validation des données pour ajouter des filtres afin de réduire la durée d'exécution ou préparez la liste des tableaux pour inclure un sous-ensemble de tableaux à la validation finale.

Cela confirme que Database Migration Service a migré les données.

Finaliser la migration

Pour les migrations continues, finalisez la tâche de migration lorsque vous souhaitez commencer à utiliser votre instance de destination pour votre application.

Vous pouvez utiliser le bouton Mettre en avant sur la page d'informations du job de migration pour demander à Database Migration Service de nettoyer toutes les données de migration temporaires et de mettre en avant votre destination.

1. Revenez à la page Jobs de migration.

2. Cliquez sur le job de migration que vous avez créé dans ce guide de démarrage rapide. Il s'agit de la migration que vous souhaitez finaliser. La page Informations sur le job de migration s'affiche.

3. Utilisez l'outil de validation des données pour suivre le délai de réplication en vérifiant le nombre de lignes.

   Attendez que le délai de réplication diminue de manière significative, idéalement de l'ordre de minutes ou de secondes. Vous pouvez consulter le délai de réplication sur la page Jobs de migration.

4. Une fois le délai de réplication minimal, lancez la transition. Pour éviter de perdre des données, assurez-vous de:

   1. Arrêtez toutes les écritures, les scripts en cours d'exécution et les connexions client à la base de données source. C'est ici que commence la période d'arrêt.

   2. Attendez que le délai de réplication soit nul, ce qui signifie que la tâche de migration a traité toutes les modifications en attente.

   Vous pouvez finaliser une migration même si le délai de réplication n'est pas nul. Cela peut réduire le temps d'arrêt de la base de données, mais peut affecter l'exactitude des données dans la destination.

   1. Sur la page des détails de la tâche de migration, cliquez sur Promouvoir, puis confirmez l'action dans la fenêtre Promouvoir la tâche de migration ?.

   La tâche de migration arrête de lire à partir de votre base de données source. Database Migration Service met à niveau votre instance de destination Cloud SQL pour PostgreSQL afin de nettoyer toutes les données de migration temporaires. Ce processus peut prendre plusieurs minutes.

5. Une fois le processus de promotion terminé, l'état de la tâche de migration passe à Terminé.

6. Vous pouvez désormais connecter votre application à l'instance Cloud SQL pour PostgreSQL de destination et supprimer en toute sécurité le job de migration.

Votre instance de base de données Cloud SQL pour PostgreSQL est prête à l'emploi.

Effectuer un nettoyage

Pour éviter que les ressources utilisées sur cette page ne soient facturées sur votre compte Google Cloud , suivez les étapes ci-dessous.

1. Utilisez la console Google Cloud pour supprimer votre job de migration, votre espace de travail de conversion, vos profils de connexion, votre instance Cloud SQL pour PostgreSQL de destination et votre projet si vous n'en avez pas besoin.

Étape suivante

• Découvrez comment gérer les profils de connexion.
• Découvrez comment gérer les espaces de travail de conversion.
• En savoir plus sur les états des tâches de migration