ClickHouse에서 사용자별 설정을 구성하는 방법

소개

사용 사례와 설정을 적용해 둘 기간에 따라 ClickHouse에서 사용자 설정을 정의하는 방법은 여러 가지가 있습니다. 몇 가지 시나리오를 살펴보겠습니다…

단일 쿼리에 설정 구성하기

SELECT 쿼리에는 원하는 수만큼 설정을 정의할 수 있는 SETTINGS 절을 포함할 수 있습니다. 이 설정은 해당 쿼리에만 적용됩니다. 예시는 다음과 같습니다:

SELECT *
FROM my_table
SETTINGS max_threads = 8;

이 쿼리의 최대 스레드 수는 8입니다.

세션에 대한 설정 구성

SET 절을 사용하면 클라이언트 세션이 유지되는 동안 적용될 설정을 정의할 수 있습니다. 이는 임시 테스트를 수행하거나, 몇 개의 쿼리에만 설정을 적용하고 그보다 오래 유지하지 않으려는 경우에 유용합니다.

SET max_threads = 8;

SELECT *
FROM my_table;

특정 사용자에 대한 설정 지정

특정 사용자 한 명에게만 적용되는 설정을 정의하려면 ALTER USER를 사용합니다. 예시는 다음과 같습니다:

ALTER USER my_user_name SETTINGS max_threads = 8;

클라이언트에서 로그아웃했다가 다시 로그인한 후 getSetting 함수를 사용하여 정상적으로 작동하는지 확인할 수 있습니다:

SELECT getSetting('max_threads');

이런 방식으로 설정을 지정하면 해당 사용자의 현재 설정이 덮어써집니다. 즉, 사용자에게 다른 설정이 적용되어 있었더라도 ALTER USER 문에서 이를 지정하지 않으면 해당 설정은 사라집니다.기존 설정을 유지하려면 대신 ALTER USER ... MODIFY SETTING ...을 사용하십시오

마지막 수정일 2026년 6월 19일

Docker에서 CAP_IPC_LOCK 및 CAP_SYS_NICE capability 설정컨테이너에서 ClickHouse를 실행할 때 `CAP_IPC_LOCK` 및 `CAP_SYS_NICE`와 관련된 Docker capability 경고를 해결하는 방법을 알아봅니다.

​소개

​단일 쿼리에 설정 구성하기

​세션에 대한 설정 구성

​특정 사용자에 대한 설정 지정

소개

단일 쿼리에 설정 구성하기

세션에 대한 설정 구성

특정 사용자에 대한 설정 지정