Tutoriel : Migration hors ligne à partir d’Amazon RDS pour PostgreSQL vers Azure Database pour PostgreSQL à l’aide du service de migration

Le Portail Azure offre une expérience simple et intuitive basée sur un Assistant qui vous guide tout au long de la migration. En suivant les étapes décrites dans ce tutoriel, vous pouvez transférer en toute transparence votre base de données vers un serveur flexible Azure Database pour PostgreSQL et tirer parti de sa scalabilité et de ses puissantes fonctionnalités.

Pour migrer avec le Portail Azure, vous configurez d’abord la tâche de migration, vous connectez à la source et à la cible, puis effectuez la migration.

Configurer la tâche de migration

Le service de migration inclut une expérience simple basée sur un Assistant sur le Portail Azure.

1. Ouvrez votre navigateur web et accédez au portail. Entrez vos informations d’identification pour vous connecter. Il s’ouvre par défaut sur le tableau de bord des services.

2. Accédez à votre serveur flexible Azure Database pour PostgreSQL.

3. Dans le menu de gauche de l’onglet Vue d’ensemble du serveur flexible, faites défiler vers le bas jusqu’à Migration et sélectionnez cette option.

   

4. Sélectionnez le bouton Créer pour effectuer une migration à partir d’Amazon RDS pour PostgreSQL vers un serveur flexible.

   Remarque

   La première fois que vous utilisez le service de migration, une grille vide s’affiche avec une invite pour commencer votre première migration.

   Si des migrations vers le serveur flexible cible ont déjà été créées, la grille contient des informations sur les tentatives de migration.

5. Sélectionnez le bouton Créer pour parcourir une série d’onglets de type Assistant pour effectuer une migration.

   

Programme d’installation

L’utilisateur doit fournir plusieurs informations liées à la migration, comme le nom de la migration, le type de serveur source, l’option et le mode.

• Le nom de la migration est l’identificateur unique de chaque migration vers cette cible de serveur flexible. Ce champ accepte uniquement les caractères alphanumériques et n’accepte aucun caractère spécial à l’exception du trait d’union (-). Le nom ne peut pas commencer par un trait d’union et doit être unique pour un serveur cible. Deux migrations vers la même cible de serveur flexible ne peuvent pas avoir le même nom.

• Type de serveur source : en fonction de votre source PostgreSQL, vous pouvez sélectionner Amazon RDS pour PostgreSQL.

• Option de migration : vous permet d’effectuer des validations avant de déclencher une migration. Vous pouvez choisir l’une des options suivantes :

  • Valider : vérifie la préparation de votre serveur et de votre base de données pour la migration vers la cible.
  • Migrer : ignore les validations et démarre les migrations.
  • Valider et migrer : effectue la validation avant de déclencher une migration. En l’absence d’échecs de validation, la migration est déclenchée.

Il est toujours recommandé de choisir l’option Valider ou Valider et migrer pour effectuer des validations de prémigration avant d’exécuter la migration.

Pour en savoir plus sur les validations de prémigration, consultez la section Prémigration.

• Mode de migration vous permet de choisir le mode de la migration. Hors connexion est l’option par défaut.

Sélectionnez le bouton Suivant : Se connecter à la source.

Sélectionner un serveur d’exécution

Le serveur d’exécution de migration est une fonctionnalité spécialisée intégrée au service de migration, conçu pour agir en tant que serveur intermédiaire pendant la migration. Il s’agit d’une instance de serveur flexible Azure Database pour PostgreSQL distincte qui n’est pas le serveur cible, mais qui est utilisée pour faciliter la migration des bases de données à partir d’un environnement source accessible uniquement via un réseau privé.

Pour plus d’informations sur le serveur d’exécution, consultez Serveur d’exécution de migration.

Se connecter à la source

L’onglet Se connecter à la source vous invite à fournir des informations relatives à la source sélectionnée dans l’onglet Installation, qui est la source des bases de données.

• Nom du serveur : indiquez le nom d’hôte ou l’adresse IP de l’instance PostgreSQL source
• Port : numéro de port du serveur source
• Nom de connexion de l’administrateur du serveur : nom d’utilisateur du serveur PostgreSQL source
• Mot de passe : mot de passe du serveur PostgreSQL source
• Mode SSL : les valeurs prises en charge sont préférées et requises. Lorsque le protocole SSL sur le serveur PostgreSQL source est DÉSACTIVÉ, utilisez SSLMODE=prefer. Si le protocole SSL sur le serveur source est ACTIVÉ, utilisez SSLMODE=require. Les valeurs SSL peuvent être déterminées dans le fichier postgresql.conf.
• Tester la connexion : effectue le test de connectivité entre la cible et la source. Une fois la connexion établie, les utilisateurs peuvent passer à l’étape suivante ; ils doivent identifier les problèmes réseau entre la cible et la source, et vérifier le nom d’utilisateur et le mot de passe de la source. L’établissement d’une connexion de test prend quelques minutes.

