Mettre à niveau une instance vers l'édition Cloud SQL Enterprise Plus à l'aide des listes d'autorisation d'adresses IP

MySQL | PostgreSQL | SQL Server

Remarque : Cette page contient des fonctionnalités liées aux éditions Cloud SQL. Pour en savoir plus sur les éditions Cloud SQL, consultez la page Présentation des éditions Cloud SQL.

Cette page explique comment utiliser la méthode de connectivité réseau de liste d'autorisation IP publique de Database Migration Service pour mettre à niveau une instance Cloud SQL Enterprise vers Cloud SQL Enterprise Plus. Database Migration Service crée une instance Cloud SQL et migre les données vers cette instance.

Présentation

L'édition Cloud SQL Enterprise Plus est idéale pour les applications nécessitant des performances d'écriture maximales. Pour en savoir plus sur ces améliorations, consultez la section Amélioration des performances.

Pour activer ces améliorations pour vos instances Cloud SQL Enterprise existantes, vous devez les mettre à niveau vers Cloud SQL Enterprise Plus à l'aide de Database Migration Service.

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. Activez Database Migration Service.

   Activer l'API

7. Assurez-vous que le rôle "Administrateur de migration de bases de données" est bien attribué à votre compte utilisateur.

   Accéder à IAM

Conditions requises

Database Migration Service est compatible avec diverses options de base de données source et méthodes de connectivité réseau. Les différentes sources fonctionnent mieux avec certaines méthodes de connectivité qu'avec d'autres. Sur cette page, nous partons du principe que vous utilisez une instance Cloud SQL Enterprise dans un environnement où vous pouvez configurer votre réseau afin d'ajouter une règle de pare-feu entrante. 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.

Configurer l'instance source

Pour configurer votre instance Cloud SQL Enterprise source, procédez comme suit :

1. Si vous ne disposez pas de base de données postgres pour votre instance source, créez-en une. Pour en savoir plus, consultez la page Créer une base de données sur l'instance Cloud SQL.
2. Installez le package pglogical sur les bases de données de votre instance source. Assurez-vous que le package est inclus dans la variable shared_preload_libraries. Pour en savoir plus, consultez la page Configurer vos bases de données sources.
3. Activez la réplication logique et le décodage pour les bases de données de votre instance source. Pour en savoir plus, consultez la page Activer la réplication logique et le décodage pour vos bases de données sources.

Configurer vos bases de données sources

Remarque : Pour PostgreSQL 9.4, installez l'extension pglogical_origin. Ensuite, installez l'extension sur chaque base de données en exécutant les commandes suivantes :

• CREATE EXTENSION IF NOT EXISTS pglogical_origin;
• CREATE EXTENSION IF NOT EXISTS pglogical;

Outre les bases de données template0 et template1, Database Migration Service migre toutes les autres bases de données sous votre instance Cloud SQL Enterprise source.

Sur chaque base de données de votre instance source qui n'est pas mentionnée ci-dessus, procédez comme suit :

1. Pour installer l'extension pglogical sur la base de données, exécutez la commande CREATE EXTENSION IF NOT EXISTS pglogical.

2. Pour toutes les tables sans clé primaire, migrez manuellement les instructions UPDATE et DELETE.

   Remarque : Pour les tables qui ne possèdent pas de clés primaires, Database Migration Service permet de migrer l'instantané initial ainsi que les instructions INSERT pendant la phase de capture des données modifiées (CDC, Change Data Capture).

   Pour savoir comment générer une requête permettant de répertorier les tables dans une base de données PostgreSQL sans clés primaires, consultez la section Débogage et autres outils. Pour chaque table de base de données sans clé primaire et devant être migrée, modifiez la table de sorte qu'elle contienne une clé primaire ou migrez les opérations UPDATE et DELETE pour la table. Pour les tables sans clés primaires, seuls l'instantané initial et les instructions INSERT sont migrés.

