메인 콘텐츠로 건너뛰기
페이지설명
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_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_insertsSystem table containing information about pending asynchronous inserts in queue.
system.asynchronous_metricsSystem table containing metrics that are calculated periodically in the background. For example, the amount of RAM in use.
system.azure_queue_settingsSystem table containing information about settings of AzureQueue tables. Available from server version 24.10.
system.azure_queue_metadata_cacheContains in-memory state of AzureQueue metadata and currently processed rows per file.
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.background_schedule_pool_logSystem table containing history of background schedule pool task executions.
system.background_schedule_poolSystem table containing information about tasks in background schedule pools.
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_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.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_cacheContains information about all entries inside filesystem cache for remote objects.
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.grantsClickHouse 사용자 계정에 부여된 권한을 보여주는 system table입니다.
system.graphite_retentionsGraphiteMergeTree 유형 엔진을 사용하는 테이블에서 사용되는 graphite_rollup 매개변수 정보를 포함하는 system table입니다.
system.histogram_metrics즉시 계산할 수 있고 Prometheus 포맷으로 내보낼 수 있는 히스토그램 메트릭을 포함하는 테이블입니다. 항상 최신 상태를 유지합니다.
system.iceberg_history시스템 Iceberg 스냅샷 이력
system.iceberg_metadata_logIceberg 테이블에서 읽은 메타데이터 파일 정보를 포함하는 system table입니다. 각 항목은 루트 메타데이터 파일, Avro 파일에서 추출한 메타데이터, 또는 특정 Avro 파일의 항목 중 하나를 나타냅니다.
system.instrumentation계측 지점을 포함하는 system table입니다.
system.jemalloc_stats하나의 컬럼과 하나의 행으로 jemalloc 통계를 반환합니다. SYSTEM JEMALLOC STATS command와 동일합니다.
system.jemalloc_bins모든 arena에서 집계한, jemalloc allocator를 통해 서로 다른 크기 클래스(bin)에서 수행된 메모리 할당 정보를 포함하는 system table입니다.
system.jemalloc_profile_text심볼화된 jemalloc 힙 프로필을 표시합니다. 먼저 프로필을 생성하려면 ‘SYSTEM JEMALLOC FLUSH PROFILE’을 실행하십시오.
system.kafka_consumersKafka 컨슈머 정보를 포함하는 system table입니다.
system.keywordsClickHouse parser에서 사용되는 모든 키워드 목록을 포함합니다.
system.licensesClickHouse 소스의 contrib 디렉터리에 있는 서드파티 라이브러리의 라이선스를 포함하는 system table입니다.
system.macros서버 구성에 정의된 모든 macro 목록을 포함합니다.
system.masking_policies시스템의 모든 masking policies 정보를 포함하는 system table입니다.
system.merge_tree_settingsMergeTree 테이블의 설정 정보를 포함하는 system table입니다.
system.mergesMergeTree 엔진 계열 테이블에서 현재 진행 중인 머지와 파트 뮤테이션 정보를 포함하는 system table입니다.
system.metric_logsystem.metricssystem.events 테이블의 메트릭 값 이력을 포함하며, 주기적으로 디스크에 플러시되는 system table입니다.
system.metrics즉시 계산할 수 있거나 현재 값을 가지는 메트릭을 포함하는 system table입니다.
system.modelsLibraryBridge 메모리에 로드된 CatBoost model 목록과 로드된 시각을 포함합니다.
system.movesMergeTree 테이블에서 진행 중인 데이터 파트 이동 작업 정보를 포함하는 system table입니다. 각 데이터 파트 이동은 하나의 행으로 표시됩니다.
system.mutationsMergeTree 테이블의 뮤테이션과 그 진행 상황 정보를 포함하는 system table입니다. 각 mutation 명령은 하나의 행으로 표시됩니다.
system.named_collectionsSQL query로 생성되었거나 설정 파일에서 파싱된 모든 이름이 지정된 컬렉션 목록을 포함합니다.
system.numbers_mtsystem.numbers와 유사한 system table이지만, 읽기가 병렬화되며 숫자는 임의의 순서로 반환될 수 있습니다.
system.numbersnumber라는 이름의 단일 UInt64 컬럼을 포함하는 system table이며, 0부터 시작하는 거의 모든 자연수를 담고 있습니다.
system.one값 0을 포함하는 단일 dummy UInt8 컬럼이 있는 단일 행을 포함하는 system table입니다. 다른 DBMS의 DUAL 테이블과 유사합니다.
system.opentelemetry_span_log실행된 쿼리의 trace spans 정보를 포함하는 system table입니다.
system.part_moves_between_shards현재 세그먼트 간 이동 중인 파트와 그 진행 상황 정보를 포함합니다.
system.part_log데이터 추가 또는 머지와 같이 MergeTree 엔진 계열 테이블의 데이터 파트에서 발생한 이벤트 정보를 포함하는 system table입니다.
system.partsMergeTree의 파트 정보를 포함하는 system table입니다.
system.parts_columnsMergeTree 테이블의 파트 및 컬럼 정보를 포함하는 system table입니다.
system.predicate_statistics_log쿼리 실행 중 MergeTree 읽기 파이프라인에서 수집된 샘플링된 필터와 인덱스 선택도 통계를 담은 시스템 테이블입니다.
system.primesprime이라는 이름의 단일 UInt64 컬럼이 있으며, 2부터 시작하는 소수가 오름차순으로 포함된 시스템 테이블입니다.
system.privileges사용자 또는 역할에 권한 부여할 수 있는 모든 권한 목록을 포함합니다.
system.processesSHOW PROCESSLIST 쿼리를 구현하는 데 사용되는 시스템 테이블입니다.
system.processors_profile_log프로세서 수준(EXPLAIN PIPELINE에서 확인 가능)의 프로파일링 정보를 담은 시스템 테이블입니다.
system.projection_parts_columnsMergeTree 엔진 계열 테이블의 프로젝션 파트에 있는 컬럼 정보를 담은 시스템 테이블입니다.
system.projection_partsMergeTree 엔진 계열 테이블의 프로젝션 파트 정보를 담은 시스템 테이블입니다.
system.projections모든 테이블에 존재하는 프로젝션 정보를 담은 시스템 테이블입니다.
system.query_views_log쿼리 실행 시 함께 실행되는 종속 뷰의 정보(예: 뷰 유형, 실행 시간)를 담은 시스템 테이블입니다.
system.query_condition_cache쿼리 조건 캐시의 내용을 보여주는 시스템 테이블입니다.
system.query_thread_log쿼리를 실행하는 스레드의 정보(예: 스레드 이름, 스레드 시작 시간, 쿼리 처리 시간)를 담은 시스템 테이블입니다.
system.query_metric_log개별 쿼리에 대한 system.events 테이블의 메모리 및 메트릭 값 이력을 담고 있으며, 이 값들은 주기적으로 디스크에 기록되는 시스템 테이블입니다.
system.query_log실행된 쿼리의 정보(예: 시작 시간, 처리 시간, 오류 메시지)를 담은 시스템 테이블입니다.
system.query_cache쿼리 캐시의 내용을 보여주는 시스템 테이블입니다.
system.quota_usage현재 사용자의 쿼터 사용량 정보(예: 사용한 양과 남은 양)를 담은 시스템 테이블입니다.
system.quota_limits모든 쿼터의 모든 기간에 대한 최대값 정보를 담은 시스템 테이블입니다. 하나의 쿼터에 여러 개의 행이 대응될 수도 있고, 행이 없을 수도 있습니다.
system.quotas_usage모든 사용자의 쿼터 사용량 정보를 담은 시스템 테이블입니다.
system.quotas쿼터 정보를 담은 시스템 테이블입니다.
system.remote_data_pathsS3 또는 Azure Blob Storage와 같은 원격 디스크에 저장된 데이터 파일 정보를 담은 시스템 테이블입니다.
system.replicas로컬 서버에 있는 복제된 테이블의 정보와 상태를 담은 시스템 테이블입니다. 모니터링에 유용합니다.
system.replicated_merge_tree_settings모든 ReplicatedMergeTree 엔진별 설정의 목록과 현재값, 기본값, 설명을 포함합니다. 이 설정들은 CREATE 쿼리의 SETTINGS 섹션에서 변경할 수 있습니다.
system.replicated_fetches현재 실행 중인 백그라운드 페치 정보를 담은 시스템 테이블입니다.
system.replication_queueReplicatedMergeTree 계열 테이블의 경우 ClickHouse Keeper 또는 ZooKeeper에 저장된 복제 큐 작업 정보를 담은 시스템 테이블입니다.
system.resources로컬 서버에 있는 리소스 정보를 담은 시스템 테이블이며, 각 리소스마다 하나의 행이 있습니다.
system.rocksdbembedded RocksDB에서 노출되는 메트릭 목록을 포함합니다.
system.role_grants사용자와 역할에 대한 역할 권한 부여 정보를 담은 시스템 테이블입니다.
system.roles구성된 역할 정보를 담은 시스템 테이블입니다.
system.row_policies특정 테이블에 대한 필터와 이 ROW POLICY를 사용해야 하는 역할 및/또는 사용자 목록을 담은 시스템 테이블입니다.
system.s3_queue_settingsS3Queue 테이블의 설정 정보를 담은 시스템 테이블입니다. 서버 버전 24.10부터 사용할 수 있습니다.
system.s3queue_metadata_cacheS3Queue 메타데이터의 메모리 내 상태와 파일별 현재 처리 중인 행 수를 포함합니다.
system.s3queue_logContains log entries with information about files processed by the S3Queue engine.
It is safe to truncate or drop this table at any time.
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_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_changesSystem table containing information about setting changes in previous ClickHouse versions.
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_processesSystem table containing information useful for an overview of memory usage and ProfileEvents of users.
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_defined_functionsSystem table containing loading status and configuration metadata for User-Defined Functions (UDFs).
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구체화되지 않은 0을 무제한으로 생성합니다.
system.zeros_mtsystem.zeros의 멀티스레드 버전입니다.
system.zookeeper_watches이 ClickHouse 서버에 등록된 현재 활성 상태의 ZooKeeper watch를 보여주는 시스템 테이블입니다.
system.zookeeper_info사용 가능한 모든 Keeper 노드의 내부 검사 정보를 출력하는 시스템 테이블입니다.
system.zookeeper_logZooKeeper 서버로 보낸 요청의 매개변수와 그에 대한 응답 정보를 담고 있는 시스템 테이블입니다.
system.zookeeper_connectionZooKeeper가 구성된 경우에만 존재하는 시스템 테이블입니다. 현재 ZooKeeper 연결(보조 ZooKeeper 포함)을 보여줍니다.
system.zookeeper_connection_logZooKeeper 연결 이력(보조 ZooKeeper 포함)을 보여줍니다.
system.zookeeperClickHouse Keeper 또는 ZooKeeper가 구성된 경우에만 존재하는 시스템 테이블입니다. 구성에 정의된 Keeper 클러스터의 데이터를 노출합니다.
마지막 수정일 2026년 6월 10일