Instrução SET

Documentação da instrução SET

SET param = value

Atribui value à configuração param da [sessão] atual. Você não pode alterar as configurações do servidor dessa forma.

Você também pode definir, em uma única consulta, todos os valores do perfil de configurações especificado.

SET profile = 'profile-name-from-the-settings-file'

Para configurações booleanas definidas como true, você pode usar uma sintaxe abreviada, omitindo a atribuição do valor. Quando apenas o nome da configuração é especificado, ela é automaticamente definida como 1 (true).

-- Estes são equivalentes:
SET force_index_by_date = 1
SET force_index_by_date

​

SET TIME ZONE

SET TIME ZONE [=] 'timezone'

Define o fuso horário da sessão. É um alias para SET session_timezone = 'timezone', fornecido para compatibilidade com o PostgreSQL e outros bancos de dados SQL.

Muitos clientes SQL, ORMs e drivers JDBC executam automaticamente SET TIME ZONE ao se conectar. Essa sintaxe permite que essas ferramentas funcionem com o ClickHouse sem soluções de contorno personalizadas.

SET TIME ZONE 'UTC';
SET TIME ZONE 'Europe/Amsterdam';
SET TIME ZONE 'America/New_York';

-- Verificar o fuso horário da sessão atual
SELECT getSetting('session_timezone');

O valor de timezone deve ser um nome válido no IANA Time Zone Database. Um nome de timezone inválido resultará em erro.

Para mais informações sobre a configuração session_timezone, consulte session_timezone.

​

Definindo parâmetros de consulta

A instrução SET também pode ser usada para definir parâmetros de consulta, prefixando o nome do parâmetro com param_. Os parâmetros de consulta permitem escrever consultas genéricas com placeholders que são substituídos pelos valores reais no momento da execução.

SET param_name = value

Para usar um parâmetro de consulta em sua consulta, use a sintaxe {name: datatype} para referenciá-lo:

SET param_id = 42;
SET param_name = 'John';

SELECT * FROM users
WHERE id = {id: UInt32}
AND name = {name: String};

Os parâmetros de consulta são especialmente úteis quando a mesma consulta precisa ser executada várias vezes com valores diferentes.

Para informações mais detalhadas sobre parâmetros de consulta, incluindo o uso com o tipo Identifier, consulte Definindo e usando parâmetros de consulta.

Para mais informações, consulte Configurações.