Set up docs MCP딕셔너리는 다양한 종류의 참조 목록에 유용한 매핑(key -> attributes)입니다.
ClickHouse는 딕셔너리를 다루기 위한 특수 함수를 지원하며, 이러한 함수는 쿼리에서 사용할 수 있습니다. 참조 테이블과 JOIN을 사용하는 것보다 함수를 사용해 딕셔너리를 활용하는 편이 더 쉽고 효율적입니다.
딕셔너리는 다음 두 가지 방법으로 생성할 수 있습니다:
- DDL 쿼리로 생성 (권장)
- 설정 파일로 생성
DDL 쿼리로 딕셔너리 생성하기
ClickHouse Cloud에서 지원됩니다
딕셔너리는 DDL 쿼리로 생성할 수 있습니다. 다음과 같은 장점이 있으므로 이 방법을 권장합니다. DDL 쿼리로 생성한 딕셔너리는 다음과 같습니다:
- 서버 설정 파일에 추가 항목을 기록할 필요가 없습니다.
- 테이블이나 뷰와 같은 독립적인 엔터티처럼 사용할 수 있습니다.
- 딕셔너리 테이블 함수 대신 익숙한
SELECT구문을 사용해 데이터를 직접 읽을 수 있습니다.SELECT문으로 딕셔너리에 직접 접근하면, 캐시된 딕셔너리는 캐시된 데이터만 반환하고 캐시되지 않은 딕셔너리는 저장된 모든 데이터를 반환합니다. - 딕셔너리 이름을 쉽게 변경할 수 있습니다.
구문
CREATE [OR REPLACE] DICTIONARY [IF NOT EXISTS] [db.]dictionary_name [ON CLUSTER cluster]
(
key1 type1 [DEFAULT | EXPRESSION expr1] [IS_OBJECT_ID],
key2 type2 [DEFAULT | EXPRESSION expr2],
attr1 type2 [DEFAULT | EXPRESSION expr3] [HIERARCHICAL|INJECTIVE],
attr2 type2 [DEFAULT | EXPRESSION expr4] [HIERARCHICAL|INJECTIVE]
)
PRIMARY KEY key1, key2
SOURCE(SOURCE_NAME([param1 value1 ... paramN valueN]))
LAYOUT(LAYOUT_NAME([param_name param_value]))
LIFETIME({MIN min_val MAX max_val | max_val})
SETTINGS(setting_name = setting_value, setting_name = setting_value, ...)
COMMENT 'Comment'| 절 | 설명 |
|---|---|
| 속성 | 딕셔너리 속성은 테이블 컬럼과 비슷하게 지정합니다. 필수 속성은 유형뿐이며, 나머지에는 모두 기본값을 지정할 수 있습니다. |
| PRIMARY KEY | 딕셔너리 조회에 사용할 키 컬럼을 정의합니다. 레이아웃에 따라 하나 이상의 속성을 키로 지정할 수 있습니다. |
SOURCE |
딕셔너리의 데이터 소스를 정의합니다(예: ClickHouse 테이블, HTTP, PostgreSQL). |
LAYOUT |
딕셔너리가 메모리에 저장되는 방식을 제어합니다(예: FLAT, HASHED, CACHE). |
LIFETIME |
딕셔너리의 갱신 주기를 설정합니다. |
ON CLUSTER |
클러스터에 딕셔너리를 생성합니다. 선택 사항입니다. |
SETTINGS |
추가 딕셔너리 설정입니다. 선택 사항입니다. |
COMMENT |
딕셔너리에 텍스트 주석을 추가합니다. 선택 사항입니다. |
설정 파일로 딕셔너리 생성하기
딕셔너리 설정 파일의 포맷은 다음과 같습니다.
<clickhouse>
<comment>An optional element with any content. Ignored by the ClickHouse server.</comment>
<!--Optional element. File name with substitutions-->
<include_from>/etc/clickhouse-server/substitutions.xml</include_from>
<dictionary>
<!-- Dictionary configuration. -->
<!-- There can be any number of dictionary sections in a configuration file. -->
</dictionary>
</clickhouse>같은 파일에 딕셔너리를 원하는 만큼 구성할 수 있습니다.