특정 설정을 적용해 SQL 문을 실행하는 방법은 여러 가지가 있습니다.
설정은 여러 계층으로 구성되며, 각 후속 계층은 이전 계층에서 설정된 값을 다시 정의합니다.
설정을 정의할 때의 우선순위는 다음과 같습니다.
-
사용자에게 직접 설정을 적용하거나 설정 프로필 내에서 적용
- SQL (권장)
/etc/clickhouse-server/users.d에 하나 이상의 XML 또는 YAML 파일 추가
-
세션 설정
- ClickHouse Cloud SQL 콘솔 또는 대화형 모드의
clickhouse client에서 SET setting=value를 전송합니다. 마찬가지로 HTTP protocol에서도 ClickHouse
session을 사용할 수 있습니다. 이렇게 하려면
session_id HTTP 매개변수를 지정해야 합니다.
-
쿼리 설정
- 비대화형 모드로
clickhouse client를 시작할 때 시작
매개변수 --setting=value를 지정합니다.
- HTTP API를 사용할 때 CGI 매개변수(
URL?setting_1=value&setting_2=value...)를 전달합니다.
- SELECT 쿼리의
SETTINGS
절에서 설정을 정의합니다. 설정 값은 해당 쿼리에만 적용되며,
쿼리 실행 후 기본값 또는 이전 값으로 재설정됩니다.
설정을 변경한 뒤 기본값으로 다시 되돌리려면 값을 DEFAULT로 지정합니다. 구문은 다음과 같습니다:
SET setting_name = DEFAULT
async_insert의 기본값은 0입니다. 값을 1로 변경한다고 가정해 보겠습니다:
SET async_insert = 1;
SELECT value FROM system.settings where name='async_insert';
┌─value──┐
│ 1 │
└────────┘
SET async_insert = DEFAULT;
SELECT value FROM system.settings where name='async_insert';
┌─value───┐
│ 0 │
└─────────┘
- 사용자 아이덴티티 또는 조직을 기준으로 데이터 필터링
- Context에 따라 다른 비즈니스 로직 적용
- 세션에서 여러 쿼리에 걸쳐 상태 정보 유지
사용자 지정 설정 이름은 정의한 목록에 포함된 미리 정의된 프리픽스 중 하나로 시작해야 합니다.
프리픽스 목록은 서버 구성 파일에 정의된 서버 설정 custom_settings_prefixes를 사용해 지정할 수 있습니다.
아래 예시에서는 SQL_를 접두사로 선택합니다:
<custom_settings_prefixes>SQL_</custom_settings_prefixes>
ClickHouse Cloud에서는 접두사를 지정할 수 없습니다.
모든 사용자 지정 사용자 설정은 SQL_ 접두사로 시작합니다.
SET 명령을 사용합니다:
사용자 지정 설정의 현재 값을 가져오려면 getSetting() 함수를 사용하십시오:
SELECT getSetting('SQL_a');
async_insert 설정 값을 1로 지정하고,
실행 중인 시스템에서 설정을 확인하는 방법을 보여줍니다.
SQL을 사용해 사용자에게 직접 설정 적용하기
async_inset = 1 설정으로 사용자 ingester를 생성합니다:
CREATE USER ingester
IDENTIFIED WITH sha256_hash BY '7e099f39b84ea79559b3e85ea046804e63725fd1f46b37f281276aae20f86dc3'
SETTINGS async_insert = 1
┌─ACCESS─────────────────────────────────────────────────────────────────────────────┐
│ ... │
│ CREATE USER ingester IDENTIFIED WITH sha256_password SETTINGS async_insert = true │
│ ... │
└────────────────────────────────────────────────────────────────────────────────────┘
SQL을 사용해 설정 프로필을 생성하고 사용자에게 할당하기
async_inset = 1 설정으로 log_ingest 프로필을 생성하는 예입니다:
CREATE
SETTINGS PROFILE log_ingest SETTINGS async_insert = 1
ingester가 생성되고, 해당 사용자에게 설정 프로필 log_ingest가 할당됩니다:
CREATE USER ingester
IDENTIFIED WITH sha256_hash BY '7e099f39b84ea79559b3e85ea046804e63725fd1f46b37f281276aae20f86dc3'
SETTINGS PROFILE log_ingest
/etc/clickhouse-server/users.d/users.xml
<clickhouse>
<profiles>
<log_ingest>
<async_insert>1</async_insert>
</log_ingest>
</profiles>
<users>
<ingester>
<password_sha256_hex>7e099f39b84ea79559b3e85ea046804e63725fd1f46b37f281276aae20f86dc3</password_sha256_hex>
<profile>log_ingest</profile>
</ingester>
<default replace="true">
<password_sha256_hex>7e099f39b84ea79559b3e85ea046804e63725fd1f46b37f281276aae20f86dc3</password_sha256_hex>
<access_management>1</access_management>
<named_collection_control>1</named_collection_control>
</default>
</users>
</clickhouse>
┌─ACCESS─────────────────────────────────────────────────────────────────────────────┐
│ CREATE USER default IDENTIFIED WITH sha256_password │
│ CREATE USER ingester IDENTIFIED WITH sha256_password SETTINGS PROFILE log_ingest │
│ CREATE SETTINGS PROFILE default │
│ CREATE SETTINGS PROFILE log_ingest SETTINGS async_insert = true │
│ CREATE SETTINGS PROFILE readonly SETTINGS readonly = 1 │
│ ... │
└────────────────────────────────────────────────────────────────────────────────────┘
SET async_insert =1;
SELECT value FROM system.settings where name='async_insert';
┌─value──┐
│ 1 │
└────────┘
INSERT INTO YourTable
SETTINGS async_insert=1
VALUES (...)
