ClickHouse/docs/ja/operations/system-tables/dictionaries.md

slug
/ja/operations/system-tables/dictionaries

dictionaries

Dictionaryに関する情報を含んでいます。

カラム:

• database (String) — DDLクエリによって作成されたDictionaryを含むデータベースの名前。他のDictionaryの場合は空文字列。
• name (String) — Dictionary名。
• uuid (UUID) — DictionaryのUUID。
• status (Enum8) — Dictionaryのステータス。可能な値は以下の通りです：
  • NOT_LOADED — 使用されなかったためDictionaryはロードされませんでした。
  • LOADED — Dictionaryが正常にロードされました。
  • FAILED — エラーが原因でDictionaryをロードできませんでした。
  • LOADING — 現在、Dictionaryがロード中です。
  • LOADED_AND_RELOADING — Dictionaryが正常にロードされ、現在リロード中です（頻繁な理由: SYSTEM RELOAD DICTIONARYクエリ、タイムアウト、Dictionary設定の変更）。
  • FAILED_AND_RELOADING — エラーが原因でDictionaryをロードできず、現在ロード中です。
• origin (String) — Dictionaryを記述する設定ファイルへのパス。
• type (String) — Dictionaryの割り当てタイプ。メモリにDictionaryを保存。
• key.names (Array(String)) — Dictionaryによって提供されるキーの名前の配列。
• key.types (Array(String)) — Dictionaryによって提供されるキーのタイプの対応する配列。
• attribute.names (Array(String)) — Dictionaryによって提供される属性の名前の配列。
• attribute.types (Array(String)) — Dictionaryによって提供される属性のタイプの対応する配列。
• bytes_allocated (UInt64) — Dictionaryに割り当てられたRAMの量。
• query_count (UInt64) — Dictionaryのロードまたは最後の正常な再起動以来のクエリの数。
• hit_rate (Float64) — キャッシュDictionaryの場合、キャッシュ内に値があった使用回数の割合。
• found_rate (Float64) — 値が見つかった使用回数の割合。
• element_count (UInt64) — Dictionaryに格納されているアイテムの数。
• load_factor (Float64) — Dictionary （ハッシュベースのDictionaryではハッシュテーブル）の充填率。
• source (String) — Dictionaryのデータソースを説明するテキスト。
• lifetime_min (UInt64) — メモリ内のDictionaryの最小有効期限、この後ClickHouseはDictionaryをリロードしようとします（invalidate_queryが設定されている場合、変わっていればのみ）。秒単位で設定。
• lifetime_max (UInt64) — メモリ内のDictionaryの最大有効期限、この後ClickHouseはDictionaryをリロードしようとします（invalidate_queryが設定されている場合、変わっていればのみ）。秒単位で設定。
• loading_start_time (DateTime) — Dictionaryのロード開始時間。
• last_successful_update_time (DateTime) — Dictionaryのロードまたは更新の終了時間。Dictionaryソースに関連する問題の監視と原因調査に役立ちます。
• loading_duration (Float32) — Dictionaryロードの期間。
• last_exception (String) — Dictionaryを作成またはリロードする際に発生するエラーのテキスト、Dictionaryが作成できなかった場合。
• comment (String) — Dictionaryへのコメントのテキスト。

例

Dictionaryを構成します：

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';

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