Pular para o conteúdo principal

Introdução

Há várias maneiras de definir uma SETTING para um usuário no ClickHouse, dependendo do caso de uso e de por quanto tempo você quer mantê-la configurada. Vamos ver alguns cenários…

Defina uma SETTING para uma única consulta

Uma consulta SELECT pode conter uma cláusula SETTINGS, na qual é possível definir quantas SETTINGs forem necessárias. As SETTINGs são aplicadas apenas a essa consulta específica. Por exemplo:
O número máximo de threads será 8 para esta consulta específica.

Configure uma SETTING para uma sessão

Você pode definir uma SETTING para a duração de uma sessão do cliente usando uma cláusula SET. Isso é útil para testes ad hoc ou quando você quer que uma SETTING permaneça ativa durante algumas consultas — mas não por mais tempo.

Configure um parâmetro para um usuário específico

Use ALTER USER para definir um SETTING apenas para um usuário. Por exemplo:
Você pode verificar se funcionou fazendo logout no seu cliente, entrando novamente e, em seguida, usando a função getSetting:
Especificar as configurações dessa forma substituirá as configurações atuais do usuário; ou seja, se você tiver outras configurações aplicadas ao usuário, mas não as especificar na instrução ALTER USER, elas serão perdidas.Se quiser manter suas configurações, use ALTER USER ... MODIFY SETTING ...
Última modificação em 12 de junho de 2026