SET

Nom

SET — Place les paramètres de démarrage pour la session.
SET variable { TO | = } { 'value' | DEFAULT }
SET TIME ZONE { 'timezone' | LOCAL | DEFAULT }
SET TRANSACTION ISOLATION LEVEL { READ COMMITTED | SERIALIZED }
  

Entrées

variable

paramètre global plaçable.

value

nouvelle valeur de paramètre.

les variables possibles et les valeurs admises sont :

CLIENT_ENCODING | NAMES

Place l'encodage client multi-octet. Les paramètres sont:

value

Place l'encodage client multi-octet à value. l'encodage spécifié doit être supporté par le serveur.

DEFAULT

Place l'encodage client multi-octet à la valeur par défaut.

Activé seulement si multi-octet a été spécifié lors de la configuration.

DateStyle

Place le style représentation date/time. Affecte le format de sortie, et dans certains cas peut affecter l'interprétation de l'entrée.

ISO

utilise le style date et heure ISO 8601.

SQL

utilise le style date et heure Oracle/Ingres

Postgres

format traditionnel Postgres

European

utilise jj/mm/aa pour la représentation numérique des dates.

NonEuropean

utilise mm/jj/aa pour la représentation numérique des dates.

German

utilise jj.mm.aa pour la représentation numérique des dates.

US

idem que 'NonEuropean'

default

restaure les valeurs par défaut ('US,Postgres')

L'initialisation du format de date peut être fait en :

plaçant la variable d'environnement PGDATESTYLE.
lançant le postmaster en utilisant l'option -o -e pour placer les dates selon la convention European. Notez que ceci affecte seulement quelques combinaisons de styles de dates; par exemple le style ISO n'est pas affecté par ce paramètre.
changeant les variables dans src/backend/utils/init/globals.c.

les variables dans globals.c qui peuvent être changées sont :

bool EuroDates = false | true
int DateStyle = USE_ISO_DATES | USE_POSTGRES_DATES | USE_SQL_DATES | USE_GERMAN_DATES

SERVER_ENCODING

Place l'encodage multi-octet du serveur

value

Place l'encodage multi-octet du serveur.

DEFAULT

Place l'encodage multi-octet du serveur.

Actif seulement si le multi-octet a été spécifié à la configuration.

TIMEZONE

Les valeurs possibles pour timezone dépendent de votre système d'exploitation. Par exemple pour Linux /usr/lib/zoneinfo contient la base de données des zones horaires.

Quelques valeurs correctes pour timezone :

'PST8PDT'

place la zone horaire pour la Californie.

'Portugal'

place la zone horaire pour le Portugal.

'Europe/Rome'

place la zone horaire pour l'Italie.

DEFAULT

place la zone horaire à votre zone locale (valeur de la variable d'environnement).

Si une zone horaire invalide est spécifiée, elle passe en GMT (sur la plupart des systèmes).

Un client qui utilise libpq peut être initialisé en plaçant la variable d'environnement PGTZ.

La seconde syntaxe vue ci-dessus, permet d'indiquer la zone horaire avec une syntaxe similaire au SET TIME ZONE de SQL92. Le mot-clé local est juste une forme alternative de DEFAULT pour la compatibilité SQL92.

TRANSACTION ISOLATION LEVEL

Place le niveau d'isolation pour la transaction en cours.

READ COMMITTED

Les requêtes de la transaction en cours lisent seulement les lignes validées avant qu'une requête commence. READ COMMITED est la clause par défaut.

Note

Le standard SQL92 nécessite que SERIALIZABLE soit le niveau d'isolation par défaut.

SERIALIZABLE

Les requêtes de la transaction en cours lisent seulement les lignes validées avant que le premier DML (SELECT/INSERT/DELETE/UPDATE/FETCH/COPY_TO) soit exécuté dans cette transaction.

Il existe aussi des paramètres internes ou d'optimisation qui peuvent être spécifiés par la commande SET :

COST_HEAP

Sets the default cost of a heap scan for use by the optimizer.

float4

Set the cost of a heap scan to the specified floating point value.

DEFAULT

Sets the cost of a heap scan to the default value.

Le client peut être initialisé en plaçant la variable d'environnement PGCOSTHEAP.

COST_INDEX

Sets the default cost of an index scan for use by the optimizer.

float4

Set the cost of an index scan to the specified floating point value.

DEFAULT

Sets the cost of an index scan to the default value.

Le client peut être initialisé en plaçant la variable d'environnement PGCOSTINDEX.

GEQO

Sets the threshold for using the genetic optimizer algorithm.

ON

enables the genetic optimizer algorithm for statements with 6 or more tables.

ON=#

Takes an integer argument to enable the genetic optimizer algorithm for statements with # or more tables in the query.

OFF

disables the genetic optimizer algorithm.

DEFAULT

Equivalent à spécifier SET GEQO='ON'

This algorithm is on by default, which used GEQO for statements of eleven or more tables. (See the chapter on GEQO in the Programmer's Guide for more information).

The frontend may be initialized by setting PGGEQO environment variable.

It may be useful when joining big relations with small ones. This algorithm is off by default. It's not used by GEQO anyway.

KSQO

Key Set Query Optimizer forces the query optimizer to optimize repetative OR clauses such as generated by MicroSoft Access:

ON

enables this optimization.

OFF

disables this optimization.

DEFAULT

Equivalent à spécifier SET KSQO='OFF'.

It may be useful when joining big relations with small ones. This algorithm is off by default. It's not used by GEQO anyway.

The frontend may be initialized by setting the PGKSQO environment variable.

Sorties

SET VARIABLE

Message retourné si succès.

WARN: Bad value for variable (value)

Si la commande échoue à placer la variable spécifiée.

Description

SET modifiera la configuration des paramètres pour la variable pendant la session.

Las valeurs courantes peuvent être obtenues en utilisant SHOW, et elles peuvent être remises par défaut par RESET. Parameters and values are case-insensitive. Note that the value field is always specified as a string, so is enclosed in single-quotes.

SET TIME ZONE changes the session's default time zone offset. An SQL-session always begins with an initial default time zone offset. The SET TIME ZONE statement is used to change the default time zone offset for the current SQL session.

Notes

The SET variable statement is a Postgres language extension.

Refer to SHOW and RESET to display or reset the current values.

Utilisation

Set the style of date to ISO:
   SET DATESTYLE TO 'ISO';
   
Enable GEQO for queries with 4 or more tables:
 
   SET GEQO ON=4;
   
Set GEQO to default:
 
   SET GEQO = DEFAULT;
   
Set the timezone for Berkeley, California:
 
   SET TIME ZONE 'PST8PDT';
   SELECT CURRENT_TIMESTAMP AS today;
   
   today
   ----------------------
   1998-03-31 07:41:21-08
   
Set the timezone for Italy:
 
   SET TIME ZONE 'Europe/Rome';
   SELECT CURRENT_TIMESTAMP AS today;
   
   today
   ----------------------
   1998-03-31 17:41:31+02
   

Compatibilité

SQL92

There is no SET variable in SQL92 (except for SET TRANSACTION ISOLATION LEVEL). The SQL92 syntax for SET TIME ZONE is slightly different, allowing only a single integer value for time zone specification:
     SET TIME ZONE { interval_value_expression | LOCAL }