メインコンテンツへスキップ
メインコンテンツへスキップ

system.dictionaries

ClickHouse Cloud でのクエリ実行

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

辞書 に関する情報が含まれます。

列:

  • 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 クエリ、タイムアウト、辞書設定の変更）
    • and is being reloaded right now (frequent reasons: SYSTEM RELOAD DICTIONARY query —
    • timeout —
    • dictionary config has changed) —
    • 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 '一時的な辞書';

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

SELECT * FROM system.dictionaries LIMIT 1 FORMAT Vertical;

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:                     一時ディクショナリ