跳到主要内容
跳到主要内容

系统表

页面说明
系统表概览概述系统表是什么以及它们为何有用。
INFORMATION_SCHEMA提供一个几乎标准化、与 DBMS 无关的数据库对象元数据视图的系统数据库。
system.asynchronous_insert_log包含异步插入相关信息的系统表。每条记录对应一条已缓冲用于异步执行的插入查询。
system.asynchronous_inserts包含队列中待处理的异步插入信息的系统表。
system.asynchronous_loader一张系统表，包含最近异步作业（例如正在加载的表）的信息和状态。该表中每个作业对应一行。
system.asynchronous_metric_log包含 system.asynchronous_metrics 历史值的系统表，这些值按时间间隔保存一次（默认每秒一次）
system.asynchronous_metrics包含在后台定期计算得到的各项指标的系统表，例如当前正在使用的 RAM 使用量。
system.azure_queue_settings包含 AzureQueue 表设置信息的系统表。自服务器 24.10 版本起可用。
system.backup_log包含 BACKUP 和 RESTORE 操作相关日志条目的系统表。
system.backups包含 BACKUP 和 RESTORE 操作相关日志条目的系统表。
system.blob_storage_log包含日志条目的系统表，用于记录各种 blob 存储操作（如上传和删除）的相关信息。
system.build_options包含 ClickHouse 服务器构建选项相关信息的系统表。
system.clusters包含配置文件中可用集群及其中定义的服务器信息的系统表。
system.codecs包含队列中编解码器相关信息的系统表。
system.columns包含所有表各列信息的系统表
system.contributors包含贡献者信息的系统表。
system.crash_log用于存储致命错误堆栈跟踪信息的系统表。
system.current_roles包含当前用户已启用角色的系统表。
system.dashboards包含 /dashboard 页面所使用的查询，该页面可通过 HTTP 接口访问，可用于监控和故障排查。
system.data_skipping_indices包含所有表中现有数据跳过索引信息的系统表。
system.data_type_families包含受支持数据类型相关信息的系统表
system.database_engines包含服务器支持的数据库引擎列表的系统表。
system.database_replicas包含复制型数据库信息及其状态的系统表。
system.databases包含当前用户可用的数据库信息的系统表。
system.dead_letter_queue包含通过流式引擎接收、在解析时发生错误的消息相关信息的系统表。
system.delta_lake_metadata_log包含从 Delta Lake 表读取的元数据文件信息的系统表。每条记录对应一个根级元数据 JSON 文件。
system.detached_parts包含 MergeTree 表中已分离的分区片段相关信息的系统表
system.detached_tables包含各已分离表信息的系统表。
system.dictionaries包含字典信息的系统表
system.dimensional_metrics此表包含可即时计算并以 Prometheus 格式导出的维度指标，且始终保持最新。
system.disks包含服务器配置中已定义磁盘信息的系统表
system.distributed_ddl_queue包含在集群上执行的分布式 DDL 查询信息的系统表（这些查询使用 ON CLUSTER 子句）。
system.distribution_queue包含队列中待发送到各分片的本地文件信息的系统表。
system.dns_cache包含已缓存的 DNS 记录信息的系统表。
system.dropped_tables包含已执行过 DROP TABLE 操作但其数据尚未完成清理的表相关信息的系统表
system.dropped_tables_parts包含 system.dropped_tables 中已删除的 MergeTree 表分区片段信息的系统表
system.enabled_roles系统表，包含当前所有已启用的角色，其中包括当前用户的当前角色，以及为该角色授予的其他角色
system.error_log系统表，用于保存 system.errors 表中的错误值历史记录，并会定期刷写到磁盘。
system.errors记录错误代码及其被触发次数的系统表。
system.events包含系统中各类事件发生次数的系统表。
system.functions包含普通函数和聚合函数信息的系统表。
system.grants用于显示授予各 ClickHouse 用户账号的权限的系统表。
system.graphite_retentions包含 graphite_rollup 参数信息的系统表，这些参数用于 GraphiteMergeTree 类型引擎的表中。
system.histogram_metrics该表包含可实时计算并以 Prometheus 格式导出的直方图指标，并且始终保持最新状态。
system.iceberg_history包含 Iceberg 快照历史记录的系统表
system.iceberg_metadata_log包含从 Iceberg 表中读取的元数据文件相关信息的系统表。每条记录表示一个根级元数据文件、从 Avro 文件中提取的元数据，或某个 Avro 文件中的一个条目。
system.instrumentation包含各插桩点信息的系统表
system.jemalloc_bins包含由 jemalloc 内存分配器在不同大小类别（bin）上的内存分配信息的系统表，这些信息汇总自所有 arena。
system.kafka_consumers包含 Kafka 消费者相关信息的系统表。
system.licenses用于存储 ClickHouse 源码中 contrib 目录下第三方库许可证信息的系统表。
system.merge_tree_settings存储 MergeTree 表设置信息的系统表。
system.merges包含当前正在进行的 MergeTree 系列表数据部件合并和部件变更操作信息的系统表。
system.metric_log系统表，用于保存 system.metrics 和 system.events 表中的指标值历史记录，并会定期将数据刷写到磁盘。
system.metrics包含可即时计算或具有当前值的指标的系统表。
system.moves包含 MergeTree 表当前正在进行的数据分片移动信息的系统表。每次数据分片移动在表中对应一行。
system.mutations包含 MergeTree 表变更操作及其执行进度信息的系统表。每条变更命令在表中对应一行。
system.numbers仅包含一个名为 number 的 UInt64 列的系统表，该列中包含从零开始的几乎所有自然数。
system.numbers_mt类似于 system.numbers 的系统表，但读取是并行化的，返回的数字顺序不固定。
system.one包含仅一行，且只有一个名为 dummy、列值为 0 的 UInt8 列的系统表。类似于其他 DBMS 中的 DUAL 表。
system.opentelemetry_span_log包含已执行查询相关 trace span 信息的系统表。
system.part_log包含 MergeTree 系列表中数据分区片段上发生事件信息的系统表，例如数据的添加或合并。
system.parts包含 MergeTree 表分区片段信息的系统表
system.parts_columns包含 MergeTree 表分区片段及列相关信息的系统表。
system.processes用于实现 SHOW PROCESSLIST 查询的系统表。
system.processors_profile_log包含处理器级性能分析信息的系统表（可在 EXPLAIN PIPELINE 中查看）
system.projection_parts包含 MergeTree 系列表中投影分区片段信息的系统表。
system.projection_parts_columns包含 MergeTree 系列表的投影分区片段中各列信息的系统表
system.projections包含所有表中已存在的 PROJECTION 信息的系统表。
system.query_cache显示查询缓存内容的系统表。
system.query_condition_cache显示查询条件缓存内容的系统表。
system.query_log包含已执行查询相关信息的系统表，例如开始时间、处理时长、错误信息。
system.query_metric_log包含来自 system.events 表的、针对单个查询的内存和指标值历史记录的系统表，并会定期将数据刷新到磁盘。
system.query_thread_log包含执行查询的线程相关信息的系统表，例如线程名称、线程启动时间以及查询处理持续时间。
system.query_views_log包含在执行查询时被触发的依赖视图相关信息的系统表，例如视图类型或执行时间。
system.quota_limits包含所有配额在各个时间区间的最大值信息的系统表。对于一个配额，可以对应任意数量的行，也可以没有行。
system.quota_usage包含当前用户 QUOTA 使用情况信息的系统表，例如已使用了多少 QUOTA，以及还剩多少 QUOTA。
system.quotas包含 QUOTA 相关信息的系统表。
system.quotas_usage包含所有用户 QUOTA 使用情况信息的系统表。
system.replicas包含本地服务器上复制表的相关信息及其状态的系统表，可用于监控。
system.replicated_fetches包含当前正在运行的后台拉取任务信息的系统表。
system.replication_queue包含 ReplicatedMergeTree 系列表在 ClickHouse Keeper 或 ZooKeeper 中存储的复制队列任务信息的系统表。
system.resources包含本地服务器上各资源信息的系统表，每个资源对应一行。
system.role_grants包含针对用户和角色的角色授予信息的系统表。
system.roles包含已配置角色信息的系统表。
system.row_policies一个系统表，用于存储针对某张特定表的过滤条件，以及应应用此 ROW POLICY 的角色和/或用户列表。
system.s3_queue_settings包含 S3Queue 表设置信息的系统表。自服务器 24.10 版本起可用。
system.scheduler包含本地服务器上各调度节点信息及其状态的系统表。
system.schema_inference_cache包含所有已缓存文件 schema 信息的系统表。
system.server_settings包含在 config.xml 中指定的服务器全局设置信息的系统表。
system.session_log包含所有成功和失败的登录与登出事件信息的系统表。
system.settings包含当前用户的会话设置信息的系统表。
system.settings_changes记录历史 ClickHouse 版本中的设置变更信息的系统表。
system.settings_profile_elements用于描述设置配置文件内容的系统表：包括该设置适用的约束、角色和用户，以及父设置配置文件。
system.settings_profiles包含已配置设置配置文件各属性信息的系统表。
system.stack_trace包含所有服务器线程堆栈跟踪信息的系统表。便于开发者检查服务器状态。
system.storage_policies包含服务器配置中定义的存储策略和卷信息的系统表。
system.symbols供 C++ 专家和 ClickHouse 工程师使用的系统表，包含用于自省 clickhouse 二进制可执行文件的信息。
system.table_engines包含服务器所支持的表引擎及其功能说明的系统表。
system.tables包含服务器已知各个表元数据信息的系统表。
system.text_log用于存储日志记录条目的系统表。
system.time_zones包含 ClickHouse 服务器所支持的时区列表的系统表。
system.trace_log包含由查询采样分析器收集的堆栈跟踪信息的系统表。
system.unicode包含 Unicode 字符列表及其属性的系统表。
system.user_processes包含便于概览用户内存使用情况和 ProfileEvents 的信息的系统表。
system.users包含服务器上已配置的用户账号列表的系统表。
system.view_refreshes包含可刷新materialized view 相关信息的系统表。
system.warnings此表包含关于 ClickHouse 服务器的警告信息。
system.workloads包含本地服务器上各工作负载的信息的系统表。
system.zookeeper_connection仅在配置了 ZooKeeper 时才存在的系统表。显示当前到 ZooKeeper 的连接（包括辅助 ZooKeeper 实例）。
system.zookeeper_connection_log显示与 ZooKeeper 连接的历史记录（包括辅助 ZooKeeper 实例）。
system.zookeeper_log包含有关向 ZooKeeper 服务器发起请求的参数及其响应信息的系统表。
system.zookeeper仅在配置了 ClickHouse Keeper 或 ZooKeeper 时才存在的系统表。它提供对配置文件中定义的 Keeper 集群数据的访问。