system.dictionaries

ClickHouse Cloud でのクエリ実行

このシステムテーブルのデータは、ClickHouse Cloud の各ノードにローカルに格納されています。そのため、すべてのデータを包括的に確認するには、clusterAllReplicas 関数を使用する必要があります。詳細についてはこちらを参照してください。

辞書に関する情報を含みます。

列：

• database (String) — DDL クエリによって作成された Dictionary を含むデータベース名。他の Dictionary の場合は空文字列。
• name (String) — Dictionary 名。
• uuid (UUID) — Dictionary の UUID。
• status (Enum8('NOT_LOADED' = 0, 'LOADED' = 1, 'FAILED' = 2, 'LOADING' = 3, 'FAILED_AND_RELOADING' = 4, 'LOADED_AND_RELOADING' = 5, 'NOT_EXIST' = 6)) — Dictionary のステータス。取りうる値:
  • NOT_LOADED — 使用されていないため Dictionary はロードされていない
  • LOADED — Dictionary が正常にロードされた
  • FAILED — エラーにより Dictionary をロードできなかった
  • LOADING — Dictionary をロード中
  • LOADED_AND_RELOADING — Dictionary は正常にロード済み
  • and is being reloaded right now (frequent reasons: SYSTEM RELOAD DICTIONARY query — かつ現在再ロード中 (主な理由: SYSTEM RELOAD DICTIONARY クエリ、
  • timeout — タイムアウト、
  • dictionary config has changed) — Dictionary 設定の変更 など)。
  • FAILED_AND_RELOADING — エラーにより Dictionary をロードできず、現在ロード中。
• origin (String) — Dictionary を記述する設定ファイルへのパス。
• type (String) — Dictionary の割り当て方式。Storing Dictionaries in Memory。
• 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 量。
• hierarchical_index_bytes_allocated (UInt64) — 階層型索引に割り当てられた 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 ソースに関する問題を監視し、その原因を調査するのに役立つ。
• error_count (UInt64) — 直近の正常なロード以降のエラー数。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';

辞書が読み込まれていることを確認してください。

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