メインコンテンツまでスキップ
メインコンテンツまでスキップ

system.dictionaries

ClickHouse Cloud におけるクエリ

このシステムテーブルのデータは、ClickHouse Cloud の各ノードにローカルに保持されています。したがって、すべてのデータの完全なビューを取得するには、clusterAllReplicas 関数が必要です。詳細については こちら を参照してください。

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

カラム:

  • database (String) — DDLクエリによって作成された辞書を含むデータベースの名前。他の辞書の場合は空文字列。
  • name (String) — 辞書の名前.
  • uuid (UUID) — 辞書のUUID。
  • status (Enum8) — 辞書の状態。可能な値:
    • NOT_LOADED — 辞書が使用されなかったため、ロードされませんでした。
    • LOADED — 辞書が正常にロードされました。
    • FAILED — エラーのため、辞書をロードできませんでした。
    • LOADING — 辞書が現在ロード中です。
    • LOADED_AND_RELOADING — 辞書が正常にロードされており、現在再ロード中です(頻繁な理由: SYSTEM RELOAD DICTIONARY クエリ、タイムアウト、辞書の設定が変更されました)。
    • 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の量。
  • 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