Préversion de l’extension de migration (évaluation) Azure PostgreSQL

  • Article

L’extension de migration Azure PostgreSQL pour Azure Data Studio vous permet d’évaluer et d’obtenir des recommandations Azure appropriées.

Les avantages clés de l’utilisation de l’extension de migration Azure PostgreSQL pour Azure Data Studio sont les suivants :

  • Interface utilisateur réactive qui vous offre une expérience de migration de bout en bout commençant par une évaluation de préparation de la migration, une recommandation de référence SKU (basée sur des données de performances).
  • Mécanisme d’évaluation amélioré capable d’évaluer les instances PostgreSQL, en identifiant les bases de données prêtes à être migrées vers les cibles Azure Database pour PostgreSQL - Serveur flexible.
  • Moteur de recommandation de référence SKU qui collecte des données de performances sur l’instance PostgreSQL source et génère des recommandations de référence SKU appropriées en fonction de votre cible Azure Database pour PostgreSQL - Serveur flexible.

L’extension de migration Azure PostgreSQL dans Azure Data Studio vous aide à évaluer votre charge de travail PostgreSQL pour la migration vers Azure Database pour PostgreSQL - Serveur flexible. L’extension identifie une cible PostgreSQL appropriée, et fournit des recommandations de dimensionnement pour les migrations.

Prérequis

  • Azure Data Studio (1.40 et versions ultérieures)
  • Instance de serveur PostgreSQL exécutant la version 9.3 ou ultérieure
  • Les utilisateurs PostgreSQL doivent disposer des privilèges CONNECT et SELECT sur les bases de données de l’instance

Installer l’extension Azure Data Studio

Suivez ces étapes pour installer l’extension Azure PostgreSQL migration dans Azure Data Studio.

  1. Ouvrez le gestionnaire d’extensions dans Azure Data Studio. Sélectionnez l’icône d’extension ou Extensions dans le menu View.

  2. Tapez Postgresql migration dans la barre de recherche.

  3. Sélectionnez l’extension Azure PostgreSQL migration, puis examinez ses détails.

  4. Sélectionnez Installer.

    1. Une fois installée, l’extension PostgreSQL est également installée.
    2. Une fois installée, .NET 6 est également installé.

Screenshot to show a search of the extension.

Se connecter à une instance PostgreSQL

Une fois l’extension d’évaluation installée, l’étape suivante consiste à se connecter à votre instance de serveur PostgreSQL, à collecter des informations de métadonnées à partir de l’instance de serveur PostgreSQL, puis à générer un rapport d’évaluation.

  1. Accédez à l’icône Connexions dans la barre de menus.

    Screenshot of the new connection menu bar.

  2. Renseignez les champs dans Connection Details.

    1. Dans le champ Connection type, sélectionnez PostgreSQL.
    2. Dans le champ Server name, tapez le nom de votre serveur PostgreSQL.
    3. Comme Authentication type, sélectionnez Password.
    4. Dans le champ User name, indiquez le nom d’utilisateur de la base de données.
    5. Dans le champ Password, indiquez le mot de passe de la base de données.
    6. Sélectionnez Advanced.
      1. Sous la section Serveur, indiquez le numéro de port.
      2. Sélectionnez ensuite OK.

    Screenshot of the connection details.

  3. Sélectionnez Connecter.

  4. À présent, une nouvelle connexion apparaît dans le menu Détails de la connexion.

  5. Cliquez avec le bouton droit sur la connexion PostgreSQL, puis sélectionnez Manage.

    Screenshot showing the Manage database screen.

Exécuter l’évaluation

Une fois connecté à votre instance PostgreSQL dans Azure Data Studio, vous pouvez commencer à exécuter l’évaluation.

Dans la section Général, sélectionnez Azure PostgreSQL Migration, puis Run new assessment.

Screenshot showing the Migration Assessment database screen.

L’évaluation comporte trois étapes.

  • Database(s) for assessment
  • Assessment Parameters
  • View Assessment Results

1. Database(s) for assessment

