Descrição

O comando SET modifica parâmetros de configuração de tempo de execução. Muitos dos parâmetros de tempo de execução listados em Configuração do servidor podem ser modificados dinamicamente pelo comando SET. (Alguns parâmetros só podem ser alterados por superusuários e usuários que receberam o privilégio SET para este parâmetro. Também existem parâmetros que não podem ser alterados após o servidor ou a sessão iniciar.) O comando SET afeta apenas o valor usado pela sessão corrente.

Se o comando SET (ou o equivalente SET SESSION) for executado numa transação interrompida posteriormente, os efeitos do comando SET desaparecerão quando a transação for desfeita. Depois que a transação envolvente for efetivada, os efeitos persistirão até o final da sessão, a menos que sejam substituídos por outro comando SET.

Os efeitos do comando SET LOCAL duram apenas até o final da transação corrente, seja esta confirmada ou não. Um caso especial é o comando SET seguido por um comando SET LOCAL na mesma transação: o valor do comando SET LOCAL será visto até o final da transação, mas depois (se a transação for efetivada) o valor do comando SET passa a valer.

Os efeitos do comando SET ou SET LOCAL também são cancelados desfazendo para um ponto de salvamento anterior ao comando.

Se o comando SET LOCAL for usado numa função contendo uma opção SET para a mesma variável (veja CREATE FUNCTION), os efeitos do comando SET LOCAL desaparecerão ao sair da função; ou seja, o valor em vigor quando a função foi chamada é restaurado de qualquer maneira. Isto permite que o comando SET LOCAL seja usado para alterações dinâmicas ou repetidas de um parâmetro dentro de uma função, enquanto ainda tem a conveniência de usar a opção SET para salvar e restaurar o valor do chamador. Entretanto, um comando SET regular substitui a opção SET de qualquer função circundante; seus efeitos persistirão a menos que sejam desfeitos.

Parâmetros

Além dos parâmetros de configuração documentados em Configuração do servidor, existem alguns que só podem ser ajustados usando o comando SET, ou que possuem uma sintaxe especial:

Notas

A função set_config fornece uma funcionalidade equivalente; veja Funções de definição de configuração. Além disso, é possível atualizar a visão do sistema pg_settings para executar o equivalente ao comando SET.

Exemplos

Definir o caminho de procura de esquema:

SET search_path TO my_schema, public;

Definir o estilo da data para o estilo tradicional do POSTGRES, com a convenção de entrada “dia antes do mês”:

SET datestyle TO postgres, dmy;

Definir a zona horária para Berkeley, Califórnia:

SET TIME ZONE 'America/Los_Angeles';

Definir a zona horária para a Itália:

SET TIME ZONE 'Europe/Rome';

$ # Linux Debian 12
$ timedatectl list-timezones | grep Brazil

Brazil/Acre
Brazil/DeNoronha
Brazil/East
Brazil/West

$ ls -l /usr/share/zoneinfo/Brazil/ | cut -c40-

Acre -> ../America/Rio_Branco
DeNoronha -> ../America/Noronha
East -> ../America/Sao_Paulo
West -> ../America/Manaus

-- PostgreSQL
SELECT * FROM pg_timezone_names
    WHERE name LIKE 'Brazil%'
    ORDER BY abbrev;

       name       | abbrev | utc_offset | is_dst
------------------+--------+------------+--------
 Brazil/DeNoronha | -02    | -02:00:00  | f
 Brazil/East      | -03    | -03:00:00  | f
 Brazil/West      | -04    | -04:00:00  | f
 Brazil/Acre      | -05    | -05:00:00  | f
(4 linhas)

SELECT * FROM pg_timezone_names
    WHERE name LIKE 'America%'
    ORDER BY name;

               name               | abbrev | utc_offset | is_dst
----------------------------------+--------+------------+--------
 America/Adak                     | HDT    | -09:00:00  | t
 America/Anchorage                | AKDT   | -08:00:00  | t
 America/Anguilla                 | AST    | -04:00:00  | f
 America/Antigua                  | AST    | -04:00:00  | f
 America/Araguaina                | -03    | -03:00:00  | f
 America/Argentina/Buenos_Aires   | -03    | -03:00:00  | f
...
 America/Winnipeg                 | CDT    | -05:00:00  | t
 America/Yakutat                  | AKDT   | -08:00:00  | t
 America/Yellowknife              | MDT    | -06:00:00  | t
(169 linhas)

Conformidade

O comando SET TIME ZONE estende a sintaxe definida no padrão SQL. O padrão permite apenas deslocamentos numéricos de zona horária, enquanto o PostgreSQL permite especificações de zona horária mais flexíveis. Todos os outros recursos do comando SET são extensões do PostgreSQL.

Veja também