跳转到主内容
跳转到主内容

系统表

页面说明
系统表概述系统表是什么以及它们为何有用的概述。
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包含当前 USER 的活动角色的系统表。
system.dashboards包含可通过 HTTP 接口访问的 /dashboard 页面所使用的查询，对监控和故障排查很有帮助。
system.data_skipping_indices包含所有表中现有数据跳过索引信息的系统表。
system.data_type_families包含受支持的数据类型信息的系统表
system.database_engines包含服务器所支持的数据库引擎列表的系统表。
system.database_replicas包含数据库副本相关信息及其状态的系统表。
system.databases包含当前 USER 可访问的数据库信息的系统表。
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包含当前所有有效角色的系统表,包括当前 USER 的当前角色以及授予该角色的角色
system.error_log系统表，包含来自表 system.errors 的错误值历史记录，并会定期刷新到磁盘。
system.errors包含错误代码及其被触发次数的系统表。
system.events包含系统中已发生事件次数信息的系统表。
system.functions包含普通函数和聚合函数信息的系统表。
system.grants系统表,用于显示授予 ClickHouse 用户账号的各项权限。
system.graphite_retentions系统表，包含在使用 GraphiteMergeTree 类型引擎的表中使用的 graphite_rollup 参数信息。
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 系列表当前正在进行的合并和数据部件 mutation 信息的系统表。
system.metric_log系统表,包含 system.metrics 和 system.events 表中的指标值历史记录,并定期写入磁盘。
system.metrics包含可即时计算或具有当前值的指标的系统表。
system.moves包含 MergeTree 表正在进行的数据部件移动信息的系统表。每个数据部件的移动对应一行记录。
system.mutations包含 MergeTree 表 mutation 操作及其进度信息的系统表。每个 mutation 命令对应一行记录。
system.numbers系统表，只包含一个名为 number 的 UInt64 列，存储从零开始的几乎所有自然数。
system.numbers_mt与 system.numbers 类似的系统表，但读取会并行执行，返回的数字顺序可能是任意的。
system.one仅包含一行，且只有一个名为 dummy、类型为 UInt8、值为 0 的列的系统表。类似于其他数据库管理系统中的 DUAL 表。
system.opentelemetry_span_log包含已执行查询的 trace spans 信息的系统表。
system.part_log包含 MergeTree 系列表中数据分区片段相关事件信息的系统表,例如数据添加或合并等操作。
system.parts包含 MergeTree 表分区片段相关信息的系统表
system.parts_columns包含 MergeTree 表的分区片段和列信息的系统表。
system.primes系统表,只包含一个名为 prime 的 UInt64 列,其中存储按升序排列的质数,从 2 开始。
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包含所有 QUOTA 在各个时间区间内最大限制信息的系统表。一个 QUOTA 可以对应任意数量的行（包括零行）。
system.quota_usage系统表,包含当前 USER 的 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包含所有已缓存文件模式信息的系统表。
system.server_settings包含在 config.xml 中指定的服务器全局设置信息的系统表。
system.session_log记录所有成功和失败登录与登出事件信息的系统表。
system.settings包含当前用户会话设置信息的系统表。
system.settings_changes包含此前 ClickHouse 各版本中设置变更信息的系统表。
system.settings_profile_elements描述 SETTINGS PROFILE 内容的系统表：包括 CONSTRAINT、该设置适用的角色和 USER，以及父级 SETTINGS PROFILE。
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_defined_functions包含用户自定义函数 (UDF) 加载状态和配置元数据的系统表。
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_info用于输出所有可用 Keeper 节点内部状态的系统表。
system.zookeeper_log包含关于向 ZooKeeper 服务器发送的请求参数及其返回的响应信息的系统表。