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

machine_translated	machine_translated_rev	toc_priority	toc_title
true	d734a8e46d	52	システム表

システム表

システムテーブルは、システムの機能の一部を実装し、システムの動作に関する情報へのアクセスを提供するために使用されます。 システムテーブルは削除できません（ただし、デタッチを実行できます）。 システムテーブ サーバーは起動時にすべてのシステムテーブルを作成します。 システムテーブルは読み取り専用です。 彼らはに位置しています ‘system’ データベース

システム。asynchronous_metrics

バックグラウンドで定期的に計算される指標が含まれます。 例えば、使用中のramの量。

列:

• metric (文字列) — Metric name.
• value (Float64) — Metric value.

例えば

SELECT * FROM system.asynchronous_metrics LIMIT 10

┌─metric──────────────────────────────────┬──────value─┐
│ jemalloc.background_thread.run_interval │          0 │
│ jemalloc.background_thread.num_runs     │          0 │
│ jemalloc.background_thread.num_threads  │          0 │
│ jemalloc.retained                       │  422551552 │
│ jemalloc.mapped                         │ 1682989056 │
│ jemalloc.resident                       │ 1656446976 │
│ jemalloc.metadata_thp                   │          0 │
│ jemalloc.metadata                       │   10226856 │
│ UncompressedCacheCells                  │          0 │
│ MarkCacheFiles                          │          0 │
└─────────────────────────────────────────┴────────────┘

また見なさい

• 監視 — Base concepts of ClickHouse monitoring.
• システム。指標 — Contains instantly calculated metrics.
• システム。イベント — Contains a number of events that have occurred.
• システム。metric_log — Contains a history of metrics values from tables system.metrics и system.events.

システム。クラスター

についての情報が含まれてクラスターのコンフィグファイルをサーバーです。

列:

• cluster (String) — The cluster name.
• shard_num (UInt32) — The shard number in the cluster, starting from 1.
• shard_weight (UInt32) — The relative weight of the shard when writing data.
• replica_num (UInt32) — The replica number in the shard, starting from 1.
• host_name (String) — The host name, as specified in the config.
• host_address (String) — The host IP address obtained from DNS.
• port (UInt16) — The port to use for connecting to the server.
• user (String) — The name of the user for connecting to the server.
• errors_count (UInt32)-このホストがレプリカに到達できなかった回数。
• estimated_recovery_time (UInt32)-レプリカエラーカウントがゼロになるまで残された秒数で、正常に戻ったと見なされます。

ご注意ください errors_count クエリごとにクラスターに一度updatedされますが、 estimated_recovery_time オンデマンドで再計算されます。 したがって、ゼロ以外の場合があります errors_count とゼロ estimated_recovery_time、その次のクエリはゼロ errors_count また、エラーがないかのようにreplicaを使用してみてください。

また見なさい

• 分散テーブルエンジン
• distributed_replica_error_cap設定
• distributed_replica_error_half_life設定

システム。列

すべてのテーブルの列に関する情報を含みます。

このテーブルを使用して、次のような情報を取得できます。 DESCRIBE TABLE 一度に複数のテーブルのクエリ。

その system.columns テーブルを含む以下のカラムのカラムタイプはブラケット):

• database (String) — Database name.
• table (String) — Table name.
• name (String) — Column name.
• type (String) — Column type.
• default_kind (String) — Expression type (DEFAULT, MATERIALIZED, ALIAS)デフォルト値の場合、または空の文字列が定義されていない場合。
• default_expression (String) — Expression for the default value, or an empty string if it is not defined.
• data_compressed_bytes (UInt64) — The size of compressed data, in bytes.
• data_uncompressed_bytes (UInt64) — The size of decompressed data, in bytes.
• marks_bytes (UInt64) — The size of marks, in bytes.
• comment (String) — Comment on the column, or an empty string if it is not defined.
• is_in_partition_key (UInt8) — Flag that indicates whether the column is in the partition expression.
• is_in_sorting_key (UInt8) — Flag that indicates whether the column is in the sorting key expression.
• is_in_primary_key (UInt8) — Flag that indicates whether the column is in the primary key expression.
• is_in_sampling_key (UInt8) — Flag that indicates whether the column is in the sampling key expression.

システム。貢献者

を含むに関する情報提供者が保持しています。 ランダムな順序ですべてのconstributors。 順序は、クエリの実行時にランダムです。

列:

• name (String) — Contributor (author) name from git log.

例えば

SELECT * FROM system.contributors LIMIT 10

┌─name─────────────┐
│ Olga Khvostikova │
│ Max Vetrov       │
│ LiuYangkuan      │
│ svladykin        │
│ zamulla          │
│ Šimon Podlipský  │
│ BayoNet          │
│ Ilya Khomutov    │
│ Amy Krishnevsky  │
│ Loud_Scream      │
└──────────────────┘

テーブルで自分自身を見つけるには、クエリを使用します:

SELECT * FROM system.contributors WHERE name='Olga Khvostikova'

┌─name─────────────┐
│ Olga Khvostikova │
└──────────────────┘

システム。データ

このテーブルを含む単一の文字列カラムと呼ばれ ‘name’ – the name of a database. 各データベースのサーバーについて知っていて対応するエントリの表に示す。 このシステム表は実行のために使用されます SHOW DATABASES クエリ。

システム。detached_parts

についての情報が含まれて外部 MergeTree テーブル。 その reason カラムを指定理由の一部でした。 ユーザーがデタッチしたパーツの場合、理由は空です。 このような部品は ALTER TABLE ATTACH PARTITION|PART 司令部 の内容その他のカラムを参照 システム。パーツ. パート名が無効な場合、一部の列の値は次のようになります NULL. このような部分は、 ALTER TABLE DROP DETACHED PART.

システム。辞書

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

列:

• name (String) — Dictionary name.
• type (String) — Dictionary type: Flat, Hashed, Cache.
• origin (String) — Path to the configuration file that describes the dictionary.
• attribute.names (Array(String)) — Array of attribute names provided by the dictionary.
• attribute.types (Array(String)) — Corresponding array of attribute types that are provided by the dictionary.
• has_hierarchy (UInt8) — Whether the dictionary is hierarchical.
• bytes_allocated (UInt64) — The amount of RAM the dictionary uses.
• hit_rate (Float64) — For cache dictionaries, the percentage of uses for which the value was in the cache.
• element_count (UInt64) — The number of items stored in the dictionary.
• load_factor (Float64) — The percentage filled in the dictionary (for a hashed dictionary, the percentage filled in the hash table).
• creation_time (DateTime) — The time when the dictionary was created or last successfully reloaded.
• last_exception (String) — Text of the error that occurs when creating or reloading the dictionary if the dictionary couldn’t be created.
• source (String) — Text describing the data source for the dictionary.

