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

系统表

页面说明
系统表概览系统表是什么，以及它们为何有用的概述。
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 表。
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 表。
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.jemalloc_bins系统表，包含通过 jemalloc 分配器在不同大小类别（bins）中完成的内存分配信息，并聚合自所有 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 表，但读取是并行的，且数字可能以任意顺序返回。
system.one系统表，包含一行记录，该记录只有一个名为 dummy 的 UInt8 列，列值为 0。类似于其他 DBMS 中的 DUAL 表。
system.opentelemetry_span_log包含关于已执行查询的 trace span 信息的系统表。
system.part_log包含 MergeTree 系列表中数据分区片段相关事件信息的 system 表，例如数据新增或合并等操作。
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在运行查询时，包含已执行的依赖 VIEW 相关信息的系统表，例如 VIEW 类型或执行时间。
system.quota_limits包含所有 QUOTA 在各个时间区间最大值信息的 system 表。任意数量的行（包括零行）都可以对应于一个 QUOTA。
system.quota_usage包含当前 USER QUOTA 使用情况的系统表，例如 QUOTA 已使用多少以及剩余多少。
system.quotas存储 QUOTA 信息的系统表。
system.quotas_usage记录所有用户 QUOTA 使用情况的系统表。
system.replicas包含本地服务器上复制表信息及其状态的 system 表，适用于监控。
system.replicated_fetches包含当前正在执行的后台拉取任务信息的系统表。
system.replication_queue包含 ReplicatedMergeTree 系列表在 ClickHouse Keeper 或 ZooKeeper 中复制队列任务信息的系统表。
system.resources包含本地服务器上各资源信息的 system 表，每个资源对应一行。
system.role_grants用于存储授予用户和角色的角色信息的系统表。
system.roles包含已配置角色信息的系统表。
system.row_policies包含某个特定表的过滤器，以及应使用该 ROW POLICY 的角色和/或用户列表的系统表。
system.s3_queue_settings包含 S3Queue 表设置信息的系统表，自服务器版本 24.10 起可用。
system.scheduler包含本地服务器上调度节点相关信息及其状态的系统表。
system.schema_inference_cache包含所有已缓存文件模式信息的系统表。
system.server_settings包含服务器全局设置的系统表，这些设置在 config.xml 中指定。
system.session_log包含所有成功和失败的登录和登出事件信息的系统表。
system.settings包含当前用户会话设置信息的系统表。
system.settings_changes记录先前 ClickHouse 版本中 SETTING 变更信息的系统表。
system.settings_profile_elements用于描述设置配置文件内容的系统表：该设置配置文件适用的约束、角色和用户，以及其父设置配置文件。
system.settings_profiles用于存储已配置设置配置文件属性的系统表。
system.stack_trace包含所有服务器线程堆栈跟踪信息的系统表。允许开发人员检查服务器状态。
system.storage_policies包含有关在服务器配置中定义的存储策略和卷的信息的系统表。
system.symbols适用于 C++ 专家和 ClickHouse 工程师的系统表，包含用于对 clickhouse 可执行文件进行自省的信息。
system.table_engines包含服务器所支持的表引擎及其各自支持特性描述的系统表。
system.tables包含服务器已知的所有表元数据的 system 表。
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仅在配置了 ClickHouse Keeper 或 ZooKeeper 时才存在的系统表。它暴露来自配置文件中定义的 Keeper 集群的数据。
system.zookeeper_connection仅在配置了 ZooKeeper 时才存在的系统表。显示当前与 ZooKeeper 的连接（包括辅助 ZooKeeper 实例）。
system.zookeeper_connection_log显示 ZooKeeper 连接历史（包括辅助 ZooKeeper 实例）。
system.zookeeper_log包含关于向 ZooKeeper 服务器发起请求的参数及其响应信息的系统表。