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

系统表

页面说明
系统表概览介绍系统表的概念及其用途。
INFORMATION_SCHEMA提供一个几乎标准化、与 DBMS 无关的数据库对象元数据视图的系统数据库。
system.asynchronous_insert_log包含异步插入相关信息的系统表。每条记录对应一条已缓冲用于异步执行的插入查询。
system.asynchronous_inserts包含队列中待处理的异步插入信息的系统表。
system.asynchronous_loader包含最近异步作业（例如正在加载的表）的信息和状态的系统表。表中每个作业对应一行记录。
system.asynchronous_metric_log包含 system.asynchronous_metrics 历史值的系统表，这些值按固定时间间隔保存一次（默认每秒一次）
system.asynchronous_metrics包含在后台定期计算得到的各项指标的系统表，例如当前正在使用的内存量。
system.azure_queue_settings包含 AzureQueue 表设置信息的系统表。自服务器版本 24.10 起可用。
system.background_schedule_pool包含后台调度池中任务信息的系统表。
system.background_schedule_pool_log包含后台调度池任务执行历史的系统表。
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.masking_policies包含系统中所有脱敏策略信息的系统表。
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 列的系统表，该列中存储从 0 开始的几乎所有自然数。
system.numbers_mt类似于 system.numbers 的系统表，但读取是并行进行的，返回的数字顺序可以是任意的。
system.one仅包含一行且只有一个名为 dummy、值为 0 的 UInt8 列的系统表。类似于其他 DBMS 中的 DUAL 表。
system.opentelemetry_span_log包含已执行查询的跟踪 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。
system.quotas包含 QUOTA 相关信息的系统表。
system.quotas_usage包含所有用户 QUOTA 使用情况信息的系统表。
system.replicas包含本地服务器上复制表信息及其状态的系统表，便于监控。
system.replicated_fetches包含当前正在运行的后台拉取操作信息的系统表。
system.replication_queue包含 ClickHouse Keeper 或 ZooKeeper 中 ReplicatedMergeTree 系列表复制队列任务信息的系统表。
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仅在配置了 ClickHouse Keeper 或 ZooKeeper 时才存在的系统表。它提供对配置文件中定义的 Keeper 集群数据的访问。
system.zookeeper_connection仅在配置了 ZooKeeper 时才存在的系统表。显示当前与 ZooKeeper 的连接（包括辅助 ZooKeeper 实例）。
system.zookeeper_connection_log显示 ZooKeeper 连接历史记录（包括辅助 ZooKeeper 实例）。
system.zookeeper_log包含向 ZooKeeper 服务器发送的请求参数及对应响应信息的系统表。