辞書によって使用されるメモリの量は、それに格納されているアイテムの数に比例しないことに注意してください。 くフラットおよびキャッシュされた辞書のすべてのメモリー細胞により、予告なしにご指定済みを問わずどのように辞書を実現する

システム。イベント

システムで発生したイベントの数に関する情報が含まれています。 たとえば、テーブルでは、次のように多くの SELECT ClickHouseサーバーの起動後にクエリが処理されました。

列:

• event (文字列) — Event name.
• value (UInt64) — Number of events occurred.
• description (文字列) — Event description.

例えば

SELECT * FROM system.events LIMIT 5

┌─event─────────────────────────────────┬─value─┬─description────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ Query                                 │    12 │ Number of queries to be interpreted and potentially executed. Does not include queries that failed to parse or were rejected due to AST size limits, quota limits or limits on the number of simultaneously running queries. May include internal queries initiated by ClickHouse itself. Does not count subqueries.                  │
│ SelectQuery                           │     8 │ Same as Query, but only for SELECT queries.                                                                                                                                                                                                                │
│ FileOpen                              │    73 │ Number of files opened.                                                                                                                                                                                                                                    │
│ ReadBufferFromFileDescriptorRead      │   155 │ Number of reads (read/pread) from a file descriptor. Does not include sockets.                                                                                                                                                                             │
│ ReadBufferFromFileDescriptorReadBytes │  9931 │ Number of bytes read from file descriptors. If the file is compressed, this will show the compressed data size.                                                                                                                                              │
└───────────────────────────────────────┴───────┴────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘

また見なさい

• システム。asynchronous_metrics — Contains periodically calculated metrics.
• システム。指標 — Contains instantly calculated metrics.
• システム。metric_log — Contains a history of metrics values from tables system.metrics и system.events.
• 監視 — Base concepts of ClickHouse monitoring.

システム。機能

通常の関数と集計関数に関する情報が含まれます。

列:

• name(String) – The name of the function.
• is_aggregate(UInt8) — Whether the function is aggregate.

システム。graphite_retentions

についての情報が含まれてパラメータ graphite_rollup これは、次の表で使用されます *グラフィットマージツリー エンジン

列:

• config_name (文字列) - graphite_rollup パラメータ名。
• regexp (String)-メトリック名のパターン。
• function (String)-集計関数の名前。
• age (UInt64)-データの最小経過時間(秒)。
• precision （UInt64）-どのように正確に秒単位でデータの年齢を定義します。
• priority (UInt16)-パターンの優先順位。
• is_default (UInt8)-パターンがデフォルトであるかどうか。
• Tables.database (Array(String))-使用するデータベーステーブルの名前の配列 config_name パラメータ。
• Tables.table (Array(String))-使用するテーブル名の配列 config_name パラメータ。

システム。マージ

MergeTreeファミリーのテーブルのマージおよび現在処理中のパーツの変更に関する情報を格納します。

列:

• database (String) — The name of the database the table is in.
• table (String) — Table name.
• elapsed (Float64) — The time elapsed (in seconds) since the merge started.
• progress (Float64) — The percentage of completed work from 0 to 1.
• num_parts (UInt64) — The number of pieces to be merged.
• result_part_name (String) — The name of the part that will be formed as the result of merging.
• is_mutation (UInt8)-1このプロセスが部分突然変異の場合。
• total_size_bytes_compressed (UInt64) — The total size of the compressed data in the merged chunks.
• total_size_marks (UInt64) — The total number of marks in the merged parts.
• bytes_read_uncompressed (UInt64) — Number of bytes read, uncompressed.
• rows_read (UInt64) — Number of rows read.
• bytes_written_uncompressed (UInt64) — Number of bytes written, uncompressed.
• rows_written (UInt64) — Number of rows written.

システム。指標

瞬時に計算されるか、現在の値を持つことができる指標が含まれています。 たとえば、同時に処理されたクエリの数や現在のレプリカの遅延などです。 このテーブルは常に最新です。

列:

• metric (文字列) — Metric name.
• value (Int64) — Metric value.
• description (文字列) — Metric description.

サポートされている指標のリストを以下に示します dbms/Common/CurrentMetrics。cpp ClickHouseのソースファイル。

例えば

SELECT * FROM system.metrics LIMIT 10

┌─metric─────────────────────┬─value─┬─description──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ Query                      │     1 │ Number of executing queries                                                                                                                                                                      │
│ Merge                      │     0 │ Number of executing background merges                                                                                                                                                            │
│ PartMutation               │     0 │ Number of mutations (ALTER DELETE/UPDATE)                                                                                                                                                        │
│ ReplicatedFetch            │     0 │ Number of data parts being fetched from replicas                                                                                                                                                │
│ ReplicatedSend             │     0 │ Number of data parts being sent to replicas                                                                                                                                                      │
│ ReplicatedChecks           │     0 │ Number of data parts checking for consistency                                                                                                                                                    │
│ BackgroundPoolTask         │     0 │ Number of active tasks in BackgroundProcessingPool (merges, mutations, fetches, or replication queue bookkeeping)                                                                                │
│ BackgroundSchedulePoolTask │     0 │ Number of active tasks in BackgroundSchedulePool. This pool is used for periodic ReplicatedMergeTree tasks, like cleaning old data parts, altering data parts, replica re-initialization, etc.   │
│ DiskSpaceReservedForMerge  │     0 │ Disk space reserved for currently running background merges. It is slightly more than the total size of currently merging parts.                                                                     │
│ DistributedSend            │     0 │ Number of connections to remote servers sending data that was INSERTed into Distributed tables. Both synchronous and asynchronous mode.                                                          │
└────────────────────────────┴───────┴──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘

また見なさい

• システム。asynchronous_metrics — Contains periodically calculated metrics.
• システム。イベント — Contains a number of events that occurred.
• システム。metric_log — Contains a history of metrics values from tables system.metrics и system.events.
• 監視 — Base concepts of ClickHouse monitoring.