3. Pour définir ces droits sur chacune des bases de données migrées, créez un utilisateur ou attribuez les droits à un utilisateur existant. Vous vous connecterez à l'instance source avec cet utilisateur, que vous devez configurer sur la page Profils de connexion. Cet utilisateur doit disposer de certains privilèges sur chacune des bases de données migrées, ainsi que sur la base de données postgres par défaut.

   Pour définir ces droits, connectez-vous à l'instance et exécutez les commandes suivantes :

   1. GRANT USAGE on SCHEMA SCHEMA to USER sur tous les schémas (à l'exception du schéma d'informations et des schémas commençant par pg_) sur chaque base de données que vous souhaitez migrer.
   2. GRANT USAGE on SCHEMA pglogical to PUBLIC; sur chaque base de données que vous souhaitez migrer.
   3. GRANT SELECT on ALL TABLES in SCHEMA pglogical to USER sur toutes les bases de données afin d'obtenir des informations de réplication à partir des bases de données sources.
   4. GRANT SELECT on ALL TABLES in SCHEMA SCHEMA to USER sur tous les schémas (à l'exception du schéma d'informations et des schémas commençant par pg_) sur chaque base de données que vous souhaitez migrer.
   5. GRANT SELECT on ALL SEQUENCES in SCHEMA SCHEMA to USER sur tous les schémas (à l'exception du schéma d'informations et des schémas commençant par pg_) sur chaque base de données que vous souhaitez migrer.
   6. ALTER USER USER with REPLICATION role

Activer la réplication logique et le décodage pour vos bases de données sources.

Activez la réplication logique et le décodage pour les bases de données de votre instance Cloud SQL Enterprise en définissant les options cloudsql.logical_decoding et cloudsql.enable_pglogical sur On. Pour en savoir plus sur ces options, consultez la section Configurer des options de base de données.

Pour activer ces deux options, procédez comme suit :

1. Dans la console Google Cloud, accédez à la page Instances Cloud SQL.

   Accéder à la page Instances Cloud SQL

2. Cliquez sur votre instance source.
3. Cliquez sur Modifier.
4. Dans la section Personnaliser votre instance, cliquez sur le menu Afficher les options de configuration s'il s'affiche.

5. Développez la section Options.

6. Pour définir les options cloudsql.logical_decoding et cloudsql.enable_pglogical, procédez comme suitº:

   1. Cliquez sur Ajouter une option de base de données.
   2. Dans le menu déroulant, choisissez l'option cloudsql.logical_decoding.
   3. Définissez la valeur de cette option sur On.
   4. Cliquez sur OK.
   5. Répétez ces étapes pour l'option cloudsql.enable_pglogical.

7. Cliquez sur Enregistrer.

8. Dans la boîte de dialogue Redémarrage nécessaire à la suite des modifications, cliquez sur Enregistrer et redémarrer. Cloud SQL redémarre votre instance source pour que les modifications de configuration apportées aux options soient prises en compte.

9. Dans le volet Configuration, confirmez vos modifications dans la section Options de base de données.

Créez un profil de connexion

Un profil de connexion contient des informations sur la base de données Cloud SQL Enterprise 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 Cloud SQL Enterprise Plus de destination.

Pour créer un profil de connexion, procédez comme suit :

1. Dans la console Google Cloud, accédez à la page Profils de connexion dans Database Migration Service.

   Accéder à la page "Profils de connexion"

2. Cliquez sur Créer un profil.

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

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

   Remarque : Cloud SQL génère automatiquement l'ID du profil de connexion en utilisant les informations de votre instance source. Nous vous recommandons de ne pas modifier cette valeur.

5. Sélectionnez la région dans laquelle vous souhaitez enregistrer le profil de connexion.

   Remarque : Comme toutes les ressources, les profils de connexion sont enregistrés dans une région. Le choix de région n'affecte pas les jobs de migration pouvant utiliser des profils de connexion, ni les régions qui peuvent se connecter à l'emplacement des données. Cependant, le choix de région peut affecter la disponibilité en cas de temps d'arrêt régional.

6. Dans la liste déroulante Instance Cloud SQL, sélectionnez le nom de votre instance Cloud SQL Enterprise.

7. Pour vous authentifier auprès de votre instance source, saisissez un nom d'utilisateur et un mot de passe. Cliquez ensuite sur Continuer.

   Remarque : Cloud SQL renseigne automatiquement les champs Nom d'hôte ou adresse IP et Port avec les informations sur votre instance source. Si ces champs sont vides, saisissez les valeurs appropriées.

8. Si vous souhaitez chiffrer vos données, activez 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.

9. Cliquez sur Continuer.

10. Dans le menu déroulant Tests de connectivité, sélectionnez Adresse IP publique.

11. Vérifiez que la source a été correctement configurée et que Database Migration Service peut communiquer avec la source:

    1. Cliquez sur Run test (Exécuter le test).

    2. Vérifiez que l'état Your connection profile test was successful! s'affiche.

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

12. Cliquez sur Créer.

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 Cloud SQL Enterprise source vers l'instance Cloud SQL Enterprise Plus 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 Cloud SQL Enterprise source. Il s'agit de votre profil de connexion source.
• Définir les paramètres de l'instance Cloud SQL Enterprise Plus 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

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

   Accéder à la page "Jobs de migration"