Sélectionnez la ou les bases de données que vous souhaitez évaluer pour la migration pour Azure Database pour PostgreSQL - Serveur flexible, puis sélectionnez Next.

Screenshot of view databases.

2. Assessment Parameters

Dans les paramètres d’évaluation, les utilisateurs peuvent choisir la version cible du serveur flexible Azure Database pour PostgreSQL pour évaluer l’instance PostgreSQL source avec la version cible sélectionnée du serveur flexible Azure Database pour PostgreSQL. La version cible que l’utilisateur peut sélectionner sera toujours supérieure ou égale à la version de PostgreSQL source. Par exemple, si la version de l’instance PostgreSQL source est 13, la version cible affichée est 13, 14 et 15.

La fonctionnalité de recommandation de référence SKU vous permet de collecter des données de performances à partir de vos instances PostgreSQL sources hébergeant vos bases de données, et recommande la référence SKU Azure Database pour PostgreSQL - Serveur flexible de dimension appropriée en fonction des données collectées. La fonctionnalité fournit des recommandations en matière de niveau de calcul et de taille des données.

Choisissez la façon dont vous souhaitez fournir des recommandations de référence SKU pour le public cible. Cette étape nécessite des données de performances d’une instance de serveur PostgreSQL.

Il existe deux options pour collecter des données de performances afin de recevoir la recommandation cible pour les bases de données que vous souhaitez migrer.

  • Collecter automatiquement les données de performances
  • Entrer des paramètres de données de performances

Collecter automatiquement les données de performances

Notes

Avant de sélectionner vos bases de données, vous devez exécuter des privilèges pour la collecte automatique pour la recommandation de référence SKU.

L’utilisateur doit exécuter les privilèges sur pg_read_file() function.

GRANT EXECUTE ON FUNCTION pg_read_file(text) TO <<username>>;

L’utilisateur doit recevoir le role pg_read_server_files.

GRANT pg_read_server_files TO <<username>>;

Si votre environnement prend en charge la collecte automatique des données de performances, il s’agit de l’option par défaut.

Sélectionnez la collecte automatique des données de performances pour recevoir les recommandations cibles pour les bases de données que vous souhaitez migrer.

Renseignez les champs dans les paramètres de recommandation de référence SKU comme suit.

  • Time duration : entrez la durée pendant laquelle vous souhaitez exécuter la collecte de données.

    Notes

    Il est recommandé de collecter les données d’évaluation pendant les heures de charge de travail maximale. La collecte de données doit s’exécuter pendant 24 heures, car cela offre le temps nécessaire pour collecter des données avec une plus grande confiance. L’Assistant Évaluation doit être ouvert pendant la collecte des données.

  • Scale factor : entrez les valeurs 0.2-2, pour développer pendant les périodes de performances maximales.

    Notes

    Le facteur d’échelle pendant l’évaluation est une mémoire tampon appliquée en plus des données d’utilisation actuelle pour PostgreSQL (vCores, mémoire et stockage). Le facteur d’échelle prend en compte l’utilisation saisonnière, l’historique des performances de courte durée et l’augmentation de l’utilisation future.

  • Percentile utilization : valeur en centiles de l’exemple de performance devant être prise en compte pour le dimensionnement de la cible Azure.

Une fois que vous avez fourni vos valeurs, sélectionnez Assess.

Screenshot of automatically collecting data.

Entrer des paramètres de données de performances

En fonction de votre environnement, vous devrez peut-être fournir les données manuellement pour effectuer l’évaluation. Dans ce cas, vous pouvez utiliser l’option Enter Performance Data Parameter afin d’entrer les valeurs nécessaires pour fournir une évaluation manuellement.

Renseignez les champs dans les paramètres de performances comme suit.

  • vCores : nombre de cœurs logiques disponibles sur le serveur.
  • Memory (GB) : mémoire totale disponible sur le serveur.
  • Storage (GB) : stockage total utilisé par l’instance du serveur PostgreSQL.
  • IOPS : opérations d’entrée/sortie par seconde par l’instance du serveur PostgreSQL.