システム。metric_log

表からのメトリック値の履歴を含む system.metrics と system.events、定期的にディスクにフラッシュ。 メトリック履歴の収集をオンにするには system.metric_log,作成 /etc/clickhouse-server/config.d/metric_log.xml 以下の内容で:

<yandex>
    <metric_log>
        <database>system</database>
        <table>metric_log</table>
        <flush_interval_milliseconds>7500</flush_interval_milliseconds>
        <collect_interval_milliseconds>1000</collect_interval_milliseconds>
    </metric_log>
</yandex>

例えば

SELECT * FROM system.metric_log LIMIT 1 FORMAT Vertical;

Row 1:
──────
event_date:                                                 2020-02-18
event_time:                                                 2020-02-18 07:15:33
milliseconds:                                               554
ProfileEvent_Query:                                         0
ProfileEvent_SelectQuery:                                   0
ProfileEvent_InsertQuery:                                   0
ProfileEvent_FileOpen:                                      0
ProfileEvent_Seek:                                          0
ProfileEvent_ReadBufferFromFileDescriptorRead:              1
ProfileEvent_ReadBufferFromFileDescriptorReadFailed:        0
ProfileEvent_ReadBufferFromFileDescriptorReadBytes:         0
ProfileEvent_WriteBufferFromFileDescriptorWrite:            1
ProfileEvent_WriteBufferFromFileDescriptorWriteFailed:      0
ProfileEvent_WriteBufferFromFileDescriptorWriteBytes:       56
...
CurrentMetric_Query:                                        0
CurrentMetric_Merge:                                        0
CurrentMetric_PartMutation:                                 0
CurrentMetric_ReplicatedFetch:                              0
CurrentMetric_ReplicatedSend:                               0
CurrentMetric_ReplicatedChecks:                             0
...

また見なさい

• システム。asynchronous_metrics — Contains periodically calculated metrics.
• システム。イベント — Contains a number of events that occurred.
• システム。指標 — Contains instantly calculated metrics.
• 監視 — Base concepts of ClickHouse monitoring.

システム。数字

このテーブルを一uint64カラム名 ‘number’ ゼロから始まるほぼすべての自然数が含まれています。 このテーブルをテストに使用するか、ブルートフォース検索を実行する必要がある場合に使用できます。 この表からの読み取りは並列化されません。

システム。numbers_mt

同じように ‘system.numbers’ しかし、読み込みは平行です。 数字は任意の順序で返すことができます。 使用試験までを実施。

システム。ワン

このテーブルには、単一行と単一行が含まれます ‘dummy’ 値を含むUInt8列0. このテーブルは、selectクエリがfrom句を指定しない場合に使用されます。 これは、他のdbmsで見つかったデュアルテーブルに似ています。

システム。パーツ

の部分に関する情報が含まれます MergeTree テーブル。

各行は、一つのデータ部分を記述します。

列:

• partition (String) – The partition name. To learn what a partition is, see the description of the ALTER クエリ。

  形式:

  • YYYYMM 月別の自動パーティション分割の場合。
  • any_string 手動で分割する場合。

• name (String) – Name of the data part.

• active (UInt8) – Flag that indicates whether the data part is active. If a data part is active, it’s used in a table. Otherwise, it’s deleted. Inactive data parts remain after merging.

• marks (UInt64) – The number of marks. To get the approximate number of rows in a data part, multiply marks インデックスの粒度（通常は8192）（このヒントは適応的な粒度では機能しません）。

• rows (UInt64) – The number of rows.

• bytes_on_disk (UInt64) – Total size of all the data part files in bytes.

• data_compressed_bytes (UInt64) – Total size of compressed data in the data part. All the auxiliary files (for example, files with marks) are not included.

• data_uncompressed_bytes (UInt64) – Total size of uncompressed data in the data part. All the auxiliary files (for example, files with marks) are not included.

• marks_bytes (UInt64) – The size of the file with marks.

• modification_time (DateTime) – The time the directory with the data part was modified. This usually corresponds to the time of data part creation.|

• remove_time (DateTime) – The time when the data part became inactive.

• refcount (UInt32) – The number of places where the data part is used. A value greater than 2 indicates that the data part is used in queries or merges.

• min_date (Date) – The minimum value of the date key in the data part.

• max_date (Date) – The maximum value of the date key in the data part.

• min_time (DateTime) – The minimum value of the date and time key in the data part.

• max_time(DateTime) – The maximum value of the date and time key in the data part.

• partition_id (String) – ID of the partition.

• min_block_number (UInt64) – The minimum number of data parts that make up the current part after merging.

• max_block_number (UInt64) – The maximum number of data parts that make up the current part after merging.

• level (UInt32) – Depth of the merge tree. Zero means that the current part was created by insert rather than by merging other parts.

• data_version (UInt64) – Number that is used to determine which mutations should be applied to the data part (mutations with a version higher than data_version).

• primary_key_bytes_in_memory (UInt64) – The amount of memory (in bytes) used by primary key values.

• primary_key_bytes_in_memory_allocated (UInt64) – The amount of memory (in bytes) reserved for primary key values.

• is_frozen (UInt8) – Flag that shows that a partition data backup exists. 1, the backup exists. 0, the backup doesn’t exist. For more details, see FREEZE PARTITION

• database (String) – Name of the database.

• table (String) – Name of the table.

• engine (String) – Name of the table engine without parameters.

• path (String) – Absolute path to the folder with data part files.

• disk (String) – Name of a disk that stores the data part.

• hash_of_all_files (String) – サイファシー128 圧縮されたファイルの。

• hash_of_uncompressed_files (String) – サイファシー128 非圧縮ファイル(マーク付きファイル、インデックスファイルなど)).

• uncompressed_hash_of_compressed_files (String) – サイファシー128 圧縮されていないかのように圧縮されたファイル内のデータ。

• bytes (UInt64) – Alias for bytes_on_disk.

• marks_size (UInt64) – Alias for marks_bytes.

システム。part_log

その system.part_log テーブルが作成されるのは、 part_log サーバー設定を指定します。

このテーブルには、 データ部品 で MergeTree データの追加やマージなどのファミリテーブル。

その system.part_log テーブルを含む以下のカラム:

• event_type (Enum) — Type of the event that occurred with the data part. Can have one of the following values:
  • NEW_PART — Inserting of a new data part.
  • MERGE_PARTS — Merging of data parts.
  • DOWNLOAD_PART — Downloading a data part.
  • REMOVE_PART — Removing or detaching a data part using DETACH PARTITION.
  • MUTATE_PART — Mutating of a data part.
  • MOVE_PART — Moving the data part from the one disk to another one.
• event_date (Date) — Event date.
• event_time (DateTime) — Event time.
• duration_ms (UInt64) — Duration.
• database (String) — Name of the database the data part is in.
• table (String) — Name of the table the data part is in.
• part_name (String) — Name of the data part.
• partition_id (String) — ID of the partition that the data part was inserted to. The column takes the ‘all’ パーティション分割が tuple().
• rows (UInt64) — The number of rows in the data part.
• size_in_bytes (UInt64) — Size of the data part in bytes.
• merged_from (Array(String)) — An array of names of the parts which the current part was made up from (after the merge).
• bytes_uncompressed (UInt64) — Size of uncompressed bytes.
• read_rows (UInt64) — The number of rows was read during the merge.
• read_bytes (UInt64) — The number of bytes was read during the merge.
• error (UInt16) — The code number of the occurred error.
• exception (String) — Text message of the occurred error.

その system.part_log テーブルは、最初にデータを挿入した後に作成されます。 MergeTree テーブル。

システム。プロセス

このシステム表は実行のために使用されます SHOW PROCESSLIST クエリ。

列:

• user (String) – The user who made the query. Keep in mind that for distributed processing, queries are sent to remote servers under the default ユーザー。 このフィールドには、特定のクエリのユーザー名が含まれています。
• address (String) – The IP address the request was made from. The same for distributed processing. To track where a distributed query was originally made from, look at system.processes クエリリクエスターサーバーです。
• elapsed (Float64) – The time in seconds since request execution started.
• rows_read (UInt64) – The number of rows read from the table. For distributed processing, on the requestor server, this is the total for all remote servers.
• bytes_read (UInt64) – The number of uncompressed bytes read from the table. For distributed processing, on the requestor server, this is the total for all remote servers.
• total_rows_approx (UInt64) – The approximation of the total number of rows that should be read. For distributed processing, on the requestor server, this is the total for all remote servers. It can be updated during request processing, when new sources to process become known.
• memory_usage (UInt64) – Amount of RAM the request uses. It might not include some types of dedicated memory. See the max_memory_usage 設定。
• query (String) – The query text. For INSERT、それは挿入するデータが含まれていません。
• query_id (String) – Query ID, if defined.

システム。text_log

ログエントリを含む。 この表に行くロギングのレベルはで限られます text_log.level サーバー設定。

列:

• event_date (Date)-エントリの日付。
• event_time (DateTime）-エントリの時間。
• microseconds (UInt32)-エントリのマイクロ秒。
• thread_name (String) — Name of the thread from which the logging was done.
• thread_id (UInt64) — OS thread ID.
• level (Enum8)-エントリーレベル。
  • 'Fatal' = 1
  • 'Critical' = 2
  • 'Error' = 3
  • 'Warning' = 4
  • 'Notice' = 5
  • 'Information' = 6
  • 'Debug' = 7
  • 'Trace' = 8
• query_id (String)-クエリのID。
• logger_name (LowCardinality(String)) - Name of the logger (i.e. DDLWorker)
• message (String)-メッセージそのもの。
• revision (UInt32)-ClickHouseリビジョン.
• source_file (LowCardinality(String))-ロギングが行われたソースファイル。
• source_line (UInt64)-ロギングが行われたソースライン。

システム。クエリーログ

クエリの実行に関する情報が含まれます。 各クエリについて、処理の開始時間、処理時間、エラーメッセージおよびその他の情報を確認できます。

!!! note "メモ" テーブルには以下の入力データは含まれません INSERT クエリ。

ClickHouseはこのテーブルを作成します。 クエリーログ サーバパラメータを指定します。 このパラメーターは、ロギング間隔やクエリがログに記録されるテーブルの名前などのロギングルールを設定します。

するクエリのロギングの設定を log_queries 1へのパラメータ。 詳細については、 設定 セクション。

その system.query_log テーブルレジスタ二種類のクエリ:

1. クライアントによって直接実行された初期クエリ。
2. 他のクエリによって開始された子クエリ(分散クエリ実行用)。 これらのタイプのクエリについては、親クエリに関する情報が表示されます。 initial_* 列。

列:

• type (Enum8) — Type of event that occurred when executing the query. Values:
  • 'QueryStart' = 1 — Successful start of query execution.
  • 'QueryFinish' = 2 — Successful end of query execution.
  • 'ExceptionBeforeStart' = 3 — Exception before the start of query execution.
  • 'ExceptionWhileProcessing' = 4 — Exception during the query execution.
• event_date (Date) — Query starting date.
• event_time (DateTime) — Query starting time.
• query_start_time (DateTime) — Start time of query execution.
• query_duration_ms (UInt64) — Duration of query execution.
• read_rows (UInt64) — Number of read rows.
• read_bytes (UInt64) — Number of read bytes.
• written_rows (UInt64) — For INSERT クエリ、書き込まれた行の数。 他のクエリの場合、列の値は0です。
• written_bytes (UInt64) — For INSERT クエリ、書き込まれたバイト数。 他のクエリの場合、列の値は0です。
• result_rows (UInt64) — Number of rows in the result.
• result_bytes (UInt64) — Number of bytes in the result.
• memory_usage (UInt64) — Memory consumption by the query.
• query (String) — Query string.
• exception (String) — Exception message.
• stack_trace (String) — Stack trace (a list of methods called before the error occurred). An empty string, if the query is completed successfully.
• is_initial_query (UInt8) — Query type. Possible values:
  • 1 — Query was initiated by the client.
  • 0 — Query was initiated by another query for distributed query execution.
• user (String) — Name of the user who initiated the current query.
• query_id (String) — ID of the query.
• address (IPv6) — IP address that was used to make the query.
• port (UInt16) — The client port that was used to make the query.
• initial_user (String) — Name of the user who ran the initial query (for distributed query execution).
• initial_query_id (String) — ID of the initial query (for distributed query execution).
• initial_address (IPv6) — IP address that the parent query was launched from.
• initial_port (UInt16) — The client port that was used to make the parent query.
• interface (UInt8) — Interface that the query was initiated from. Possible values:
  • 1 — TCP.
  • 2 — HTTP.
• os_user (String) — OS’s username who runs クリックハウス-顧客.
• client_hostname (String) — Hostname of the client machine where the クリックハウス-顧客 または他のTCPクライアントが実行されます。
• client_name (String) — The クリックハウス-顧客 または別のTCPクライアント名。
• client_revision (UInt32) — Revision of the クリックハウス-顧客 または別のTCPクライアント。
• client_version_major (UInt32) — Major version of the クリックハウス-顧客 または別のTCPクライアント。
• client_version_minor (UInt32) — Minor version of the クリックハウス-顧客 または別のTCPクライアント。
• client_version_patch (UInt32) — Patch component of the クリックハウス-顧客 または別のTCPクライアン
• http_method (UInt8) — HTTP method that initiated the query. Possible values:
  • 0 — The query was launched from the TCP interface.
  • 1 — GET 方法を用いた。
  • 2 — POST 方法を用いた。
• http_user_agent (String) — The UserAgent HTTP要求で渡されるヘッダー。
• quota_key (String) — The “quota key” で指定される クォータ 設定（参照 keyed).
• revision (UInt32) — ClickHouse revision.
• thread_numbers (Array(UInt32)) — Number of threads that are participating in query execution.
• ProfileEvents.Names (Array(String)) — Counters that measure different metrics. The description of them could be found in the table システム。イベント
• ProfileEvents.Values (Array(UInt64)) — Values of metrics that are listed in the ProfileEvents.Names コラム
• Settings.Names (Array(String)) — Names of settings that were changed when the client ran the query. To enable logging changes to settings, set the log_query_settings 1へのパラメータ。
• Settings.Values (Array(String)) — Values of settings that are listed in the Settings.Names コラム