Une fois le test de connexion réussi, sélectionnez le bouton Suivant : Sélectionner une cible de migration.

Sélectionner la cible de migration

L’onglet Sélectionner une cible de migration affiche les métadonnées du serveur flexible cible comme le nom de l’abonnement, le groupe de ressources, le nom du serveur, l’emplacement et la version PostgreSQL.

• Nom d’utilisateur administrateur : nom d’utilisateur administrateur du serveur PostgreSQL cible
• Mot de passe : mot de passe du serveur PostgreSQL cible
• FQDN/IP personnalisé (facultatif) : le champ FQDN/IP personnalisé est facultatif. Il peut être utilisé quand la cible se trouve derrière un serveur DNS personnalisé, ou dispose d’espaces de noms DNS personnalisés, ce qui le rend accessible uniquement via des FQDN ou des adresses IP spécifiques. Par exemple, cela peut inclure des entrées telles que flexibleserver.example.com, 198.1.0.2 ou un FQDN PostgreSQL tel que flexibleserver.postgres.database.azure.com, si le serveur DNS personnalisé contient la zone DNS postgres.database.azure.com, ou transfère les requêtes de cette zone vers 168.63.129.16, où le FQDN est résolu dans la zone DNS publique ou privée Azure.
• Tester la connexion : effectue le test de connectivité entre la cible et la source. Une fois la connexion établie, les utilisateurs peuvent passer à l’étape suivante. Autrement, nous devons identifier les problèmes réseau entre la cible et la source, et vérifier le nom d’utilisateur et le mot de passe de la cible. Il faut quelques minutes pour que le test de connexion établisse une connexion la cible et la source.

Une fois le test de connexion réussi, sélectionnez le bouton Suivant : Sélectionner la ou les bases de données à migrer.

Sélectionner une base de données pour la migration

Sous l’onglet Sélectionner une base de données à migrer, vous pouvez choisir une liste de bases de données utilisateur à migrer à partir de votre serveur PostgreSQL source.
Après avoir sélectionné les bases de données, sélectionnez Suivant : Résumé

Résumé

L’onglet Résumé récapitule toutes les informations de la source et de la cible pour la création de la validation ou de la migration. Passez en revue les informations et sélectionnez le bouton Démarrer la validation et la migration.

Surveiller la migration

Une notification s’affiche quelques secondes après avoir sélectionné le bouton Démarrer la validation et la migration pour indiquer que la validation ou la migration a été créée. Vous êtes redirigé vers l’instance de la page Migration de serveur flexible. L’entrée se trouve dans l’état InProgress et le sous-état PerformingPreRequisiteSteps. Il faut 2 à 3 minutes que le flux de travail configure l’infrastructure de migration et vérifie les connexions réseau.

La grille qui affiche les migrations comporte les colonnes suivantes : Nom, État, Mode de migration, Type de migration, Serveur source, Type de serveur source, Bases de données, **Durée et Heure de début. Les entrées sont affichées dans l’ordre décroissant de l’heure de début avec l’entrée la plus récente en haut. Vous pouvez utiliser le bouton d’actualisation pour actualiser l’état de l’exécution de la validation ou de la migration.

Détails de la migration

Sélectionnez le nom de la migration dans la grille pour afficher les informations associées.

Dans l’onglet Installation, nous avons défini l’option de migration sur Validation et Migration. Dans ce scénario, les validations sont effectuées en premier avant le début de la migration. Une fois que le sous-état PerformingPreRequisiteSteps est terminé, le flux de travail passe au sous-état de Validation en cours.

• Si la validation présente des erreurs, la migration passe à l’état Échec.

• Si la validation est terminée sans erreur, la migration démarre et le flux de travail passe au sous-état Migration des données.

Les détails de validation sont disponibles au niveau de l’instance et de la base de données.

• Validation au niveau de l’instance

  • Contient la validation liée à la vérification de la connectivité, la version de la source, autrement dit, PostgreSQL version >= 9.5, la vérification des paramètres du serveur, autrement dit, si les extensions sont activées dans les paramètres serveur d’Azure Database pour PostgreSQL – Serveur flexible.

