Partager via

Configurer les paramètres de serveur dans Azure Database pour PostgreSQL – Serveur flexible

  • Article

S’APPLIQUE À : Azure Database pour PostgreSQL : serveur flexible

Vous pouvez lister, afficher et mettre à jour les paramètres de configuration d’une instance de serveur flexible Azure Database pour PostgreSQL.

Personnalisation des paramètres

Différentes méthodes et niveaux sont disponibles pour personnaliser vos paramètres en fonction de vos besoins spécifiques.

Niveau global

Pour afficher les valeurs configurées en cours des paramètres de serveur ou les modifier globalement au niveau de l’instance ou du serveur, vous pouvez utiliser la page Paramètres de serveur du portail Azure. Vous pouvez également interagir avec les paramètres de serveur globalement à l’aide de la CLI, de l’API REST, des modèles Azure Resource Manager ou d’outils IaC tiers.

Remarque

Étant donné qu’Azure Database pour PostgreSQL est un service de base de données managé, les utilisateurs n’ont pas accès à l’hôte ni au système d’exploitation pour afficher ou modifier des fichiers de configuration tels que postgresql.conf. Le contenu des fichiers est automatiquement mis à jour en fonction des modifications apportées aux paramètres que vous apportez.

Dans ce même article, vous trouverez des sections permettant d’interagir avec les paramètres de serveur globalement pour :

Niveaux granulaires

Vous pouvez ajuster les paramètres à des niveaux plus granulaires. Ces ajustements remplacent les valeurs définies globalement. Leur étendue et leur durée dépendent du niveau auquel vous les faites :

  • Niveau de la base de données : utilisez la commande ALTER DATABASE pour les configurations spécifiques à la base de données.

  • Rôle ou niveau utilisateur : utilisez la commande ALTER USER pour les paramètres centrés sur l’utilisateur.

  • Fonction, niveau de procédure : lorsque vous définissez une fonction ou une procédure, vous pouvez spécifier ou modifier les paramètres de configuration utilisés lors de l’appel de la fonction.

  • Niveau de la table : par exemple, vous pouvez modifier les paramètres liés à l’autovacuum à ce niveau.

  • Niveau de session : pendant la durée d’une session de base de données individuelle, vous pouvez ajuster des paramètres spécifiques. PostgreSQL facilite cet ajustement avec les commandes SQL suivantes :

    • Utilisez la commande SET pour effectuer des ajustements spécifiques à la session. Ces modifications constituent les paramètres par défaut pour la session en cours. L’accès à ces modifications peut nécessiter des privilèges SET spécifiques, et les limitations pour les paramètres modifiables et en lecture seule décrits précédemment ne s’appliquent pas. La fonction SQL correspondante est set_config(setting_name, new_value, is_local).
    • Utilisez la commande SHOW pour examiner les paramètres existants. Son équivalent de fonction SQL est current_setting(setting_name text).

Lister tous les paramètres de serveur

À l’aide du Portail Azure :

  1. Sélectionnez votre instance de serveur flexible Azure Database pour PostgreSQL.

  2. Dans le menu des ressources, sous la section Paramètres, sélectionnez Paramètres de serveur. La page affiche une liste de paramètres, leurs valeurs configurées, les unités facultatives, s’ils sont en lecture seule/dynamique/statique et leurs descriptions.

    Capture d’écran de la page Paramètres de serveur.

  3. Sélectionnez ou pointez sur l’icône i (informations) pour consulter les valeurs autorisées auxquelles chaque paramètre peut être défini. Selon le type de données du paramètre, qui peut être chaîne, énumération, entier, booléen, numérique, défini, les valeurs autorisées varient. Il peut s’agir d’une expression régulière, d’une liste de valeurs, d’une plage d’entiers, d’activé/désactivé, d’une plage de décimales, d’une liste de valeurs, respectivement.

    Capture d’écran montrant une bulle qui s’affiche lorsque vous pointez sur l’icône d’informations.

  4. La liste des paramètres de serveur pris en charge par l’instance se compose de plusieurs centaines d’éléments, qui sont affichés sur des pages de 20 éléments chacune. En bas de la page, un contrôle vous informe de la position où vous vous trouvez. Il existe également un contrôle de pagination que vous pouvez utiliser pour naviguer à travers l’ensemble des pages.

    Capture d’écran du contrôle de pagination de la page Paramètres de serveur.

  5. Si nécessaire, utilisez la zone de texte Recherche pour filtrer des éléments... pour réduire la liste aux paramètres contenant le critère de recherche dans leur nom ou leur description.

    Capture d’écran de la recherche dans les Paramètres du serveur.