Renseignez les champs dans les paramètres de recommandation comme suit.

  • Scale factor : entrez les valeurs 0.2-2, pour développer pendant les périodes de performances maximales.

    Notes

    Le facteur d’échelle pendant l’évaluation est une mémoire tampon appliquée en plus des données d’utilisation actuelle pour PostgreSQL (vCores, mémoire et stockage). Le facteur d’échelle prend en compte l’utilisation saisonnière, l’historique des performances de courte durée et l’augmentation de l’utilisation future.

Une fois que vous avez renseigné vos paramètres, sélectionnez Assess.

Screenshot of entering performance data.

Pour plus d’informations sur les recommandations en matière de référence SKU, consultez Recommandations de référence SKU.

3. View Assessment Results

Une fois l’évaluation terminée, une sortie consolidée est générée.

  • Les cartes en haut représentent la référence SKU recommandée dans Azure.
    • Target Platform : actuellement, l’évaluation est effectuée et prise en charge sur Azure Database pour PostgreSQL - Serveur flexible.
    • Recommended Configuration : en fonction des métriques de performances, une référence SKU disponible dans Azure Database pour PostgreSQL - Serveur flexible est recommandée. Pour plus d’informations sur les recommandations en matière de référence SKU, consultez Recommandations de référence SKU.
    • Data collection status : indique le nombre de cycles terminés et l’état de la collecte de données.

      • Il existe quatre états : In Progress, Completed, Stopped, Not Applicable (uniquement pour la collecte de données avec entrée des paramètres de données de performances).

        Notes

        Dans la carte Data collection status, un utilisateur peut démarrer ou arrêter la collecte à tout moment.

Screenshot of configuration cards.

Les utilisateurs peuvent sélectionner le nom de l’instance qui indique la synthèse et la préparation à la migration de l’instance PostgreSQL. Les utilisateurs peuvent parcourir différents paramètres et fonctionnalités de serveur, comprendre l’utilisation du paramètre, et se familiariser avec la recommandation pour résoudre les avertissements.

Les utilisateurs peuvent sélectionner la valeur en regard de Migration Readiness state pour déterminer le statut de chaque base de données.

Les utilisateurs peuvent sélectionner les bases de données respectives, se familiariser avec les bloqueurs et les avertissements, et parcourir la synthèse Migration Readiness si la base de données est à l’état Not Ready, Ready with conditions ou Ready pour la migration vers Azure.

Les utilisateurs peuvent enregistrer le rapport d’évaluation sur leur ordinateur pour l’afficher hors connexion en sélectionnant l’action Save Assessment.

Screenshot to show how to save the assessment.

État de préparation à la migration

  • Not Ready : l’instance PostgreSQL (bases de données) ne peut pas être migrée vers Azure. Par exemple, si le disque d’un serveur local stocke plus de 64 To, Azure ne peut pas l’héberger. Suivez les instructions de correction afin de résoudre le problème avant la migration.
  • Ready with Conditions : l’instance PostgreSQL (bases de données) peut être migrée vers Azure en suivant les recommandations fournies dans ADS. Par exemple, Azure PostgreSQL - Serveur flexible ne prend pas en charge l’exécution d’instances locales par la dernière version de classement. Vous devez faire preuve de vigilance avant de migrer ces instances vers Azure. Pour résoudre les problèmes relatifs à l’état de préparation, suivez les instructions de correction. Dans cet exemple, l’utilisateur doit reconstruire l’index.
  • Ready : l’instance PostgreSQL (bases de données) peut être migrée vers Azure sans aucune modification.

Recommandations de référence SKU

La fonctionnalité de recommandation de référence SKU vous permet de collecter des données de performances à partir de vos instances PostgreSQL sources hébergeant vos bases de données, et recommande la référence SKU Azure Database pour PostgreSQL - Serveur flexible de dimension appropriée en fonction des données collectées. La fonctionnalité fournit des recommandations en matière de niveau de calcul et de taille des données.

La recommandation de référence SKU évalue différentes métriques de performances, telles que vCores, mémoire, IOPS et stockage. En fonction de l’utilisation et des données de configuration, le générateur de recommandations fournit la cible qui convient et le niveau de service approprié.

