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

系统表

页面描述
System Tables OverviewOverview of what system tables are and why they are useful.
system.histogram_metric_logSystem table containing periodic snapshots of histogram metrics, flushed to disk.
INFORMATION_SCHEMASystem database providing an almost standardized DBMS-agnostic view on metadata of database objects.
system.aggregate_function_combinatorsContains a list of all available aggregate function combinators, which could be applied to aggregate functions and change the way they work.
system.aggregated_zookeeper_logSystem table containing aggregated statistics of ZooKeeper operations grouped by session, path, operation type, component, and subrequest flag.
system.asynchronous_insert_logSystem table containing information about async inserts. Each entry represents an insert query buffered into an async insert query.
system.asynchronous_insertsSystem table containing information about pending asynchronous inserts in queue.
system.asynchronous_loaderSystem table containing information about and status of recent asynchronous jobs (e.g. for tables which are loading). The table contains a row for every job.
system.asynchronous_metric_logSystem table containing historical values for system.asynchronous_metrics, which are saved once per time interval (one second by default)
system.asynchronous_metricsSystem table containing metrics that are calculated periodically in the background. For example, the amount of RAM in use.
system.azure_queue_logContains log entries with information about files processed by the AzureQueue engine.
It is safe to truncate or drop this table at any time.
system.azure_queue_metadata_cacheContains in-memory state of AzureQueue metadata and currently processed rows per file.
system.azure_queue_settingsSystem table containing information about settings of AzureQueue tables. Available from server version 24.10.
system.background_schedule_poolSystem table containing information about tasks in background schedule pools.
system.background_schedule_pool_logSystem table containing history of background schedule pool task executions.
system.backup_logSystem table containing logging entries with information about BACKUP and RESTORE operations.
system.backupsSystem table containing logging entries with information about BACKUP and RESTORE operations.
system.blob_storage_logSystem table containing logging entries with information about various blob storage operations such as uploads and deletes.
system.build_optionsSystem table containing information about ClickHouse server's build options.
system.certificatesContains information about available certificates and their sources.
system.clustersSystem table containing information about clusters available in the config file and the servers defined in them.
system.codecsSystem table containing information about codecs in queue.
system.collationsContains a list of all available collations for alphabetical comparison of strings.
system.columnsSystem table containing information about columns in all tables
system.completionsContains a list of completion tokens.
system.contributorsSystem table containing information about contributors.
system.crash_logSystem table containing information about stack traces for fatal errors.
system.current_rolesSystem table containing active roles for the current user.
system.dashboardsContains queries used by /dashboard page accessible though the HTTP interface. useful for monitoring and troubleshooting.
system.data_skipping_indicesSystem table containing information about existing data skipping indices in all the tables.
system.data_type_familiesSystem table containing information about supported data types
system.database_enginesSystem table containing a list of database engines supported by the server.
system.database_replicasSystem table containing information about and status of replicated database.
system.databasesSystem table containing information about the databases that are available to the current user.
system.dead_letter_queueSystem table containing information about messages received via a streaming engine and parsed with errors.
system.delta_lake_metadata_logSystem table containing information about metadata files read from Delta Lake tables. Each entry represents a root metadata JSON file.
system.detached_partsSystem table containing information about detached parts of MergeTree tables
system.detached_tablesSystem table containing information about each detached table.
system.dictionariesSystem table containing information about dictionaries
system.dimensional_metricsThis table contains dimensional metrics that can be calculated instantly and exported in the Prometheus format. It is always up to date.
system.disksSystem table containing information about disks defined in the server configuration
system.distributed_ddl_queueSystem table containing information about distributed ddl queries (queries using the ON CLUSTER clause) that were executed on a cluster.
system.distribution_queueSystem table containing information about local files that are in the queue to be sent to the shards.
system.dns_cacheSystem table containing information about cached DNS records.
system.dropped_tablesSystem table containing information about tables that drop table has been executed on but for which data cleanup has not yet been performed
system.dropped_tables_partsSystem table containing information about parts of MergeTree dropped tables from system.dropped_tables
system.enabled_rolesSystem table containing all active roles at the moment, including the current role of the current user and the granted roles for the current role
system.error_logSystem table containing the history of error values from table system.errors, periodically flushed to disk.
system.errorsSystem table containing error codes with the number of times they have been triggered.
system.eventsSystem table containing information about the number of events that have occurred in the system.
system.fail_pointsContains a list of all available failpoints with their type and current status.
system.filesystem_cacheContains information about all entries inside filesystem cache for remote objects.
system.filesystem_cache_logContains a history of all events occurred with filesystem cache for objects on a remote filesystem.
It is safe to truncate or drop this table at any time.
system.filesystem_cache_settingsContains information about all filesystem cache settings
system.filesystem_read_prefetches_logContains a history of all prefetches done during reading from MergeTree tables backed by a remote filesystem.
It is safe to truncate or drop this table at any time.
system.formatsContains a list of all the formats along with flags whether a format is suitable for input/output or whether it supports parallelization.
system.functionsSystem table containing information about normal and aggregate 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.jemalloc_profile_text显示带符号信息的 jemalloc 堆分析报告。请先运行 'SYSTEM JEMALLOC FLUSH PROFILE' 生成分析报告。
system.jemalloc_stats以单行单列的形式返回 jemalloc 统计信息。等同于 SYSTEM JEMALLOC STATS 命令。
system.kafka_consumers包含 Kafka 消费者信息的系统表。
system.keywords包含 ClickHouse 解析器所使用的全部关键字列表。
system.licenses包含 ClickHouse 源代码中 contrib 目录内第三方库许可证的系统表。
system.macros包含在服务器配置中定义的所有 macros 列表。
system.masking_policies包含系统中所有掩码策略信息的系统表。
system.merge_tree_settings包含 MergeTree 表设置信息的系统表。
system.merges包含 MergeTree 系列表当前正在进行的合并和数据部件 mutation 信息的系统表。
system.metric_log系统表,包含来自 system.metricssystem.events 表的指标值历史记录,并会定期刷新到磁盘。
system.metrics包含可即时计算或具有当前值的指标的系统表。
system.models包含已加载到 LibraryBridge 内存中的 CatBoost 模型列表及其加载时间的系统表。
system.moves包含 MergeTree 表正在进行的数据部件移动信息的系统表。每个数据部件的移动对应一行记录。
system.mutations包含 MergeTree 表 mutation 操作及其进度信息的系统表。每个 mutation 命令对应一行记录。
system.named_collections包含通过 SQL 查询创建或从设置文件解析得到的所有命名集合列表。
system.numbers系统表,仅包含一个名为 number 的 UInt64 列,该列存储几乎全部从 0 开始的自然数。
system.numbers_mtsystem.numbers 类似的系统表,但读取操作是并行执行的,返回的数字可以是任意顺序。
system.one仅包含一行且只有一个名为 dummy、类型为 UInt8、值为 0 的列的系统表。类似于其他数据库管理系统中的 DUAL 表。
system.opentelemetry_span_log包含已执行查询的 trace spans 信息的系统表。
system.part_log包含 MergeTree 系列表中数据分区片段相关事件信息的系统表,例如数据添加或合并等操作。
system.part_moves_between_shards包含当前正在分片之间移动的 parts 及其进度信息。
system.parts包含 MergeTree 表分区片段相关信息的系统表
system.parts_columns包含 MergeTree 表的分区片段和列信息的系统表。
system.predicate_statistics_log系统表,包含在查询执行期间从 MergeTree 读取管道中收集的采样过滤器和索引选择性统计信息。
system.primes系统表,只包含一个名为 prime 的 UInt64 类型列,按升序存储从 2 开始的质数。
system.privileges包含可授予用户或角色的全部可用特权列表。
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.remote_data_paths包含存储在 S3 或 Azure Blob 存储等远程磁盘上的数据文件信息的系统表。
system.replicas包含本地服务器上副本表信息和状态的系统表。可用于监控。
system.replicated_fetches包含当前正在执行的后台拉取信息的系统表。
system.replicated_merge_tree_settings包含所有 ReplicatedMergeTree 专有设置及其当前值、默认值和说明的列表。您可以在 CREATE 查询的 SETTINGS 部分修改其中任意一项。
system.replication_queue系统表,包含关于 ReplicatedMergeTree family 表中存储在 ClickHouse Keeper 或 ZooKeeper 中的复制队列任务信息。
system.resources包含驻留在本地服务器上的资源信息的系统表,每个资源对应一行。
system.rocksdb包含嵌入式 RocksDB 暴露的指标列表。
system.role_grants包含授予给用户和角色的角色授权信息的系统表。
system.roles包含已配置角色信息的系统表。
system.row_policies包含针对某个特定表的过滤条件的系统表,以及一个应使用此 ROW POLICY 的角色和/或用户列表。
system.s3_queue_settings包含 S3Queue 表设置信息的系统表。从服务器版本 24.10 起可用。
system.s3queue_log包含与由 S3Queue 引擎处理的文件相关信息的日志记录项。
It is safe to truncate or drop this table at any time.
system.s3queue_metadata_cacheContains in-memory state of S3Queue metadata and currently processed rows per file.
system.schedulerSystem table containing information about and status of scheduling nodes residing on the local server.
system.schema_inference_cacheSystem table containing information about all cached file schemas.
system.server_settingsSystem table containing formation about global settings for the server, which are specified in config.xml.
system.session_logSystem table containing information about all successful and failed login and logout events.
system.settingsSystem table containing information about session settings for current user.
system.settings_changesSystem table containing information about setting changes in previous ClickHouse versions.
system.settings_profile_elementsSystem table which describes the content of the settings profile: constraints, roles and users that the setting applies to, parent settings profiles.
system.settings_profilesSystem table which contains properties of configured setting profiles.
system.stack_traceSystem table which contains stack traces of all server threads. Allows developers to introspect the server state.
system.storage_policiesSystem table containing information about storage policies and volumes which are defined in server configuration.
system.symbolsSystem table useful for C++ experts and ClickHouse engineers containing information for introspection of the clickhouse binary.
system.table_enginesSystem table containing descriptions of table engines supported by the server and the features they support.
system.table_functionsContains a list of all available table functions with their descriptions.
system.tablesSystem table containing metadata of each table that the server knows about.
system.text_logSystem table containing logging entries.
system.time_zonesSystem table containing a list of time zones that are supported by the ClickHouse server.
system.tokenizersSystem table which shows all available tokenizers.
system.trace_logSystem table containing stack traces collected by the sampling query profiler.
system.transactionsContains a list of transactions and their state.
system.transactions_info_logContains information about all transactions executed on a current server.
It is safe to truncate or drop this table at any time.
system.unicodeSystem table containing a list of Unicode characters and their properties.
system.user_defined_functionsSystem table containing loading status and configuration metadata for User-Defined Functions (UDFs).
system.user_directoriesContains the information about configured user directories - directories on the file system from which ClickHouse server is allowed to read user provided data.
system.user_processesSystem table containing information useful for an overview of memory usage and ProfileEvents of users.
system.usersSystem table containing a list of user accounts configured on the server.
system.view_refreshesSystem table containing information about Refreshable Materialized Views.
system.warningsThis table contains warning messages about clickhouse server.
system.warnings包含服务器配置相关警告信息的系统表,这些信息会在 clickhouse-client 连接到服务器后立即显示。
system.workloads包含本地服务器上工作负载信息的系统表。
system.zeros生成无限数量的非物化零值。
system.zeros_mtsystem.zeros 的多线程版本。
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 服务器发送的请求参数及其返回的响应信息的系统表。
system.zookeeper_watches显示由此 ClickHouse 服务端注册的当前处于活动状态的 ZooKeeper watches 的系统表。