La colonne Type de paramètre peut afficher l’une des valeurs suivantes pour chaque paramètre :

Type de paramètre Description
Static Nécessite un redémarrage du serveur pour que la modification devienne effective.
Dynamique Peut être modifié sans avoir à redémarrer l’instance de serveur. Toutefois, les modifications s’appliquent uniquement aux nouvelles connexions établies après la modification.
Lecture seule N’est pas configurable par l’utilisateur en raison de son rôle critique dans le maintien de la fiabilité, la sécurité ou d’autres aspects opérationnels du service.

Lister les paramètres de serveur avec les valeurs par défaut modifiées

À l’aide du Portail Azure :

  1. Sélectionnez votre instance de serveur flexible Azure Database pour PostgreSQL.

  2. Dans le menu des ressources, sous la section Paramètres, sélectionnez Paramètres de serveur, puis l’onglet Modifiés. La page affiche une liste des paramètres dont la valeur actuellement définie diffère de la valeur par défaut.

    Capture d’écran des paramètres de serveur modifiés.

Lister les paramètres de serveur statiques en lecture-écriture

À l’aide du Portail Azure :

  1. Sélectionnez votre instance de serveur flexible Azure Database pour PostgreSQL.

  2. Dans le menu des ressources, sous la section Paramètres, sélectionnez Paramètres de serveur, puis l’onglet Statique. La page affiche une liste des paramètres en lecture-écriture qui, si leur valeur est modifiée, nécessitent un redémarrage du serveur pour que la nouvelle valeur prenne effet.

    Capture d’écran des paramètres de serveur statiques.

Lister les paramètres de serveur dynamiques en lecture-écriture

À l’aide du Portail Azure :

  1. Sélectionnez votre instance de serveur flexible Azure Database pour PostgreSQL.

  2. Dans le menu des ressources, sous la section Paramètres, sélectionnez Paramètres de serveur, puis l’onglet Dynamique. La page affiche une liste des paramètres en lecture-écriture qui, si leur valeur est modifiée, nécessitent un redémarrage du serveur pour que la nouvelle valeur prenne effet.

    Capture d’écran des paramètres de serveur dynamiques.

Lister les paramètres de serveur en lecture seule

À l’aide du Portail Azure :

  1. Sélectionnez votre instance de serveur flexible Azure Database pour PostgreSQL.

  2. Dans le menu des ressources, sous la section Paramètres, sélectionnez Paramètres de serveur, puis l’onglet Lecteur seule. La page affiche une liste de paramètres en lecture seule.

    Capture d’écran des paramètres de serveur en lecture seule.

Définir la valeur d’un ou plusieurs paramètres de serveur

