메인 콘텐츠로 건너뛰기

구문

ClickHouse Cloud에서 딕셔리를 사용하는 경우, 딕셔너리를 만들 때는 DDL query 옵션을 사용하고 사용자 default로 생성하십시오. 또한 Cloud Compatibility 가이드에서 지원되는 딕셔너리 소스 목록도 확인하십시오.
딕셔너리는 다양한 소스를 통해 ClickHouse에 연결할 수 있습니다. 소스는 설정 파일에서는 source 섹션에서, DDL 문에서는 SOURCE 절을 사용해 구성합니다.

지원되는 딕셔너리 소스

다음 소스 유형(SOURCE_TYPE/source_type)을 지원합니다: 소스 유형 로컬 파일, 실행형 파일, HTTP(s), ClickHouse에서는 선택적 설정을 지정할 수 있습니다:

사용자 정의 쿼리의 컬럼 순서

ClickHouse, MySQL, PostgreSQL 및 ODBC 소스는 query 필드를 지원합니다. 이 필드를 지정하면 ClickHouse가 table과 where를 바탕으로 빌드하는 쿼리 대신 해당 쿼리가 사용됩니다. 딕셔너리는 이 결과의 컬럼이 정해진 순서대로 나열된다고 가정합니다. 이 순서는 CREATE DICTIONARY SQL 문에서 속성을 작성한 순서와 다릅니다.
  1. 키 컬럼(Key column): PRIMARY KEY에 지정된 순서대로
  2. range_hashed 또는 complex_key_range_hashed 딕셔너리라면 range_min 컬럼, 이어서 range_max 컬럼
  3. 나머지 속성: 선언된 순서대로
ClickHouse 소스는 컬럼명을 기준으로 결과를 이 순서에 맞추므로, 각 컬럼 이름이 해당 컬럼이 채우는 속성 이름과 같다면 query의 컬럼 순서는 상관없습니다. 반면 MySQL, PostgreSQL 및 ODBC 소스는 컬럼을 위치 기준으로 가져오므로, 컬럼 순서가 위와 다른 query를 사용하면 값이 엉뚱한 속성에 로드됩니다. 관련 타입에 따라 딕셔너리가 변환 오류로 로드되지 않거나 잘못된 값이 저장되므로, query는 위 순서대로 작성하십시오.