Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs
49.6kGet Started

system.dictionaries

View as MarkdownEdit this pageReport an issueSet up docs MCP

설명

딕셔너리에 대한 정보를 제공합니다.

컬럼

  • database (String) — DDL 쿼리로 생성된 딕셔너리가 속한 데이터베이스 이름입니다. 다른 딕셔너리의 경우 빈 문자열입니다.
  • name (String) — 딕셔너리 이름입니다.
  • uuid (UUID) — 딕셔너리 UUID입니다.
  • status (Enum8('NOT_LOADED' = 0, 'LOADED' = 1, 'FAILED' = 2, 'LOADING' = 3, 'FAILED_AND_RELOADING' = 4, 'LOADED_AND_RELOADING' = 5, 'NOT_EXIST' = 6)) — 딕셔너리 상태입니다. 가능한 값: NOT_LOADED — 딕셔너리가 현재 메모리에 로드되지 않음, LOADED — 딕셔너리가 성공적으로 로드됨, FAILED — 오류로 인해 딕셔너리를 로드할 수 없음, LOADING — 딕셔너리를 현재 로드 중, LOADED_AND_RELOADING — 딕셔너리가 성공적으로 로드되었으며 현재 다시 로드 중임(일반적인 원인: SYSTEM RELOAD DICTIONARY 쿼리, timeout, 딕셔너리 구성 변경), FAILED_AND_RELOADING — 오류로 인해 딕셔너리를 로드할 수 없었으며 현재 로드 중임.
  • origin (String) — 딕셔너리를 설명하는 설정 파일의 경로입니다.
  • type (String) — 딕셔너리 할당 유형입니다. 딕셔너리의 메모리 저장 방식을 나타냅니다.
  • key.names (Array(String)) — 딕셔너리가 제공하는 키 이름 배열입니다.
  • key.types (Array(String)) — 딕셔너리가 제공하는 키 타입의 대응 배열입니다.
  • attribute.names (Array(String)) — 딕셔너리가 제공하는 속성 이름 배열입니다.
  • attribute.types (Array(String)) — 딕셔너리가 제공하는 속성 타입의 대응 배열입니다.
  • bytes_allocated (UInt64) — 딕셔너리에 할당된 RAM 용량입니다.
  • hierarchical_index_bytes_allocated (UInt64) — 계층형 인덱스에 할당된 RAM 용량입니다.
  • query_count (UInt64) — 딕셔너리가 로드된 이후 또는 마지막으로 성공적으로 재시작된 이후의 쿼리 수입니다.
  • hit_rate (Float64) — 캐시 딕셔너리에서 값이 캐시에 있던 조회의 비율입니다.
  • found_rate (Float64) — 값을 찾은 조회의 비율입니다.
  • element_count (UInt64) — 딕셔너리에 저장된 항목 수입니다.
  • load_factor (Float64) — 딕셔너리가 채워진 비율입니다(해시 딕셔너리의 경우 해시 테이블이 채워진 비율).
  • source (String) — 딕셔너리의 데이터 소스를 설명하는 텍스트입니다.
  • lifetime_min (UInt64) — 메모리에 있는 딕셔너리의 최소 수명입니다. 이 시간이 지나면 ClickHouse는 딕셔너리를 다시 로드하려고 시도합니다(invalidate_query가 설정된 경우 변경되었을 때만 시도). 초 단위로 설정합니다.
  • lifetime_max (UInt64) — 메모리에 있는 딕셔너리의 최대 수명입니다. 이 시간이 지나면 ClickHouse는 딕셔너리를 다시 로드하려고 시도합니다(invalidate_query가 설정된 경우 변경되었을 때만 시도). 초 단위로 설정합니다.
  • loading_start_time (DateTime) — 딕셔너리 로드 시작 시간입니다.
  • last_successful_update_time (DateTime) — 딕셔너리 로드 또는 업데이트 완료 시간입니다. 딕셔너리 소스 관련 문제를 모니터링하고 원인을 조사하는 데 도움이 됩니다.
  • error_count (UInt64) — 마지막으로 성공적으로 로드된 이후 발생한 오류 수입니다. 딕셔너리 소스 관련 문제를 모니터링하고 원인을 조사하는 데 도움이 됩니다.
  • loading_duration (Float32) — 딕셔너리 로드 소요 시간입니다.
  • last_exception (String) — 딕셔너리를 생성할 수 없는 경우, 생성 또는 다시 로드 중 발생한 오류 텍스트입니다.
  • comment (String) — 딕셔너리에 추가된 설명 텍스트입니다.

예시

딕셔너리를 구성하세요:

CREATE DICTIONARY dictionary_with_comment
(
    id UInt64,
    value String
)
PRIMARY KEY id
SOURCE(CLICKHOUSE(HOST 'localhost' PORT tcpPort() TABLE 'source_table'))
LAYOUT(FLAT())
LIFETIME(MIN 0 MAX 1000)
COMMENT 'The temporary dictionary';

딕셔너리가 로드되었는지 확인하십시오.

SELECT * FROM system.dictionaries LIMIT 1 FORMAT Vertical;
Row 1:
──────
database:                    default
name:                        dictionary_with_comment
uuid:                        4654d460-0d03-433a-8654-d4600d03d33a
status:                      NOT_LOADED
origin:                      4654d460-0d03-433a-8654-d4600d03d33a
type:
key.names:                   ['id']
key.types:                   ['UInt64']
attribute.names:             ['value']
attribute.types:             ['String']
bytes_allocated:             0
query_count:                 0
hit_rate:                    0
found_rate:                  0
element_count:               0
load_factor:                 0
source:
lifetime_min:                0
lifetime_max:                0
loading_start_time:          1970-01-01 00:00:00
last_successful_update_time: 1970-01-01 00:00:00
loading_duration:            0
last_exception:
comment:                     The temporary dictionary
Navigation