À l’aide du Portail Azure :

  1. Sélectionnez votre instance de serveur flexible Azure Database pour PostgreSQL.

  2. Dans le menu des ressources, sous la section Paramètres, sélectionnez Paramètres de serveur.

  3. Recherchez les paramètres en lecture-écriture dont vous souhaitez modifier les valeurs en cours, définissez-les sur les nouvelles valeurs souhaitées, notez qu’un message d’information indique le nombre de modifications des paramètres de serveur qui ne sont pas encore enregistrées, puis sélectionnez Enregistrer.

    Capture d’écran de la définition de la valeur d’un paramètre de serveur.

  4. Si la colonne Type de paramètre d’un des paramètres modifiés est égale à Statique, le serveur nécessite un redémarrage pour que les modifications prennent effet. Dans ce cas, une boîte de dialogue s’affiche pour vous permettre de sélectionner l’action que vous souhaitez effectuer :

    • Enregistrer et redémarrer : si vous souhaitez conserver toutes les modifications apportées à tous les paramètres dont les valeurs ont été modifiées, et immédiatement après, redémarrer le serveur pour que les modifications apportées aux paramètres statiques prennent effet.
    • Enregistrer uniquement : si vous souhaitez conserver toutes les modifications apportées à tous les paramètres dont les valeurs définies ont été modifiées, mais que vous souhaitez différer le redémarrage du serveur à un moment ultérieur. Tant que vous n’avez pas terminé l’action de redémarrage du serveur, les modifications apportées aux paramètres de serveur statiques ne prennent pas effet.
    • Annuler : pour ne pas encore implémenter les modifications.

    Capture d’écran de la boîte de dialogue demandant un redémarrage du serveur après avoir modifié un paramètre statique.

Rétablir un paramètre de serveur à sa valeur par défaut

À l’aide du Portail Azure :

  1. Sélectionnez votre instance de serveur flexible Azure Database pour PostgreSQL.

  2. Dans le menu des ressources, sous la section Paramètres, sélectionnez Paramètres de serveur.

  3. Recherchez le paramètre en lecture-écriture dont vous souhaitez rétablir la valeur en cours à sa valeur par défaut, sélectionnez les points de suspension à l’extrémité droite de l’écran, puis Réinitialiser à la valeur par défaut.

    Capture d’écran de la réinitialisation de la valeur d’un paramètre de serveur à sa valeur par défaut.

Important

Pour les paramètres désignés en lecture seule, la sélection des points de suspension ne s’affiche pas dans l’option de menu Réinitialiser à la valeur par défaut.

  1. Si la colonne Type de paramètre du paramètre que vous tentez de réinitialiser à sa valeur par défaut est égale à Statique, le serveur nécessite un redémarrage pour que la modification prenne effet. Dans ce cas, une boîte de dialogue s’affiche pour vous permettre de sélectionner l’action que vous souhaitez effectuer :

    • Enregistrer et redémarrer : si vous souhaitez conserver toutes les modifications apportées à tous les paramètres dont les valeurs ont été modifiées, et immédiatement après, redémarrer le serveur pour que les modifications apportées aux paramètres statiques prennent effet.
    • Enregistrer uniquement : si vous souhaitez conserver toutes les modifications apportées à tous les paramètres dont les valeurs définies ont été modifiées, mais que vous souhaitez différer le redémarrage du serveur à un moment ultérieur. Tant que vous n’avez pas terminé l’action de redémarrage du serveur, les modifications apportées aux paramètres de serveur statiques ne prennent pas effet.
    • Annuler : pour ne pas encore implémenter les modifications.

    Capture d’écran de la boîte de dialogue demandant un redémarrage du serveur après la modification de la valeur d’un paramètre statique.

Rétablir tous les paramètres de serveur à leurs valeurs par défaut

