> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-fix-nav-issues.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
> 包含服务器已知各个表元数据的系统表。
# system.tables
## 描述
包含服务器所知晓的每个表的元数据。
[Detached](/zh/reference/statements/detach) 表不会显示在 `system.tables` 中。
[临时表](/zh/reference/statements/create/table#temporary-tables) 仅在创建它们的那些会话的 `system.tables` 中可见。它们的 `database` field 为空，且 `is_temporary` 标志已启用。
## 列
* `database` ([String](/zh/reference/data-types)) — 该表所属数据库的名称。
* `name` ([String](/zh/reference/data-types)) — 表名。
* `uuid` ([UUID](/zh/reference/data-types)) — 表的 uuid (Atomic 数据库) 。
* `engine` ([String](/zh/reference/data-types)) — 表引擎名称 (不含参数) 。
* `is_temporary` ([UInt8](/zh/reference/data-types)) — 用于指示该表是否为临时表的标志。
* `data_paths` ([Array(String)](/zh/reference/data-types)) — 文件系统中的表数据路径。
* `metadata_path` ([String](/zh/reference/data-types)) — 表元数据在文件系统中的路径。
* `metadata_modification_time` ([DateTime](/zh/reference/data-types)) — 表元数据的最后修改时间。
* `metadata_version` ([Int32](/zh/reference/data-types)) — ReplicatedMergeTree 表的元数据版本；非 ReplicatedMergeTree 表的值为 0。
* `dependencies_database` ([Array(String)](/zh/reference/data-types)) — 数据库依赖项。
* `dependencies_table` ([Array(String)](/zh/reference/data-types)) — 表依赖项 (依赖当前表的 materialized views) 。
* `create_table_query` ([String](/zh/reference/data-types)) — 用于创建该表的查询语句。
* `engine_full` ([String](/zh/reference/data-types)) — 表引擎参数。
* `as_select` ([String](/zh/reference/data-types)) — 视图对应的 SELECT 查询。
* `parameterized_view_parameters` ([Array(Tuple(name String, type String))](/zh/reference/data-types)) — 参数化视图所用的参数。
* `partition_key` ([String](/zh/reference/data-types)) — 表中定义的分区键表达式。
* `sorting_key` ([String](/zh/reference/data-types)) — 表中指定的排序键表达式。
* `primary_key` ([String](/zh/reference/data-types)) — 表中指定的主键表达式。
* `sampling_key` ([String](/zh/reference/data-types)) — 表中指定的采样键表达式。
* `unique_key` ([String](/zh/reference/data-types)) — 表中通过 `UNIQUE KEY` 子句指定的唯一键表达式。
* `storage_policy` ([String](/zh/reference/data-types)) — 存储策略。适用于使用 MergeTree 和 Distributed 引擎的表。
* `total_rows` ([Nullable(UInt64)](/zh/reference/data-types)) — 行总数；如果能够快速确定表中的确切行数，则返回该值，否则为 NULL (包括底层 Buffer 表中的行数) 。
* `total_bytes` ([Nullable(UInt64)](/zh/reference/data-types)) — 总字节数；如果能够快速确定该表在存储中的精确字节数，则返回该值，否则返回 NULL (不包括任何底层存储) 。如果该表将数据存储在磁盘上，则返回磁盘上的已用空间 (即压缩后的大小) 。如果该表将数据存储在内存中，则返回内存中已用字节数的近似值。
* `total_bytes_uncompressed` ([Nullable(UInt64)](/zh/reference/data-types)) — 未压缩字节总数；如果能够根据存储中该表的分片校验和快速确定精确的字节数，则为该值，否则为 NULL (不考虑底层存储 (如有) ) 。
* `parts` ([Nullable(UInt64)](/zh/reference/data-types)) — 该表中的 parts 总数。
* `active_parts` ([Nullable(UInt64)](/zh/reference/data-types)) — 此表中处于活动状态的 parts 数量。
* `total_marks` ([Nullable(UInt64)](/zh/reference/data-types)) — 此表中所有 parts 的标记总数。
* `active_on_fly_data_mutations` ([UInt64](/zh/reference/data-types)) — 适合即时应用的活动中数据变更 (UPDATE 和 DELETE) 总数。
* `active_on_fly_alter_mutations` ([UInt64](/zh/reference/data-types)) — 可即时应用的活动 alter 变更 (MODIFY COLUMN) 总数。
* `active_on_fly_metadata_mutations` ([UInt64](/zh/reference/data-types)) — 当前处于活动状态、可即时应用的元数据变更 (RENAME) 总数。
* `columns_descriptions_cache_size` ([UInt64](/zh/reference/data-types)) — \*MergeTree 表的列描述缓存的大小
* `lifetime_rows` ([Nullable(UInt64)](/zh/reference/data-types)) — 自 server 启动以来 INSERT 的总行数 (仅适用于 Buffer 表) 。
* `lifetime_bytes` ([Nullable(UInt64)](/zh/reference/data-types)) — 自服务器启动以来 INSERT 的总字节数 (仅适用于 Buffer 表) 。
* `comment` ([String](/zh/reference/data-types)) — 表的注释。
* `has_own_data` ([UInt8](/zh/reference/data-types)) — 用于指示该表自身是否在磁盘上存储数据，还是仅访问其他源的标志。
* `loading_dependencies_database` ([Array(String)](/zh/reference/data-types)) — 数据库的加载依赖项 (应在当前对象之前加载的对象列表) 。
* `loading_dependencies_table` ([Array(String)](/zh/reference/data-types)) — 表的加载依赖项 (应在当前对象之前加载的对象列表) 。
* `loading_dependent_database` ([Array(String)](/zh/reference/data-types)) — 依赖的数据库加载项。
* `loading_dependent_table` ([Array(String)](/zh/reference/data-types)) — 依赖项加载表。
* `definer` ([String](/zh/reference/data-types)) — 该表使用的 SQL security definer 的名称。
## 示例
```sql theme={null}
SELECT * FROM system.tables LIMIT 2 FORMAT Vertical;
```
```text theme={null}
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
engine_full: MergeTree ORDER BY n
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
engine_full: MergeTree ORDER BY id
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: []
```