• Validation au niveau de la base de données

  • Contient la validation des bases de données individuelles liées à la prise en charge des extensions et des classements dans Azure Database pour PostgreSQL – Serveur flexible.

Vous pouvez voir l’état de la validation et de la migration dans la page Détails de la migration.

Les états de migration possibles incluent :

États de migration

Sous-états de la migration

Sous-états de validation

Annuler la migration

Vous pouvez annuler toutes les validations ou migrations en cours. Le workflow doit être dans l’état InProgress pour être annulé. Vous ne pouvez pas annuler une validation ou une migration qui se trouve dans l’état Réussi ou Échec.

• L’annulation d’une migration arrête l’activité de migration supplémentaire sur votre serveur cible et passe à l’état Annulé. L’action d’annulation restaure toutes les modifications apportées par le service de migration sur votre serveur cible.

Cet article explique comment utiliser Azure CLI pour migrer votre base de données PostgreSQL d’Amazon RDS pour PostgreSQL vers Azure Database pour PostgreSQL. Azure CLI fournit une interface de ligne de commande puissante et flexible qui vous permet d’effectuer différentes tâches, notamment la migration de base de données. En suivant les étapes décrites dans cet article, vous pouvez transférer en toute transparence votre base de données vers Azure et tirer parti de sa scalabilité et de ses puissantes fonctionnalités.

Pour en savoir plus sur Azure CLI avec le service de migration, consultez Guide pratique pour configurer Azure CLI pour le service de migration.

Une fois l’interface CLI installée, ouvrez l’invite de commandes et connectez-vous à votre compte Azure à l’aide de la commande ci-dessous.

az login

Configurer la tâche de migration

Pour commencer la migration, vous devez créer un fichier JSON avec les détails de la migration. Le fichier JSON contient les informations suivantes :

• Modifiez les espaces réservés << >> ci-dessous dans les lignes JSON et stockez-les sur l’ordinateur local en tant que <<filename>>.json où l’interface CLI est appelée. Dans ce didacticiel, nous avons enregistré le fichier dans C:\migration-CLI\migration_body.json

{
"properties": {
"SourceDBServerResourceId": "<<source hostname or IP address>>:<<port>>@<<username>>",
        "SecretParameters": {
            "AdminCredentials": {
                "SourceServerPassword": "<<Source Password>>",
                "TargetServerPassword": "<<Target Password>>"
            },
			"targetServerUserName": "<<Target username>>"
        },
        "DBsToMigrate": "<<comma separated list of databases in a array like - ["ticketdb","timedb","inventorydb"]>>",
        "OverwriteDBsInTarget": "true",
        "sourceType": "AWS_RDS",
        "sslMode": "Require"
    }
}

• Exécutez la commande suivante pour vérifier si des migrations sont en cours d’exécution. Le nom de la migration est unique dans les migrations au sein du serveur flexible Azure Database pour PostgreSQL cible.

  az postgres flexible-server migration list --subscription 11111111-1111-1111-1111-111111111111 --resource-group my-learning-rg --name myflexibleserver --filter All
  

• Dans les étapes ci-dessus, aucune migration n’est effectuée. Nous commençons par la nouvelle migration en exécutant la commande suivante.

  az postgres flexible-server migration create --subscription 11111111-1111-1111-1111-111111111111 --resource-group my-learning-rg --name myflexibleserver --migration-name migration1 --migration-mode offline --migration-option ValidateAndMigrate --properties "C:\migration-cli\migration_body.json"
  

• Exécutez la commande suivante pour lancer l’état de la migration à l’étape précédente. Vous pouvez vérifier l’état de la migration en fournissant le nom de la migration.

  az postgres flexible-server migration show --subscription 11111111-1111-1111-1111-111111111111 --resource-group my-learning-rg --name myflexibleserver --migration-name migration1
  

• L’état de la progression de la migration s’affiche dans Azure CLI.

• Vous pouvez également voir l’état du serveur flexible Azure Database pour PostgreSQL sur le Portail Azure.

• Vous pouvez annuler toutes les tentatives de migration en cours à l’aide de la commande cancel. Cette commande arrête la tentative de migration spécifique et restaure toutes les modifications sur votre serveur cible. Voici la commande CLI pour supprimer une migration :

  az postgres flexible-server migration update cancel --subscription 11111111-1111-1111-1111-111111111111 --resource-group my-learning-rg --name myflexibleserver --migration-name migration1