tables--ByteHouse 企业版-火山引擎

文档中心

ByteHouse 企业版

系统表

tables

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	指示表是否为临时的标志。支持的数值如下： 0：非临时表。 1：临时表。
is_readonly	UInt8	指示表是否为只读的标志。支持的数值如下： 0：表为可读写状态（非只读）。 1：表为只读状态。
data_paths	Array(String)	文件系统中表数据的路径。
metadata_path	String	文件系统中表元数据的路径。
metadata_modification_time	DateTime	表元数据的最新修改时间。
dependencies_database	Array(String)	数据库依赖。
dependencies_table	Array(String)	表依赖（当前表的物化视图）。
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	存储策略： HaMergeTree HaUniqueMergeTree Distributed
total_rows	Nullable(UInt64)	总行数，如果可以快速确定表中行的确切数量，则返回该值，否则返回 `NULL`（包括底层的 `Buffer` 表）。
total_bytes	Nullable(UInt64)	总字节数，如果可以快速确定存储中表的确切字节数，则返回该值，否则返回 `NULL`（不包括任何底层存储）。如果表将数据存储在磁盘上，则返回磁盘上使用的空间（即压缩的）。如果表将数据存储在内存中，则返回使用的字节数的近似值。
lifetime_rows	Nullable(UInt64)	自服务器启动以来插入的总行数（仅适用于 `Buffer` 表）。
lifetime_bytes	Nullable(UInt64)	自服务器启动以来插入的总字节数（仅适用于 `Buffer` 表）。
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

最近更新时间：2025.10.30 10:28:20

这个页面对您有帮助吗？

有用

无用