> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-fix-nav-issues.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Documentação da instrução SET

# Instrução SET

```sql theme={null}
SET param = value
```

Atribui `value` à [configuração](/pt-BR/concepts/features/configuration/settings/overview) `param` da \[sessão] atual. Você não pode alterar as [configurações do servidor](/pt-BR/reference/settings/server-settings/settings) dessa forma.

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

```sql theme={null}
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).

```sql theme={null}
-- Estes são equivalentes:
SET force_index_by_date = 1
SET force_index_by_date
```

<div id="set-time-zone">
  ## SET TIME ZONE
</div>

```sql theme={null}
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.

```sql theme={null}
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](https://www.iana.org/time-zones). Um nome de timezone inválido resultará em erro.

Para mais informações sobre a configuração `session_timezone`, consulte [session\_timezone](/pt-BR/reference/settings/session-settings#session_timezone).

<div id="setting-query-parameters">
  ## Definindo parâmetros de consulta
</div>

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.

```sql theme={null}
SET param_name = value
```

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

```sql theme={null}
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](/pt-BR/reference/syntax#defining-and-using-query-parameters).

Para mais informações, consulte [Configurações](/pt-BR/reference/settings/session-settings).