메인 콘텐츠로 건너뛰기
딕셔너리는 다양한 종류의 참조 목록에 유용한 매핑(key -> attributes)입니다. ClickHouse는 딕셔너리를 다루기 위한 특수 함수를 지원하며, 이러한 함수는 쿼리에서 사용할 수 있습니다. 참조 테이블과 JOIN을 사용하는 것보다 함수를 사용해 딕셔너리를 활용하는 편이 더 쉽고 효율적입니다. 딕셔너리는 다음 두 가지 방법으로 생성할 수 있습니다:

DDL 쿼리로 딕셔너리 생성하기

딕셔너리는 DDL 쿼리로 생성할 수 있습니다. 다음과 같은 장점이 있으므로 이 방법을 권장합니다. DDL 쿼리로 생성한 딕셔너리는 다음과 같습니다:
  • 서버 설정 파일에 추가 항목을 기록할 필요가 없습니다.
  • 테이블이나 뷰와 같은 독립적인 엔터티처럼 사용할 수 있습니다.
  • 딕셔너리 테이블 함수 대신 익숙한 SELECT 구문을 사용해 데이터를 직접 읽을 수 있습니다. SELECT 문으로 딕셔너리에 직접 접근하면, 캐시된 딕셔너리는 캐시된 데이터만 반환하고 캐시되지 않은 딕셔너리는 저장된 모든 데이터를 반환합니다.
  • 딕셔너리 이름을 쉽게 변경할 수 있습니다.

구문

설정 파일로 딕셔너리 생성하기

설정 파일을 사용한 딕셔너리 생성은 ClickHouse Cloud에서는 지원되지 않습니다. DDL(위 참조)을 사용하고, 딕셔너리는 default 사용자로 생성하십시오.
딕셔너리 설정 파일의 포맷은 다음과 같습니다.
같은 파일에 딕셔너리를 원하는 만큼 구성할 수 있습니다.
마지막 수정일 2026년 7월 2일