> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-fbfa8bee.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> 딕셔너리 정보를 포함하는 시스템 테이블

# system.dictionaries

<Info>
  **ClickHouse Cloud에서 쿼리하기**

  이 시스템 테이블의 데이터는 ClickHouse Cloud의 각 노드에 로컬로 저장됩니다. 따라서 전체 데이터를 모두 확인하려면 `clusterAllReplicas` 함수를 사용해야 합니다. 자세한 내용은 [여기](/ko/reference/system-tables/overview#system-tables-in-clickhouse-cloud)를 참조하십시오.
</Info>

<div id="description">
  ## 설명
</div>

[딕셔너리](/ko/reference/statements/create/dictionary)에 대한 정보를 제공합니다.

<div id="columns">
  ## 컬럼
</div>

* `database` ([String](/ko/reference/data-types/index)) — DDL query로 생성된 딕셔너리가 포함된 데이터베이스 이름입니다. 다른 딕셔너리의 경우 빈 문자열입니다.
* `name` ([String](/ko/reference/data-types/index)) — 딕셔너리 이름입니다.
* `uuid` ([UUID](/ko/reference/data-types/index)) — 딕셔너리 UUID입니다.
* `status` ([Enum8('NOT\_LOADED' = 0, 'LOADED' = 1, 'FAILED' = 2, 'LOADING' = 3, 'FAILED\_AND\_RELOADING' = 4, 'LOADED\_AND\_RELOADING' = 5, 'NOT\_EXIST' = 6)](/ko/reference/data-types/index)) — 딕셔너리 상태입니다. 가능한 값:
  * **NOT\_LOADED** — 사용되지 않았기 때문에 딕셔너리가 로드되지 않았습니다
  * **LOADED** — 딕셔너리가 성공적으로 로드되었습니다
  * **FAILED** — 오류로 인해 딕셔너리를 로드할 수 없습니다
  * **LOADING** — 현재 딕셔너리를 로드하고 있습니다
  * **LOADED\_AND\_RELOADING** — 딕셔너리가 성공적으로 로드되었습니다
  * **and is being reloaded right now (frequent reasons: SYSTEM RELOAD DICTIONARY query** —
  * **timeout** —
  * **dictionary config has changed)** —
  * **FAILED\_AND\_RELOADING** — 오류로 인해 딕셔너리를 로드하지 못했으며 현재 다시 로드하고 있습니다.
* `origin` ([String](/ko/reference/data-types/index)) — 딕셔너리를 설명하는 설정 파일의 경로입니다.
* `type` ([String](/ko/reference/data-types/index)) — 딕셔너리 할당 유형입니다. 딕셔너리를 메모리에 저장합니다.
* `key.names` ([배열(String)](/ko/reference/data-types/index)) — 딕셔너리에서 제공하는 키 이름 배열입니다.
* `key.types` ([배열(String)](/ko/reference/data-types/index)) — 딕셔너리에서 제공하는 해당 키 타입 배열입니다.
* `attribute.names` ([배열(String)](/ko/reference/data-types/index)) — 딕셔너리에서 제공하는 속성 이름 배열입니다.
* `attribute.types` ([배열(String)](/ko/reference/data-types/index)) — 딕셔너리에서 제공하는 해당 속성 타입 배열입니다.
* `bytes_allocated` ([UInt64](/ko/reference/data-types/index)) — 딕셔너리에 할당된 RAM 크기입니다.
* `hierarchical_index_bytes_allocated` ([UInt64](/ko/reference/data-types/index)) — 계층형 인덱스에 할당된 RAM 크기입니다.
* `query_count` ([UInt64](/ko/reference/data-types/index)) — 딕셔너리가 로드된 이후 또는 마지막으로 성공적으로 재시작된 이후의 쿼리 수입니다.
* `hit_rate` ([Float64](/ko/reference/data-types/index)) — cache 딕셔너리에서 값이 캐시에 존재했던 사용 비율입니다.
* `found_rate` ([Float64](/ko/reference/data-types/index)) — 값이 발견된 사용 비율입니다.
* `element_count` ([UInt64](/ko/reference/data-types/index)) — 딕셔너리에 저장된 항목 수입니다.
* `load_factor` ([Float64](/ko/reference/data-types/index)) — 딕셔너리가 채워진 비율입니다(해시된 딕셔너리의 경우 해시 테이블이 채워진 비율).
* `source` ([String](/ko/reference/data-types/index)) — 딕셔너리의 데이터 소스를 설명하는 텍스트입니다.
* `lifetime_min` ([UInt64](/ko/reference/data-types/index)) — 메모리 내 딕셔너리의 최소 lifetime입니다. 이 시간이 지나면 ClickHouse가 딕셔너리 다시 로드를 시도합니다(`invalidate&#95;query`가 설정된 경우 변경되었을 때만 시도). 초 단위로 설정됩니다.
* `lifetime_max` ([UInt64](/ko/reference/data-types/index)) — 메모리 내 딕셔너리의 최대 lifetime입니다. 이 시간이 지나면 ClickHouse가 딕셔너리 다시 로드를 시도합니다(`invalidate&#95;query`가 설정된 경우 변경되었을 때만 시도). 초 단위로 설정됩니다.
* `loading_start_time` ([DateTime](/ko/reference/data-types/index)) — 딕셔너리 로드를 시작한 시각입니다.
* `last_successful_update_time` ([DateTime](/ko/reference/data-types/index)) — 딕셔너리 로드 또는 업데이트가 완료된 시각입니다. 딕셔너리 소스 관련 문제를 모니터링하고 원인을 조사하는 데 도움이 됩니다.
* `error_count` ([UInt64](/ko/reference/data-types/index)) — 마지막으로 성공적으로 로드된 이후 발생한 오류 수입니다. 딕셔너리 소스 관련 문제를 모니터링하고 원인을 조사하는 데 도움이 됩니다.
* `loading_duration` ([Float32](/ko/reference/data-types/index)) — 딕셔너리 로드에 걸린 시간입니다.
* `last_exception` ([String](/ko/reference/data-types/index)) — 딕셔너리를 생성할 수 없는 경우, 딕셔너리를 생성하거나 다시 로드할 때 발생한 오류 텍스트입니다.
* `comment` ([String](/ko/reference/data-types/index)) — 딕셔너리에 대한 설명 텍스트입니다.

<div id="example">
  ## 예시
</div>

딕셔너리를 구성하세요:

```sql theme={null}
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';
```

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

```sql theme={null}
SELECT * FROM system.dictionaries LIMIT 1 FORMAT Vertical;
```

```text theme={null}
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
```