system.tables

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

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

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

カラム:

• database (String) — テーブルが存在するデータベースの名前。

• name (String) — テーブル名。

• uuid (UUID) — テーブルのuuid（アトミックデータベース）。

• 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:       []