2. Cliquez sur Créer un job 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. Dans la liste déroulante Moteur de base de données source, sélectionnez Cloud SQL pour PostgreSQL.

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

6. Sélectionnez la région de destination dans laquelle l'instance Cloud SQL Enterprise Plus est créée.

7. Dans la liste déroulante Type de job de migration, sélectionnez Continu, car vous souhaitez que les modifications en cours dans votre base de données Cloud SQL Enterprise source soient migrées vers l'instance Cloud SQL Enterprise Plus de destination.

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 Cloud SQL Enterprise source et la connexion à l'instance Cloud SQL Enterprise Plus.

   Il est recommandé 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.

9. Cliquez sur Enregistrer et continuer.

Spécifier des informations sur le profil de connexion source

1. Dans la liste déroulante Sélectionner le profil de connexion source, sélectionnez le profil de connexion que vous avez créé.

2. Cliquez sur Enregistrer et continuer.

Définir les paramètres de l'instance Cloud SQL Enterprise Plus de destination

1. Dans le champ Mot de passe, saisissez un mot de passe alphanumérique pour l'instance Cloud SQL Enterprise Plus de destination. Il s'agit du mot de passe du compte administrateur postgres dans l'instance.

2. Dans la liste déroulante Version de la base de données, sélectionnez l'instance de destination dans la liste des versions Cloud SQL compatibles avec le moteur de base de données spécifié.

3. Sélectionnez Enterprise Plus.

