Langage de programmation - PostgreSQL - Référence de instructions

SET	Fixe
PostgreSQL

Syntaxe

SET [ SESSION | LOCAL ] configuration_parameter { TO | = } { value | 'value' | DEFAULT }

SET [ SESSION | LOCAL ] TIME ZONE { timezone | LOCAL | DEFAULT }

Paramètres

Nom	Description
SESSION	Ce paramètre permet d'indiquer que la commande prend effet pour la session en cours. (Il s'agit de la valeur par défaut si ni SESSION ni LOCAL n'apparaissent.)
LOCAL	Ce paramètre permet d'indiquer que la commande prend effet uniquement pour la transaction en cours. Après COMMIT ou ROLLBACK, le paramètre au niveau de la session prend à nouveau effet. L'émettre en dehors d'un bloc de transaction émet un avertissement et n'a aucun effet.
configuration_parameter	Ce paramètre permet d'indiquer le nom d'un paramètre d'exécution réglable.
value	Ce paramètre permet d'indiquer la nouvelle valeur de paramètre. Les valeurs peuvent être spécifiées sous forme de constantes de chaîne de caractères, d'identificateurs, de nombres ou de listes séparées par des virgules, selon le cas pour le paramètre particulier. DEFAULT peut être écrit pour spécifier la réinitialisation du paramètre à sa valeur par défaut (c'est-à-dire quelle que soit la valeur qu'il aurait eue si aucun SET n'avait été exécuté dans la session en cours). Outre les paramètres de configuration, il y en a quelques-uns ne pouvant être ajustés qu'à l'aide de la commande SET ou ayant une syntaxe spéciale :
	Valeur	Description
	SCHEMA	SET SCHEMA 'value' est un alias pour SET search_path TO value. Un seul schéma peut être spécifié à l'aide de cette syntaxe.
	NAMES	La valeur SET NAMES est un alias pour la valeur «SET client_encoding TO».
	SEED	Cette valeur permet de définir la graine interne pour le générateur de nombres aléatoires (la fonction random). Les valeurs autorisées sont des nombres à virgule flottante compris entre -1 et 1, étant ensuite multipliés par 2³¹-1. La graine peut également être définie en appelant la fonction setseed suivante : «SELECT setseed(value);».
TIME ZONE timezone	Ce paramètre permet d'indiquer la spécification du fuseau horaire. La valeur SET TIME ZONE est un alias de la valeur «SET timezone TO». Voici des exemples de valeurs valides :
	Valeur	Description
	'PST8PDT'	Cette valeur permet d'indiquer le fuseau horaire de Berkeley, Californie.
	'Europe/Rome'	Cette valeur permet d'indiquer le fuseau horaire de l'Italie.
	-7	Cette valeur permet d'indiquer le fuseau horaire à 7 heures à l'ouest de UTC (équivalent à PDT). Les valeurs positives sont à l'est de l'UTC.
	INTERVAL '-08:00' HOUR TO MINUTE	Cette valeur permet d'indiquer le fuseau horaire à 8 heures à l'ouest de UTC (équivalent à PST).
	LOCAL	Cette valeur permet de définir le fuseau horaire sur votre fuseau horaire local (c'est-à-dire la valeur par défaut du fuseau horaire du serveur).
	DEFAULT	Cette valeur permet de définir le fuseau horaire sur le fuseau horaire du serveur.
	Les paramètres de fuseau horaire donnés sous forme de nombres ou d'intervalles sont traduits en interne en syntaxe de fuseau horaire POSIX. Par exemple, après SET TIME ZONE -7, SHOW TIME ZONE indiquera <-07>+07.

Description

Cette instruction permet de modifier un paramètre d'exécution.

Remarques

La commande SET modifie les paramètres de configuration d'exécution. Mais certains nécessitent des privilèges de superutilisateur pour changer, et d'autres ne peuvent pas être modifiés après le démarrage du serveur ou de la session. L'instruction SET n'affecte que la valeur utilisée par la session en cours.
Si SET (ou de manière équivalente SET SESSION) est émis dans une transaction étant ensuite abandonnée, les effets de la commande SET disparaissent lorsque la transaction est annulée. Une fois la transaction environnante validée, les effets persisteront jusqu'à la fin de la session, à moins qu'ils ne soient remplacés par un autre SET.
Les effets de SET LOCAL ne durent que jusqu'à la fin de la transaction en cours, qu'elle soit validée ou non. Un cas particulier est SET suivi de SET LOCAL au sein d'une même transaction : la valeur SET LOCAL sera vue jusqu'à la fin de la transaction, mais après (si la transaction est validée) la valeur SET prendra effet.
Les effets de SET ou SET LOCAL sont également annulés en revenant à un point de sauvegarde antérieur à la commande.
Si SET LOCAL est utilisé dans une fonction ayant une option SET pour la même variable (voir CREATE FUNCTION), les effets de la commande SET LOCAL disparaissent à la sortie de la fonction ; c'est-à-dire que la valeur en vigueur lorsque la fonction a été appelée est de toute façon restaurée. Cela permet d'utiliser SET LOCAL pour les modifications dynamiques ou répétées d'un paramètre dans une fonction, tout en ayant la commodité d'utiliser l'option SET pour enregistrer et restaurer la valeur de l'appelant. Cependant, une commande SET normale remplace l'option SET de n'importe quelle fonction environnante ; ses effets persisteront à moins d'être annulés.
Dans les versions PostgreSQL version 8.0 à 8.2, les effets d'un SET LOCAL seraient annulés en libérant un point de sauvegarde antérieur, ou en sortant avec succès d'un bloc d'exception PL/pgSQL. Ce comportement a été modifié car il a été jugé peu intuitif.
La fonction set_config fournit des fonctionnalités équivalentes à l'instruction SET. De plus, il est possible d'effectuer un UPDATE sur la vue système pg_settings pour effectuer l'équivalent de SET.

Dernière mise à jour : Jeudi, le 14 Octobre 2021

Section courante

A propos

Section administrative du site

SET

Syntaxe

Paramètres

Description

Remarques