それぞれのクエリでは、次の行が作成されます。 query_log クエリのステータスに応じたテーブル:

1. クエリの実行が成功すると、タイプ1とタイプ2のイベントが作成されます。 type 列）。
2. クエリ処理中にエラーが発生した場合は、タイプ1とタイプ4のイベントが作成されます。
3. クエリを起動する前にエラーが発生した場合は、タイプ3の単一のイベントが作成されます。

デフォルトでは、7.5秒間隔でログがテーブルに追加されます。 この間隔を設定することができます クエリーログ サーバー設定（参照してください flush_interval_milliseconds パラメータ）。 フラッシュを強制的にログからのメモリバッファ、テーブルを使用 SYSTEM FLUSH LOGS クエリ。

テーブルが手動で削除されると、その場で自動的に作成されます。 以前のログはすべて削除されることに注意してください。

!!! note "メモ" ログの保存期間は無制限です。 ログはテーブルから自動的に削除されません。 古いログの削除を自分で整理する必要があります。

任意のパーティション分割キーを指定できます。 system.query_log のテーブル クエリーログ サーバー設定（参照してください partition_by パラメータ）。

システム。query_thread_log

のテーブルについての情報が含まれてそれぞれの検索キーワード実行スレッド.

ClickHouseはこのテーブルを作成します。 query_thread_log サーバパラメータを指定します。 このパラメーターは、ロギング間隔やクエリがログに記録されるテーブルの名前などのロギングルールを設定します。

するクエリのロギングの設定を log_query_threads 1へのパラメータ。 詳細については、 設定 セクション。

列:

• event_date (Date) — the date when the thread has finished execution of the query.
• event_time (DateTime) — the date and time when the thread has finished execution of the query.
• query_start_time (DateTime) — Start time of query execution.
• query_duration_ms (UInt64) — Duration of query execution.
• read_rows (UInt64) — Number of read rows.
• read_bytes (UInt64) — Number of read bytes.
• written_rows (UInt64) — For INSERT クエリ、書き込まれた行の数。 他のクエリの場合、列の値は0です。
• written_bytes (UInt64) — For INSERT クエリ、書き込まれたバイト数。 他のクエリの場合、列の値は0です。
• memory_usage (Int64) — The difference between the amount of allocated and freed memory in context of this thread.
• peak_memory_usage (Int64) — The maximum difference between the amount of allocated and freed memory in context of this thread.
• thread_name (String) — Name of the thread.
• thread_number (UInt32) — Internal thread ID.
• os_thread_id (Int32) — OS thread ID.
• master_thread_id (UInt64) — OS initial ID of initial thread.
• query (String) — Query string.
• is_initial_query (UInt8) — Query type. Possible values:
  • 1 — Query was initiated by the client.
  • 0 — Query was initiated by another query for distributed query execution.
• user (String) — Name of the user who initiated the current query.
• query_id (String) — ID of the query.
• address (IPv6) — IP address that was used to make the query.
• port (UInt16) — The client port that was used to make the query.
• initial_user (String) — Name of the user who ran the initial query (for distributed query execution).
• initial_query_id (String) — ID of the initial query (for distributed query execution).
• initial_address (IPv6) — IP address that the parent query was launched from.
• initial_port (UInt16) — The client port that was used to make the parent query.
• interface (UInt8) — Interface that the query was initiated from. Possible values:
  • 1 — TCP.
  • 2 — HTTP.
• os_user (String) — OS’s username who runs クリックハウス-顧客.
• client_hostname (String) — Hostname of the client machine where the クリックハウス-顧客 または他のTCPクライアントが実行されます。
• client_name (String) — The クリックハウス-顧客 または別のTCPクライアント名。
• client_revision (UInt32) — Revision of the クリックハウス-顧客 または別のTCPクライアント。
• client_version_major (UInt32) — Major version of the クリックハウス-顧客 または別のTCPクライアント。
• client_version_minor (UInt32) — Minor version of the クリックハウス-顧客 または別のTCPクライアント。
• client_version_patch (UInt32) — Patch component of the クリックハウス-顧客 または別のTCPクライアン
• http_method (UInt8) — HTTP method that initiated the query. Possible values:
  • 0 — The query was launched from the TCP interface.
  • 1 — GET 方法を用いた。
  • 2 — POST 方法を用いた。
