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) - テーブルが一時的であるかどうかを示すフラグ。 -
metadata_path
(String) - ファイルシステム内のテーブルメタデータへのパス。 -
metadata_modification_time
(DateTime) - テーブルメタデータの最新修正日時。 -
metadata_version
(Int32) - ReplicatedMergeTree テーブルのメタデータバージョン、ReplicatedMergeTree でないテーブルは 0。 -
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) - ストレージポリシー: -
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)) - 依存する読み込みデータベース。
system.tables
テーブルは SHOW TABLES
クエリの実装で使用されます。
例