system.tables 用于 SHOW TABLES 查询的实现，可用于获取服务器中已知表的元数据。DETACH 表不会显示在 system.tables 中。Temporary tables 仅在创建它的会话（session）中可见于 system.tables 中，且database 字段为空、is_temporary 标志被设置为 1（开启）。
字段名称 | 数据类型 | 字段含义说明 |
|---|---|---|
database | String | 表所在数据库的名称。 |
name | String | 表名。 |
uuid | UUID | Atomic 类型的数据库中每个表的持久化 UUID。 |
engine | String | 表引擎名称（不带参数）。 |
is_temporary | UInt8 | 指示表是否为临时的标志。支持的数值如下：
|
is_readonly | UInt8 | 指示表是否为只读的标志。支持的数值如下：
|
data_paths | Array(String) | 文件系统中表数据的路径。 |
metadata_path | String | 文件系统中表元数据的路径。 |
metadata_modification_time | DateTime | 表元数据的最新修改时间。 |
dependencies_database | Array(String) | 数据库依赖。 |
dependencies_table | Array(String) | 表依赖（当前表的 materialized views）。 |
create_table_query | String | 用于创建表的查询。 |
engine_full | String | 表引擎的参数。 |
update_time | DateTime | 代表了表中的数据上次更新的时间 。如果 Server 启动后数据未修改，则为 Server 启动时 Attach 表的时间。 |
partition_key | String | 表中指定的分区键表达式。 |
sorting_key | String | 表中指定的排序键表达式。 |
primary_key | String | 表中指定的主键表达式。 |
unique_not_enforced | Array(String) | 优化器假设数据为 unique，在插入数据时不检查该数据。 |
foreign_key | Map(String, Tuple(String, String)) | 外键，用于优化器调优。 |
sampling_key | String | 表中指定的采样键表达式。 |
storage_policy | String | 存储策略： |
total_rows | Nullable(UInt64) | 总行数，如果可以快速确定表中行的确切数量，则返回该值，否则返回 |
total_bytes | Nullable(UInt64) | 总字节数，如果可以快速确定存储中表的确切字节数，则返回该值，否则返回
|
lifetime_rows | Nullable(UInt64) | 自服务器启动以来插入的总行数（仅适用于 |
lifetime_bytes | Nullable(UInt64) | 自服务器启动以来插入的总字节数（仅适用于 |
comment | String | 表的注释。 |
user | String | 表的创建人。 说明 ByteHouse 企业版引擎 v2.7 及以上版本支持 user 列。您可通过 ByteHouse 控制台 > 集群列表 > 集群名称 > 基础信息路径，查看引擎版本。 |
SELECT * FROM system.tables where database = 'tpch' and name='lineitem' limit 1 format Vertical;
database: tpch name: lineitem uuid: 00000000-0000-0000-0000-000000000000 engine: MergeTree is_temporary: 0 is_readonly: 0 data_paths: ['/mnt/multi_disk_9000/disk01/clickhouse/data/data/tpch/lineitem/','/mnt/multi_disk_9000/disk02/clickhouse/data/data/tpch/lineitem/','/mnt/multi_disk_9000/disk03/clickhouse/data/data/tpch/lineitem/','/mnt/multi_disk_9000/disk04/clickhouse/data/data/tpch/lineitem/','/mnt/multi_disk_9000/disk05/clickhouse/data/data/tpch/lineitem/','/mnt/multi_disk_9000/disk06/clickhouse/data/data/tpch/lineitem/','/mnt/multi_disk_9000/disk07/clickhouse/data/data/tpch/lineitem/','/mnt/multi_disk_9000/disk08/clickhouse/data/data/tpch/lineitem/'] metadata_path: /mnt/multi_disk_9000/disk01/clickhouse/data/metadata/tpch/lineitem.sql metadata_modification_time: 2025-06-13 21:36:52 dependencies_database: [] dependencies_table: [] create_table_query: CREATE TABLE tpch.lineitem (`l_orderkey` Int32, `l_partkey` Int32, `l_suppkey` Int32, `l_linenumber` Int32, `l_quantity` Decimal(15, 2), `l_extendedprice` Decimal(15, 2), `l_discount` Decimal(15, 2), `l_tax` Decimal(15, 2), `l_returnflag` String, `l_linestatus` String, `l_shipdate` Date, `l_commitdate` Date, `l_receiptdate` Date, `l_shipinstruct` String, `l_shipmode` String, `l_comment` String) ENGINE = MergeTree ORDER BY (l_orderkey, l_linenumber) SETTINGS index_granularity = 8192 engine_full: MergeTree ORDER BY (l_orderkey, l_linenumber) SETTINGS index_granularity = 8192 update_time: 2025-06-13 21:47:34 partition_key: sorting_key: l_orderkey, l_linenumber primary_key: l_orderkey, l_linenumber unique_not_enforced: [] foreign_key: {} sampling_key: storage_policy: default total_rows: 600037902 total_bytes: 28682278543 lifetime_rows: ᴺᵁᴸᴸ lifetime_bytes: ᴺᵁᴸᴸ comment: user: default