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)) - 自服务器启动以来插入的总行数（仅适用于 Buffer 表）。

• lifetime_bytes (Nullable(UInt64)) - 自服务器启动以来插入的总字节数（仅适用于 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 查询的实现。

示例