system.tables

サーバーが把握している各テーブルのメタデータを含みます。

Detached テーブルは system.tables に表示されません。

Temporary tables は、それらが作成されたセッションでのみ system.tables に表示されます。これらは空の database フィールドと is_temporary フラグがオンの状態で表示されます。

カラム:

database (String) — テーブルが存在するデータベースの名前。
name (String) — テーブル名。
uuid (UUID) — テーブルの uuid (Atomic database)。
engine (String) — テーブルエンジン名（パラメータなし）。
is_temporary (UInt8) - テーブルが一時的であるかどうかを示すフラグ。
data_paths (Array(String)) - ファイルシステム内のテーブルデータへのパス。
metadata_path (String) - ファイルシステム内のテーブルメタデータへのパス。
metadata_modification_time (DateTime) - テーブルメタデータの最新修正日時。
metadata_version (Int32) - ReplicatedMergeTree テーブルのメタデータバージョン、ReplicatedMergeTree でないテーブルは 0。
dependencies_database (Array(String)) - データベース依存関係。
dependencies_table (Array(String)) - テーブル依存関係 (materialized views 現在のテーブル)。
create_table_query (String) - テーブル作成に使用されたクエリ。
engine_full (String) - テーブルエンジンのパラメータ。
as_select (String) - ビューの SELECT クエリ。
parameterized_view_parameters (Array of Tuple) — パラメータ化されたビューのパラメータ。
partition_key (String) - テーブルに指定されたパーティションキー式。
sorting_key (String) - テーブルに指定されたソートキー式。
primary_key (String) - テーブルに指定された主キー式。
sampling_key (String) - テーブルに指定されたサンプリングキー式。
storage_policy (String) - ストレージポリシー:
- MergeTree
- Distributed
total_rows (Nullable(UInt64)) - 総行数、テーブルの行数がすぐに正確に判定可能な場合はその数を返します。そうでない場合は NULL (含む基になる Buffer テーブル)。
total_bytes (Nullable(UInt64)) - 総バイト数、ストレージ上のテーブルの正確なバイト数をすぐに判定可能な場合はその数を返します。そうでない場合は NULL (基になるストレージは含まれません)。
- テーブルがディスク上にデータを保存する場合、ディスク上の使用スペース（圧縮された状態）を返します。
- テーブルがメモリにデータを保存する場合、メモリ内の使用バイトの近似値を返します。
total_bytes_uncompressed (Nullable(UInt64)) - 総未圧縮バイト数、ストレージ上のテーブルの部分チェックサムからバイト数をすぐに判定可能な場合はその数を返します。そうでない場合は NULL （基になるストレージ（あれば）を考慮しません）。
lifetime_rows (Nullable(UInt64)) - サーバー起動以降に INSERT された行の総数（Buffer テーブルのみ）。
lifetime_bytes (Nullable(UInt64)) - サーバー起動以降に INSERT されたバイトの総数（Buffer テーブルのみ）。
comment (String) - テーブルのコメント。
has_own_data (UInt8) — テーブル自体がディスク上にデータを保存しているか、または他のソースにアクセスするだけかを示すフラグ。
loading_dependencies_database (Array(String)) - データベースの読み込み依存関係（現在のオブジェクトより前に読み込むべきオブジェクトのリスト）。
loading_dependencies_table (Array(String)) - テーブルの読み込み依存関係（現在のオブジェクトより前に読み込むべきオブジェクトのリスト）。
loading_dependent_database (Array(String)) - 依存する読み込みデータベース。
loading_dependent_table (Array(String)) - 依存する読み込みテーブル。

system.tables テーブルは SHOW TABLES クエリの実装で使用されます。

例

SELECT * FROM system.tables LIMIT 2 FORMAT Vertical;

Row 1:
──────
database:                   base
name:                       t1
uuid:                       81b1c20a-b7c6-4116-a2ce-7583fb6b6736
engine:                     MergeTree
is_temporary:               0
data_paths:                 ['/var/lib/clickhouse/store/81b/81b1c20a-b7c6-4116-a2ce-7583fb6b6736/']
metadata_path:              /var/lib/clickhouse/store/461/461cf698-fd0b-406d-8c01-5d8fd5748a91/t1.sql
metadata_modification_time: 2021-01-25 19:14:32
dependencies_database:      []
dependencies_table:         []
create_table_query:         CREATE TABLE base.t1 (`n` UInt64) ENGINE = MergeTree ORDER BY n SETTINGS index_granularity = 8192
engine_full:                MergeTree ORDER BY n SETTINGS index_granularity = 8192
as_select:                  SELECT database AS table_catalog
partition_key:
sorting_key:                n
primary_key:                n
sampling_key:
storage_policy:             default
total_rows:                 1
total_bytes:                99
lifetime_rows:              ᴺᵁᴸᴸ
lifetime_bytes:             ᴺᵁᴸᴸ
comment:
has_own_data:               0
loading_dependencies_database: []
loading_dependencies_table:    []
loading_dependent_database:    []
loading_dependent_table:       []

Row 2:
──────
database:                   default
name:                       53r93yleapyears
uuid:                       00000000-0000-0000-0000-000000000000
engine:                     MergeTree
is_temporary:               0
data_paths:                 ['/var/lib/clickhouse/data/default/53r93yleapyears/']
metadata_path:              /var/lib/clickhouse/metadata/default/53r93yleapyears.sql
metadata_modification_time: 2020-09-23 09:05:36
dependencies_database:      []
dependencies_table:         []
create_table_query:         CREATE TABLE default.`53r93yleapyears` (`id` Int8, `febdays` Int8) ENGINE = MergeTree ORDER BY id SETTINGS index_granularity = 8192
engine_full:                MergeTree ORDER BY id SETTINGS index_granularity = 8192
as_select:                  SELECT name AS catalog_name
partition_key:
sorting_key:                id
primary_key:                id
sampling_key:
storage_policy:             default
total_rows:                 2
total_bytes:                155
lifetime_rows:              ᴺᵁᴸᴸ
lifetime_bytes:             ᴺᵁᴸᴸ
comment:
has_own_data:               0
loading_dependencies_database: []
loading_dependencies_table:    []
loading_dependent_database:    []
loading_dependent_table:       []