À l’aide du Portail Azure :

  1. Sélectionnez votre instance de serveur flexible Azure Database pour PostgreSQL.

  2. Dans le menu des ressources, sous la section Paramètres, sélectionnez Paramètres de serveur.

  3. Sélectionner Rétablir tous les paramètres à leurs valeurs par défaut.

    Capture d’écran de la réinitialisation de la valeur de tous les paramètres de serveur à leurs valeurs par défaut.

  4. Si, pour l’un des paramètres dont la valeur en cours ne correspond pas à sa valeur par défaut, la colonne Type de paramètre est égale à Statique, le serveur nécessite un redémarrage pour que la modification prenne effet. Dans ce cas, une boîte de dialogue s’affiche pour vous permettre de sélectionner l’action que vous souhaitez effectuer :

    • Enregistrer et redémarrer : si vous souhaitez conserver toutes les modifications apportées à tous les paramètres dont les valeurs ont été modifiées, et immédiatement après, redémarrer le serveur pour que les modifications apportées aux paramètres statiques prennent effet.
    • Enregistrer uniquement : si vous souhaitez conserver toutes les modifications apportées à tous les paramètres dont les valeurs définies ont été modifiées, mais que vous souhaitez différer le redémarrage du serveur à un moment ultérieur. Tant que vous n’avez pas terminé l’action de redémarrage du serveur, les modifications apportées aux paramètres de serveur statiques ne prennent pas effet.
    • Annuler : pour ne pas encore implémenter les modifications.

    Capture d’écran de la boîte de dialogue demandant un redémarrage du serveur après avoir réinitialisé tous les paramètres à leurs valeurs par défaut.

Utilisation du paramètre de fuseau horaire

Si vous prévoyez de travailler avec des données de date et d’heure dans PostgreSQL, assurez-vous de définir le fuseau horaire correspondant à votre localisation. Toutes les dates et heures prenant en charge les fuseaux horaires sont stockées en interne dans PostgreSQL au format UTC. Elles sont converties en heure locale de la zone spécifiée par le paramètre de serveur TimeZone avant d’être affichées sur le client. Ce paramètre peut être modifié dans la page Paramètres de serveur. PostgreSQL vous permet de spécifier des fuseaux horaires sous trois formes différentes :

  • Un nom de fuseau horaire complet, par exemple America/New_York. Les noms de fuseau horaire reconnus sont listés dans la vue pg_timezone_names.
    Exemple pour interroger cette vue en psql et obtenir la liste des noms de fuseau horaire :

    select name FROM pg_timezone_names LIMIT 20;

    Vous devez voir un ensemble de résultats comme celui-ci :

              name
      -----------------------
      GMT0
      Iceland
      Factory
      NZ-CHAT
      America/Panama
      America/Fort_Nelson
      America/Pangnirtung
      America/Belem
      America/Coral_Harbour
      America/Guayaquil
      America/Marigot
      America/Barbados
      America/Porto_Velho
      America/Bogota
      America/Menominee
      America/Martinique
      America/Asuncion
      America/Toronto
      America/Tortola
      America/Managua
      (20 rows)

  • Une abréviation de fuseau horaire, par exemple PST. Une telle spécification définit simplement un décalage particulier par rapport à l’heure UTC, contrairement aux noms de fuseaux horaires complets qui peuvent également impliquer un ensemble de règles de passage à l’heure d’été. Les abréviations reconnues sont listées dans la vue pg_timezone_abbrevs. Pour interroger cette vue en psql et obtenir la liste des abréviations de fuseau horaire :

     select abbrev from pg_timezone_abbrevs limit 20;

    Vous devez voir un ensemble de résultats comme celui-ci :

          abbrev|
      ------+
      ACDT  |
      ACSST |
      ACST  |
      ACT   |
      ACWST |
      ADT   |
      AEDT  |
      AESST |
      AEST  |
      AFT   |
      AKDT  |
      AKST  |
      ALMST |
      ALMT  |
      AMST  |
      AMT   |
      ANAST |
      ANAT  |
      ARST  |
      ART   |

  • En plus des noms et abréviations de fuseau horaire, PostgreSQL accepte les spécifications de fuseau horaire de style POSIX sous la forme STDoffset ou STDoffsetDST, où « STD » est une abréviation de zone, « offset » un décalage numérique à l’ouest exprimé en heures par rapport au temps universel coordonné (UTC), et « DST » une abréviation facultative de zone en heure d’été, supposée représenter une heure d’avance pour le décalage donné.

Partager vos suggestions et bogues avec l’équipe produit Azure Database pour PostgreSQL.