• http_user_agent (String) — The UserAgent HTTP要求で渡されるヘッダー。
• quota_key (String) — The “quota key” で指定される クォータ 設定（参照 keyed).
• revision (UInt32) — ClickHouse revision.
• ProfileEvents.Names (Array(String)) — Counters that measure different metrics for this thread. The description of them could be found in the table システム。イベント
• ProfileEvents.Values (Array(UInt64)) — Values of metrics for this thread that are listed in the ProfileEvents.Names コラム

デフォルトでは、7.5秒間隔でログがテーブルに追加されます。 この間隔を設定することができます query_thread_log サーバー設定（参照してください flush_interval_milliseconds パラメータ）。 フラッシュを強制的にログからのメモリバッファ、テーブルを使用 SYSTEM FLUSH LOGS クエリ。

テーブルが手動で削除されると、その場で自動的に作成されます。 以前のログはすべて削除されることに注意してください。

!!! note "メモ" ログの保存期間は無制限です。 ログはテーブルから自動的に削除されません。 古いログの削除を自分で整理する必要があります。

任意のパーティション分割キーを指定できます。 system.query_thread_log のテーブル query_thread_log サーバー設定（参照してください partition_by パラメータ）。

システム。trace_log

サンプリングクエリプ

ClickHouseはこのテーブルを作成します trace_log サーバの設定が設定されます。 また、 query_profiler_real_time_period_ns と query_profiler_cpu_time_period_ns 設定は設定する必要があります。

ログを分析するには、以下を使用します addressToLine, addressToSymbol と demangle イントロスペクション関数。

列:

• event_date(日付) — Date of sampling moment.

• event_time(DateTime) — Timestamp of sampling moment.

• revision(UInt32) — ClickHouse server build revision.

  サーバーに接続する場合 clickhouse-client、あなたは次のような文字列が表示されます Connected to ClickHouse server version 19.18.1 revision 54429.. このフィールドには、 revision、しかしない version サーバーの。

• timer_type(Enum8) — Timer type:

  • Real 壁時計の時刻を表します。
  • CPU CPU時間を表します。

• thread_number(UInt32) — Thread identifier.

• query_id(文字列) — Query identifier that can be used to get details about a query that was running from the クエリーログ システムテーブル。

• trace(配列(uint64)) — Stack trace at the moment of sampling. Each element is a virtual memory address inside ClickHouse server process.

例えば

SELECT * FROM system.trace_log LIMIT 1 \G

Row 1:
──────
event_date:    2019-11-15
event_time:    2019-11-15 15:09:38
revision:      54428
timer_type:    Real
thread_number: 48
query_id:      acc4d61f-5bd1-4a3e-bc91-2180be37c915
trace:         [94222141367858,94222152240175,94222152325351,94222152329944,94222152330796,94222151449980,94222144088167,94222151682763,94222144088167,94222151682763,94222144088167,94222144058283,94222144059248,94222091840750,94222091842302,94222091831228,94222189631488,140509950166747,140509942945935]

システム。レプリカ

情報および状況を再現しテーブル在住の地元のサーバーです。 このテーブルは、監視に使用できます。 のテーブルが含まれて行毎に再現*ます。

例えば:

SELECT *
FROM system.replicas
WHERE table = 'visits'
FORMAT Vertical

Row 1:
──────
database:                   merge
table:                      visits
engine:                     ReplicatedCollapsingMergeTree
is_leader:                  1
can_become_leader:          1
is_readonly:                0
is_session_expired:         0
future_parts:               1
parts_to_check:             0
zookeeper_path:             /clickhouse/tables/01-06/visits
replica_name:               example01-06-1.yandex.ru
replica_path:               /clickhouse/tables/01-06/visits/replicas/example01-06-1.yandex.ru
columns_version:            9
queue_size:                 1
inserts_in_queue:           0
merges_in_queue:            1
part_mutations_in_queue:    0
queue_oldest_time:          2020-02-20 08:34:30
inserts_oldest_time:        0000-00-00 00:00:00
merges_oldest_time:         2020-02-20 08:34:30
part_mutations_oldest_time: 0000-00-00 00:00:00
oldest_part_to_get:
oldest_part_to_merge_to:    20200220_20284_20840_7
oldest_part_to_mutate_to:
log_max_index:              596273
log_pointer:                596274
last_queue_update:          2020-02-20 08:34:32
absolute_delay:             0
total_replicas:             2
active_replicas:            2

列:

• database (String)-データベース名
• table (String)-テーブル名
• engine (String)-テーブルエンジン名
• is_leader (UInt8)-レプリカがリーダーであるかどうか。 リーダーは一度にひとつのレプリカのみです。 リーダーは実行するバックグラウンドマージの選択を担当します。 書き込みは、リーダーであるかどうかにかかわらず、利用可能であり、zkにセッションを持つ任意のレプリカに対して実行できます。
• can_become_leader (UInt8)-レプリカをリーダーとして選出できるかどうか。
• is_readonly (UInt8)-レプリカが読み取り専用モードであるかどうか。 このモードは、zookeeperでセッションを再初期化するときに不明なエラーが発生した場合、およびzookeeperでのセッション再初期化中に、zookeeperとのセクションが設定さ
• is_session_expired (UInt8)-ZooKeeperとのセッションが終了しました。 基本的には is_readonly.
• future_parts (UInt32)-まだ行われていない挿入またはマージの結果として表示されるデータパーツの数。
• parts_to_check (UInt32)-検証のためのキュー内のデータパーツの数。 破損している可能性があるという疑いがある場合、部品は検証キューに入れられます。
• zookeeper_path (String)-ZooKeeperのテーブルデータへのパス。
• replica_name (String）-飼育係のレプリカ名。 異なるレプリカと同じテーブルの異名をとります。
• replica_path (String）-飼育係のレプリカデータへのパス。 連結と同じです ‘zookeeper_path/replicas/replica_path’.
• columns_version (Int32)-テーブル構造のバージョン番号。 ALTERが実行された回数を示します。 場合にレプリカは異なるバージョンで一部のレプリカさんのすべての変更はまだない。
• queue_size (UInt32)-実行待ち操作のキューのサイズ。 業務などのブロックを挿入し、データ統合し、行動します。 それは通常 future_parts.
• inserts_in_queue (UInt32)-作成する必要があるデータブロックの挿入数。 挿入は、通常、かなり迅速に複製されます。 この数が大きい場合は、何かが間違っていることを意味します。
• merges_in_queue (UInt32)-作成されるのを待機しているマージの数。 マージが時間がかかることがあるので、この値は長い間ゼロより大きくなることがあります。
• part_mutations_in_queue (UInt32）-作られるのを待っている突然変異の数。
• queue_oldest_time (DateTime)-If queue_size 0より大きい場合、最も古い操作がキューに追加された日時が表示されます。
• inserts_oldest_time (DateTime)-見る queue_oldest_time
• merges_oldest_time (DateTime)-見る queue_oldest_time
• part_mutations_oldest_time (DateTime)-見る queue_oldest_time

次の4列は、zkとのアクティブなセッションがある場合にのみ、ゼロ以外の値を持ちます。

• log_max_index (UInt64）-一般的な活動のログの最大エントリ番号。
• log_pointer (UInt64)-レプリカが実行キューにコピーした一般的なアクティビティのログの最大エントリ番号。 もし log_pointer はるかに小さいよりも log_max_index、何かが間違っている。
• last_queue_update (DateTime）-キューが前回updatedされたとき。
• absolute_delay (UInt64）-どのように大きな遅れ秒で現在のレプリカがあります。
• total_replicas (UInt8)-このテーブルの既知のレプリカの総数。
• active_replicas (UInt8）-ZooKeeperでセッションを持つこのテーブルのレプリカの数（つまり、機能するレプリカの数）。

希望される場合は、すべての列は、テーブルが少しゆっくりと、くつかの読み込みから飼育係したがって行います。 最後の4列（log_max_index、log_pointer、total_replicas、active_replicas）を要求しないと、テーブルはすぐに動作します。

たとえば、次のようにすべてが正常に動作していることを確認できます:

SELECT
    database,
    table,
    is_leader,
    is_readonly,
    is_session_expired,
    future_parts,
    parts_to_check,
    columns_version,
    queue_size,
    inserts_in_queue,
    merges_in_queue,
    log_max_index,
    log_pointer,
    total_replicas,
    active_replicas
FROM system.replicas
WHERE
       is_readonly
    OR is_session_expired
    OR future_parts > 20
    OR parts_to_check > 10
    OR queue_size > 20
    OR inserts_in_queue > 10
    OR log_max_index - log_pointer > 10
    OR total_replicas < 2
    OR active_replicas < total_replicas

このクエリが何も返さない場合は、すべてが正常であることを意味します。

システム。設定

現在使用中の設定に関する情報が含まれます。 つまり、システムからの読み取りに使用しているクエリを実行するために使用されます。設定テーブル.

列:

• name (String) — Setting name.
• value (String) — Setting value.
• description (String) — Setting description.
• type (String) — Setting type (implementation specific string value).
• changed (UInt8) — Whether the setting was explicitly defined in the config or explicitly changed.
• min (Nullable(String)) — Get minimum allowed value (if any is set via 制約).
• max (Nullable(String)) — Get maximum allowed value (if any is set via 制約).
• readonly (UInt8) — Can user change this setting (for more info, look into 制約).

例えば:

SELECT name, value
FROM system.settings
WHERE changed

┌─name───────────────────┬─value───────┐
│ max_threads            │ 8           │
│ use_uncompressed_cache │ 0           │
│ load_balancing         │ random      │
│ max_memory_usage       │ 10000000000 │
└────────────────────────┴─────────────┘

システム。merge_tree_settings

についての情報が含まれて設定 MergeTree テーブル。

列:

• name (String) — Setting name.
• value (String) — Setting value.
• description (String) — Setting description.
• type (String) — Setting type (implementation specific string value).
• changed (UInt8) — Whether the setting was explicitly defined in the config or explicitly changed.

システム。table_engines

を含むの記述のテーブルエンジンをサポートサーバーとその特徴を支援す。

このテーブル以下のカラムのカラムタイプはブラケット):

• name (String) — The name of table engine.
• supports_settings (UInt8) — Flag that indicates if table engine supports SETTINGS 句。
• supports_skipping_indices (UInt8) — Flag that indicates if table engine supports 索引のスキップ.
• supports_ttl (UInt8) — Flag that indicates if table engine supports TTL.
• supports_sort_order (UInt8) — Flag that indicates if table engine supports clauses PARTITION_BY, PRIMARY_KEY, ORDER_BY と SAMPLE_BY.
• supports_replication (UInt8) — Flag that indicates if table engine supports データ複製.
• supports_duduplication (UInt8) — Flag that indicates if table engine supports data deduplication.

例えば:

SELECT *
FROM system.table_engines
WHERE name in ('Kafka', 'MergeTree', 'ReplicatedCollapsingMergeTree')

┌─name──────────────────────────┬─supports_settings─┬─supports_skipping_indices─┬─supports_sort_order─┬─supports_ttl─┬─supports_replication─┬─supports_deduplication─┐
│ Kafka                         │                 1 │                         0 │                   0 │            0 │                    0 │                      0 │
│ MergeTree                     │                 1 │                         1 │                   1 │            1 │                    0 │                      0 │
│ ReplicatedCollapsingMergeTree │                 1 │                         1 │                   1 │            1 │                    1 │                      1 │
└───────────────────────────────┴───────────────────┴───────────────────────────┴─────────────────────┴──────────────┴──────────────────────┴────────────────────────┘

また見なさい

• マージツリーファミリー クエリ句
• カフカname 設定
• 参加 設定

システム。テーブル

を含むメタデータは各テーブルサーバーに知っています。 デタッチされたテーブルは system.tables.

このテーブル以下のカラムのカラムタイプはブラケット):

• database (String) — The name of the database the table is in.

• name (String) — Table name.

• engine (String) — Table engine name (without parameters).

• is_temporary (UInt8)-テーブルが一時的かどうかを示すフラグ。

• data_path （文字列）-ファイルシステム内のテーブルデータへのパス。

• metadata_path (String)-ファイルシステム内のテーブルメタデータへのパス。

• metadata_modification_time (DateTime)-テーブルメタデータの最新の変更の時刻。

• dependencies_database (Array(String))-データベースの依存関係。

• dependencies_table (Array(String))-テーブルの依存関係 (MaterializedView 現在のテーブルに基づくテーブル)。

• create_table_query (String)-テーブルの作成に使用されたクエリ。

• engine_full (String)-テーブルエンジンのパラメータ。

• partition_key (String)-テーブルで指定されたパーティションキー式。

• sorting_key (String)-テーブルで指定された並べ替えキー式。

• primary_key (String)-テーブルで指定された主キー式。

• sampling_key (String)-テーブルで指定されたサンプリングキー式。

• storage_policy (文字列)-ストレージポリシー:

  • MergeTree
  • 分散

• total_rows (Nullable(UInt64))-テーブル内の正確な行数をすばやく決定できる場合は、行の総数。 Null （含むunderying Buffer テーブル）。

• total_bytes (Nullable(UInt64))-ストレージ上のテーブルの正確なバイト数を迅速に決定できる場合は、合計バイト数。 Null (しない を含みます)。

  • If the table stores data on disk, returns used space on disk (i.e. compressed).
  • テーブルがメモリにデータを格納する場合,メモリ内の使用バイトの近似数を返します.

その system.tables テーブルは SHOW TABLES クエリの実装。

システム。zookeeper

ZooKeeperが設定されていない場合、テーブルは存在しません。 できるデータを読み込んで飼育係クラスタで定義され、config. クエリには次のものが必要です ‘path’ WHERE句の等価条件です。 これは、データを取得したい子供のためのZooKeeperのパスです。

クエリ SELECT * FROM system.zookeeper WHERE path = '/clickhouse' すべての子のデータを出力します。 /clickhouse ノード すべてのルートノードのデータを出力するには、path= ‘/’. で指定されたパスの場合 ‘path’ 存在しない場合、例外がスローされます。

列:

• name (String) — The name of the node.
• path (String) — The path to the node.
• value (String) — Node value.
• dataLength (Int32) — Size of the value.
• numChildren (Int32) — Number of descendants.
• czxid (Int64) — ID of the transaction that created the node.
• mzxid (Int64) — ID of the transaction that last changed the node.
• pzxid (Int64) — ID of the transaction that last deleted or added descendants.
• ctime (DateTime) — Time of node creation.
• mtime (DateTime) — Time of the last modification of the node.
• version (Int32) — Node version: the number of times the node was changed.
• cversion (Int32) — Number of added or removed descendants.
• aversion (Int32) — Number of changes to the ACL.
• ephemeralOwner (Int64) — For ephemeral nodes, the ID of the session that owns this node.

例えば:

SELECT *
FROM system.zookeeper
WHERE path = '/clickhouse/tables/01-08/visits/replicas'
FORMAT Vertical

Row 1:
──────
name:           example01-08-1.yandex.ru
value:
czxid:          932998691229
mzxid:          932998691229
ctime:          2015-03-27 16:49:51
mtime:          2015-03-27 16:49:51
version:        0
cversion:       47
aversion:       0
ephemeralOwner: 0
dataLength:     0
numChildren:    7
pzxid:          987021031383
path:           /clickhouse/tables/01-08/visits/replicas

Row 2:
──────
name:           example01-08-2.yandex.ru
value:
czxid:          933002738135
mzxid:          933002738135
ctime:          2015-03-27 16:57:01
mtime:          2015-03-27 16:57:01
version:        0
cversion:       37
aversion:       0
ephemeralOwner: 0
dataLength:     0
numChildren:    7
pzxid:          987021252247
path:           /clickhouse/tables/01-08/visits/replicas

システム。突然変異

のテーブルについての情報が含まれて 突然変異 マージツリーテーブルとその進捗状況の。 各突然変異コマンドは、単一の行で表されます。 テーブルには次の列があります:

データ, テーブル -突然変異が適用されたデータベースとテーブルの名前。

mutation_id -変異のID。 のための複製のテーブルこのIdに対応すznode名の <table_path_in_zookeeper>/mutations/ ZooKeeperのディレクトリ。 複雑でないテーブルの場合、Idはテーブルのデータディレクトリ内のファイル名に対応します。

コマンド -突然変異コマンド文字列（後のクエリの一部 ALTER TABLE [db.]table).

create_time -この突然変異コマンドが実行のために提出されたとき。

ブロック番号。partition_id, ブロック番号。番号 -入れ子になった列。 つまり、パーティションIDと、そのパーティションの変更によって取得されたブロック番号より小さい数のブロックを含むパーティションのみが変更さ 非複製のテーブル、ブロック番号の全ての仕切りがひとつのシーケンスです。 こないということを意味している変異体再現し、テーブルの列として展開しているのが記録するとともにシングルブロック番号の取得による突然変異が原因です。

parts_to_do -突然変異が終了するために突然変異する必要があるデータ部分の数。

is_done -変異は終わったのか？ たとえそうであっても parts_to_do = 0 レプリケートされたテーブルの変更は、変更する必要のある新しいデータ部分を作成する実行時間の長いINSERTのためにまだ行われていない可能性があり

一部の部分の変更に問題があった場合、次の列には追加情報が含まれています:

latest_failed_part -突然変異できなかった最新の部分の名前。

latest_fail_time -最も最近の部分変異失敗の時間。

latest_fail_reason -最も最近の部分の突然変異の失敗を引き起こした例外メッセージ。

システム。ディスク

についての情報が含まれてディスクの定義に サーバー構成.

列:

• name (文字列) — Name of a disk in the server configuration.
• path (文字列) — Path to the mount point in the file system.
• free_space (UInt64) — Free space on disk in bytes.
• total_space (UInt64) — Disk volume in bytes.
• keep_free_space (UInt64) — Amount of disk space that should stay free on disk in bytes. Defined in the keep_free_space_bytes ディスク構成のパラメータ。

システム。ストレージ_policies

についての情報が含まれて保管方針の量を定義する サーバー構成.

列:

• policy_name (文字列) — Name of the storage policy.
• volume_name (文字列) — Volume name defined in the storage policy.
• volume_priority (UInt64) — Volume order number in the configuration.
• disks (配列(文字列)) — Disk names, defined in the storage policy.
• max_data_part_size (UInt64) — Maximum size of a data part that can be stored on volume disks (0 — no limit).
• move_factor (Float64) — Ratio of free disk space. When the ratio exceeds the value of configuration parameter, ClickHouse start to move data to the next volume in order.

ストレージポリシーに複数のボリュームが含まれている場合、各ボリュームの情報はテーブルの個々の行に格納されます。

元の記事