Examiner le niveau de confiance

La configuration recommandée fournit un score de confiance basé sur la collecte de données et sur une durée d’exécution de 24 heures. Ce niveau est exprimé en étoiles, 1 étoile étant le plus bas niveau et 5 étoiles le plus haut.

Le score de confiance vous permet d’estimer la fiabilité des suggestions de dimensionnement fournies par l’évaluation.

Les scores de confiance sont les suivants pour une durée d’exécution de collecte de données de 24 heures.

Disponibilité des points de données Durée d’exécution approximative Niveau de confiance
1 %-20 % 10 minutes - 5 heures 1 étoile
21 %-40 % > 5 heures - 10 heures 2 étoiles
41 %-60 % > 10 heures - 14 heures 3 étoiles
61 %-80 % > 14 heures - 19 heures 4 étoiles
81 %-100 % > 19 heures - 24 heures 5 étoiles

Une fois le processus de collecte de données terminé, vous pouvez sélectionner l’option View Details dans la carte Recommended Details en haut pour afficher l’écran Recommended Details. Vous pouvez voir la raison de la recommandation et les propriétés sources.

Les raisons de la recommandation indiquent les exigences en matière de processeur, de mémoire, de stockage et d’IOPS, en les comparant à la cible Azure Database pour PostgreSQL - Serveur flexible.

Les propriétés sources indiquent les paramètres de performances utilisés et réels. Les informations Used expliquent l’utilisation par l’instance PostgreSQL source. Les informations Actual expliquent l’utilisation totale qui peut être utilisée par l’instance PostgreSQL source.

Screenshot of View details screen.

Changer le chemin d’évaluation

Si vous souhaitez enregistrer vos données d’évaluation et de performances à un autre emplacement, vous pouvez modifier le chemin d’évaluation sous les paramètres de l’extension.

  1. Accédez à la Place de marché des extensions et recherchez Azure PostgreSQL migration.
  2. Sélectionnez l’icône Manage, puis les paramètres des extensions.
  3. Spécifiez le nouveau chemin de l’évaluation sous PostgreSQL Assessment: Assessment Path.

Screenshot of extension settings.

Résoudre les problèmes

Pour résoudre un problème lié à l’extension Azure PostgreSQL migration, vous devez trouver les détails de l’erreur et les avertissements associés dans les journaux générés.

Journaux d’activité

L’extension stocke les erreurs, les avertissements et d’autres journaux de diagnostic dans le répertoire des journaux par défaut :

  • Windows - C:\Users\<username>\.postgresmigration\logs\
  • Linux – ~/.postgresmigration/logs
  • macOS – /Users/<username>/.postgresmigration/logs

Notes

Par défaut, l’extension stocke les sept derniers fichiers journaux.

Pour plus d’informations sur la résolution des problèmes, consultez Résoudre les erreurs dans l’extension Azure PostgreSQL migration.

Problèmes connus et limitations

  • La collecte automatique pour la recommandation de référence SKU n’est pas prise en charge pour les services PaaS PostgreSQL.
  • Les collectes automatiques s’appliquent uniquement à Linux.
  • Les collectes automatiques s’appliquent uniquement à PostgreSQL version 11 et ultérieures.

Obtenir de l’aide du support Microsoft

Vous pouvez déclencher une demande de support pour obtenir l’aide du support Microsoft si vous rencontrez des problèmes ou des erreurs dans le cadre de la migration de vos bases de données à l’aide de l’extension de migration PostgreSQL.

Sélectionnez le bouton Nouvelle demande de support dans la section supérieure de l’extension. Vous serez redirigé automatiquement vers le portail Azure, où vous pourrez renseigner les détails et envoyer une demande de support.

Vous pouvez soumettre des idées/suggestions d’amélioration et d’autres commentaires, y compris des bogues dans le forum de la communauté Azure—Azure Database Migration Service.

Notes

Vous pouvez également utiliser le bouton Commentaires ou envoyer un e-mail au groupe de produit si vous avez des suggestions ou des commentaires pour améliorer l’extension.

Étapes suivantes