tables
包含服务器知道的所有表的元数据。
分离的表不会显示在system.tables
中。
临时表 仅在创建它们的会话中才在system.tables
中可见。它们显示为空的database
字段,并且is_temporary
标志已打开。
列
database
(String) - 表所在的数据库的名称。name
(String) - 表名。uuid
(UUID) - 表 uuid(原子数据库)。engine
(String) - 表引擎名称(不带参数)。is_temporary
(UInt8) - 指示表是否是临时的标志。metadata_path
(String) - 文件系统中表元数据的路径。metadata_modification_time
(DateTime) - 表元数据最后修改的时间。metadata_version
(Int32) - 复制 MergeTree 表的元数据版本,非复制 MergeTree 表为 0。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)) - 服务器启动以来插入的行总数(仅适用于Buffer
表)。lifetime_bytes
(Nullable(UInt64)) - 服务器启动以来插入的字节总数(仅适用于Buffer
表)。comment
(String) - 表的注释。has_own_data
(UInt8) - 指示表本身是否在磁盘上存储一些数据或仅访问其他某些来源的标志。loading_dependencies_database
(Array(String)) - 数据库加载依赖项(应在当前对象之前加载的对象列表)。loading_dependencies_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: []