跳到主要内容
跳到主要内容

tables

包含服务器所知的每个表的元数据。

分离的 表不会显示在 system.tables 中。

临时表 仅在创建它们的会话中的 system.tables 中可见。它们显示为空的 database 字段,并且 is_temporary 标志已打开。

  • database (String) — 表格所在的数据库名称。

  • name (String) — 表格名称。

  • uuid (UUID) — 表格 uuid (Atomic 数据库).

  • 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)) - 表格依赖项(当前表格的 物化视图)。

  • create_table_query (String) - 用于创建表格的查询。

  • engine_full (String) - 表格引擎的参数。

  • as_select (String) - 视图的 SELECT 查询。

  • 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)) - 依赖加载数据库。

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