4. Dans la section Sélectionner une région et une zone, sélectionnez la zone Google Cloud souhaitée pour la nouvelle instance Cloud SQL Enterprise Plus (ou laissez l'option Indifférent).

5. Cochez la case IP publique.

6. Sélectionnez la forme de la machine pour l'instance Cloud SQL Enterprise Plus. La taille du disque doit être supérieure ou égale à la taille de la base de données source.

7. Définissez le type de stockage et la capacité de stockage de l'instance Cloud SQL.

8. Pour créer l'instance, cliquez sur Créer et continuer.

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

   Important : Cette procédure crée une instance Cloud SQL Enterprise Plus. Vous êtes facturé en fonction de la configuration sélectionnée.

Configurer la connectivité

1. Dans la liste déroulante Méthode de connectivité, sélectionnez Liste d'autorisation d'adresses IP.

   Remarque : 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. De plus, pour utiliser des listes d'autorisation d'adresses IP, vous devez ouvrir la base de données ou le pare-feu source aux connexions entrantes de l'instance Cloud SQL Enterprise Plus de destination.

   L'affichage des adresses IP dans la région Adresses IP sortantes de destination peut prendre quelques minutes.

2. Pour utiliser les adresses IP sortantes de votre instance de destination Cloud SQL Enterprise Plus pour établir une connexion à l'instance Cloud SQL Enterprise Edition, procédez comme suit :

   1. Dans la région Adresses IP sortantes de destination, cliquez sur Tout copier.
   2. Ouvrez un nouvel onglet dans votre navigateur.

   3. Dans la console Google Cloud, accédez à la page Instances Cloud SQL.

      Accéder à la page Instances Cloud SQL

   4. Cliquez sur votre instance source.
   5. Cliquez sur Modifier.
   6. Dans la section Personnaliser votre instance, cliquez sur le menu Afficher les options de configuration s'il s'affiche.
   7. Cliquez sur la section Connexions.
   8. Cliquez sur Ajouter un réseau.
   9. Dans le champ Nom, indiquez un nom pour le réseau qui représente la première adresse IP que vous avez copiée (par exemple, My First Network). Ce réseau permet d'établir une connexion entre les instances de base de données Cloud SQL Enterprise source et Cloud SQL Enterprise Plus de destination.
   10. Dans le champ Réseau, saisissez la première adresse IP que vous avez copiée, suivie de /32. Cela limite le réseau de façon à n'accepter que les connexions à partir de cette adresse IP.
   11. Cliquez sur OK.
   12. Répétez ces étapes pour chaque adresse IP que vous avez copiée.
   13. Cliquez sur Enregistrer. Cloud SQL redémarre votre instance Cloud SQL Enterprise source pour que les modifications de configuration que vous avez apportées soient prises en compte.

3. Dans l'onglet contenant le job de migration, cliquez sur Enregistrer et continuer.

Tester, créer et démarrer le job de migration

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

2. Vérifiez que la source a été correctement configurée, que les instances Cloud SQL Enterprise source et Cloud SQL Enterprise Plus de destination sont en mesure de communiquer entre elles, et que le job de migration est valide :

   1. Cliquez sur Tester le job.

   2. Vérifiez que l'état Your migration job test was successful! s'affiche.

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

3. Pour créer le job de migration et le démarrer immédiatement, cliquez sur Créer et démarrer le job.

4. Dans la boîte de dialogue qui s'affiche, cliquez sur Créer et démarrer.

5. Sur la page Jobs de migration, vérifiez que l'état de votre job de migration est Starting.

6. Après quelques minutes, vérifiez que l'état passe à Running.

Vérifier le job de migration

Pour 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 Cloud SQL Enterprise source vers l'instance de base de données Cloud SQL Enterprise Plus de destination, procédez comme suit :

1. Dans la console Google Cloud, accédez à la page Instances SQL.

   Accéder à la page "Instances Cloud SQL"

2. Cliquez sur l'entrée correspondant à l'instance dupliquée avec accès en lecture de votre job de migration.

   Remarque : Assurez-vous que l'édition Cloud SQL de cette entrée est Enterprise Plus, et non Enterprise.
3. Cliquez sur l'icône Activer Cloud Shell qui apparaît à côté du champ Rechercher.

4. Lorsque vous y êtes invité, pour vous connecter à l'instance de base de données Cloud SQL Enterprise Plus de destination, utilisez la commande gcloud sql connect.

   gcloud sql connect DESTINATION_INSTANCE_NAME --user=postgres

   Remplacez DESTINATION_INSTANCE_NAME par le nom de l'instance Cloud SQL Enterprise Plus de destination.

5. Facultatif : Si une boîte de dialogue Autoriser Cloud Shell s'affiche, cliquez sur Autoriser.
6. Lorsque l'invite Saisir un mot de passe s'affiche, saisissez le mot de passe que vous avez fourni dans Définir les paramètres de l'instance Cloud SQL Enterprise Plus de destination.

7. 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 Cloud SQL Enterprise source est bien affichée.
8. 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 de postgres à SOURCE_DB_NAME.
9. Dans l'invite SOURCE_DB_NAME, pour afficher les tables de cette instance, saisissez \dt.
10. Dans l'invite SOURCE_DB_NAME, saisissez GRANT cloudsqlexternalsync to USER; pour autoriser cet utilisateur à accéder aux données des tables de cette instance.

    Remplacez USER par le nom de l'utilisateur que vous avez utilisé pour vous connecter à l'instance de base de données Cloud SQL Enterprise Plus de destination.

11. Dans l'invite SOURCE_DB_NAME, pour afficher les informations répliquées à partir d'une table de votre instance de base de données Cloud SQL Enterprise source, saisissez SELECT * from TABLE_NAME;.
12. Vérifiez que les informations qui s'affichent dans le tableau sont correctes.

Promouvoir la tâche de migration

La promotion du job de migration remplace l'instance de base de données Cloud SQL Enterprise source par l'instance de base de données Cloud SQL Enterprise Plus de destination en tant que base de données principale.

Pour promouvoir le job de migration, procédez comme suit :

1. Revenez à la page Jobs de migration.

2. Cliquez sur le job de migration que vous souhaitez promouvoir. La page Informations sur le job de migration s'affiche.

3. Arrêtez toutes les opérations en écriture dans la base de données Cloud SQL Enterprise source.

   Important : Avant d'arrêter les opérations d'écriture sur la base de données source, attendez que le délai de réplication soit minimal.

   Vous devez arrêter toutes les écritures dans cette base de données, car en appliquant la promotion du job de migration, la base de données Cloud SQL Enterprise Plus devient votre base de données principale.

4. Vérifiez que le délai de réplication est minimal.

5. Cliquez sur le job de migration que vous souhaitez promouvoir. L'état de ce job est Running.

6. Pour promouvoir le job de migration, cliquez sur Promouvoir.

7. Dans la boîte de dialogue qui s'affiche, cliquez sur Promouvoir.

8. Vérifiez que le job de migration est à l'état Promote in progress. Après quelques minutes, vérifiez que l'état passe à Completed.

Votre nouvelle instance de base de données Cloud SQL Enterprise Plus est prête à l'emploi.

Effectuer un nettoyage

Pour éviter que les ressources utilisées soient facturées sur votre compte Google Cloud, utilisez la console Google Cloud pour supprimer votre job de migration, votre profil de connexion, votre instance Cloud SQL Enterprise Edition et votre projet si vous n'en avez pas besoin.

Étapes suivantes

• Découvrez les principales fonctionnalités de Cloud SQL Enterprise Plus.
• Découvrez les améliorations des performances dans Cloud SQL Enterprise Plus.
• Apprenez-en plus sur la compatibilité des régions pour Cloud SQL Enterprise Plus.
• Découvrez la tarification de Cloud SQL Enterprise Plus