Cómo configurar SETTING para un usuario en ClickHouse

Introducción

Hay varias formas de definir una SETTING para un usuario en ClickHouse, según el caso de uso y el tiempo durante el que quieras que esa SETTING se mantenga. Veamos algunos escenarios…

Configurar una SETTING para una sola consulta

Una consulta SELECT puede contener una cláusula SETTINGS en la que se puede definir cualquier cantidad de SETTINGS. Estas SETTINGS solo se aplican a esa consulta en particular. Por ejemplo:

SELECT *
FROM my_table
SETTINGS max_threads = 8;

El número máximo de hilos será de 8 para esta consulta en particular.

Configura un SETTING para una sesión

Puedes definir un SETTING durante la duración de una sesión de cliente mediante una cláusula SET. Esto resulta útil para pruebas ad hoc o cuando quieres que un SETTING se mantenga durante unas pocas consultas, pero no más tiempo.

SET max_threads = 8;

SELECT *
FROM my_table;

Configurar un SETTING para un usuario concreto

Usa ALTER USER para definir un SETTING solo para un usuario. Por ejemplo:

ALTER USER my_user_name SETTINGS max_threads = 8;

Puede comprobar que funcionó cerrando sesión en su cliente, volviendo a iniciarla y usando luego la función getSetting:

SELECT getSetting('max_threads');

Especificar la configuración de esta forma sobrescribirá la configuración actual del usuario; es decir, si tenías otra configuración aplicada al usuario pero no la especificaste en la sentencia ALTER USER, se perderá.Si quieres conservar tu configuración, usa ALTER USER ... MODIFY SETTING ... en su lugar.

Última modificación el 3 de julio de 2026

Configuración de las capacidades CAP_IPC_LOCK y CAP_SYS_NICE en DockerAprende a resolver las advertencias de Docker sobre las capacidades `CAP_IPC_LOCK` y `CAP_SYS_NICE` al ejecutar ClickHouse en un contenedor.

​Introducción

​Configurar una SETTING para una sola consulta

​Configura un SETTING para una sesión

​Configurar un SETTING para un usuario concreto

Introducción

Configurar una SETTING para una sola consulta

Configura un SETTING para una sesión

Configurar un SETTING para un usuario concreto