27.10. Variables d'environnement

Les variables d'environnement suivantes peuvent être utilisées pour sélectionner des valeurs par défaut de paramètres de connexion. Elles sont utilisées par PQconnectdb, PQsetdbLogin et PQsetdb si aucune valeur n'est directement spécifiée par le code d'appel. Elles sont en particulier utiles pour éviter de coder en dur les informations de connexion à la base de données dans les applications clients.

• PGHOST initialise le nom du serveur de la base de données. S'il commence avec une barre oblique, il indique une communication de domaine Unix plutôt qu'une communication TCP/IP ; la valeur est le nom du répertoire où le fichier socket est stocké (par défaut /tmp).

• PGHOSTADDR indique l'adresse IP numérique du serveur de la base de données. Elle peut être initialisée avec PGHOST pour éviter la surcharge des recherches DNS. Voir la documentation de ces paramètres, dans PQconnectdb ci-dessus, pour des détails sur leur interaction.

• PGPORT initialise le numéro de port TCP ou l'extension du fichier socket domaine Unix pour la communication avec le serveur PostgreSQL.

• PGDATABASE initialise le nom de la base de données PostgreSQL.

• PGUSER initialise le nom de l'utilisateur se connectant à la base de données.

• PGPASSWORD initialise le mot de passe utilisé si le serveur demande une authentification par mot de passe. Cette variable d'environnement est obsolète pour des raisons de sécurité ; il est conseillé de migrer vers l'utilisation du fichier $HOME/.pgpass (voir Section 27.11).

• PGSERVICE initialise le nom du service à rechercher dans pg_service.conf. Cela offre un raccourci pour la configuration de tous les paramètres.

• PGREALM initialise le domaine Kerberos à utiliser avec PostgreSQL s'il est différent du domaine local. Si PGREALM est initialisé, les applications libpq tentent une authentification avec les serveurs avec ce domaine et utilisent des fichiers tickets séparés pour éviter les conflits avec les fichiers tickets locaux. Cette variable d'environnement n'est utilisée que si l'authentification Kerberos est sélectionnée par le serveur.

• PGOPTIONS initialise des options d'exécution supplémentaires pour le serveur PostgreSQL.

• PGSSLMODE détermine si et avec quelle priorité une connexion SSL est négociée avec le serveur. Il existe quatre modes : disable tente uniquement une connexion non cryptée, donc sans SSL ; allow négocie en commençant par une connexion non SSL puis, s'il échoue, essaie une connexion SSL ; prefer (la valeur par défaut) négociera en commençant par une connexion SSL puis, en cas d'échec, essaie une connexion non SSL ; require essaie seulement une connexion SSL. Si PostgreSQL est compilé sans le support de SSL, utiliser l'option require génère une erreur et les options allow et prefer sont tolérées mais libpq est incapable de gérer une connexion SSL.

• PGREQUIRESSL initialise une connexion via SSL. Si elle est initialisée à << 1 >>, libpq refuse de se connecter si le serveur n'accepte pas de connexion SSL (équivalent à un sslmode prefer). Cette option est obsolète. Elle est remplacée par le paramétrage sslmode et est seulement disponible si PostgreSQL est compilé avec le support de SSL.

• PGCONNECT_TIMEOUT initialise le nombre de secondes maximum que libpq attend pour une connexion au serveur PostgreSQL. Si elle n'est pas initialisée ou si elle vaut zéro, libpq attend indéfiniment. Il n'est pas recommandé d'initialiser le délai à moins de deux secondes.

Les variables d'environnement par défaut peuvent être utilisées pour spécifier le comportement par défaut de chaque session PostgreSQL. (Voir aussi les commandes ALTER USER et ALTER DATABASE pour des moyens d'initialiser le comportement par défaut par utilisateur ou par base de données.)

• PGDATESTYLE initialise le style par défaut de la représentation de la date et de l'heure. (Équivalent à SET datestyle TO ....)

• PGTZ initialise le fuseau horaire par défaut (Équivalent à SET timezone TO ....)

• PGCLIENTENCODING initialise le codage par défaut du jeu de caractères client. (Équivalent à SET client_encoding TO ....)

• PGGEQO initialise le mode par défaut pour l'optimiseur génétique de requêtes. (Équivalent à SET geqo TO ....)

Référez-vous à la commande SQL SET pour optenir plus d'informations sur les valeurs admises pour ces variables d'environnement.