본문으로 바로가기
본문으로 바로가기

시스템 테이블

페이지설명
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_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.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.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_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_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_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_cacheContains information about all entries inside filesystem cache for remote objects.
system.filesystem_cache_settingsContains information about all filesystem cache settings
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.graphite_retentionsGraphiteMergeTree 타입 엔진을 사용하는 테이블에서 사용되는 graphite_rollup 파라미터에 대한 정보를 포함하는 시스템 테이블입니다.
system.histogram_metrics즉시 계산할 수 있고 Prometheus 형식으로 내보낼 수 있는 히스토그램 메트릭을 포함하는 테이블입니다. 항상 최신 상태로 유지됩니다.
system.iceberg_metadata_logIceberg 테이블에서 읽은 메타데이터 파일에 대한 정보를 포함하는 시스템 테이블입니다. 각 항목은 루트 메타데이터 파일, Avro 파일에서 추출된 메타데이터 또는 특정 Avro 파일의 항목을 나타냅니다.
system.iceberg_historyIceberg 스냅샷 이력을 제공하는 시스템 테이블입니다.
system.instrumentation계측(instrumentation) 포인트에 대한 정보를 포함하는 시스템 테이블입니다.
system.jemalloc_binsjemalloc 할당자를 통해 수행된 메모리 할당 정보를 크기 클래스(빈, bins)별로 모든 arena에서 집계한 정보를 포함하는 시스템 테이블입니다.
system.jemalloc_profile_text기호화된 jemalloc 힙 프로필을 표시합니다. 먼저 'SYSTEM JEMALLOC FLUSH PROFILE'을 실행하여 프로필을 생성하십시오.
system.jemalloc_statsjemalloc 통계를 단일 컬럼과 단일 행으로 반환합니다. SYSTEM JEMALLOC STATS 명령어와 동일합니다.
system.kafka_consumersKafka 소비자(consumers)에 대한 정보를 포함하는 시스템 테이블입니다.
system.keywordsClickHouse 파서에서 사용되는 모든 키워드의 목록을 포함합니다.
system.licensesClickHouse 소스의 contrib 디렉터리에 위치한 서드파티 라이브러리의 라이선스를 포함하는 시스템 테이블입니다.
system.macros서버 구성에 정의된 모든 매크로 목록을 포함합니다.
system.masking_policies시스템에 존재하는 모든 마스킹 정책에 대한 정보를 포함하는 시스템 테이블입니다.
system.merge_tree_settingsMergeTree 테이블에 대한 설정 정보를 포함하는 시스템 테이블입니다.
system.mergesMergeTree 계열 테이블에서 현재 진행 중인 병합(merges) 작업과 파트 뮤테이션에 대한 정보를 포함하는 시스템 테이블입니다.
system.metric_logsystem.metricssystem.events 테이블의 메트릭 값 이력을 포함하며, 주기적으로 디스크에 플러시되는 시스템 테이블입니다.
system.metrics즉시 계산할 수 있거나 현재 값을 가지는 메트릭을 포함하는 시스템 테이블입니다.
system.modelsLibraryBridge 메모리에 로드된 CatBoost 모델 목록과 각 모델이 로드된 시간을 포함합니다.
system.moves진행 중인 MergeTree 테이블의 데이터 파트 이동에 대한 정보를 포함하는 시스템 테이블입니다. 각 데이터 파트 이동은 하나의 행으로 표현됩니다.
system.mutationsMergeTree 테이블의 뮤테이션과 그 진행 상태에 대한 정보를 담는 시스템 테이블입니다. 각 뮤테이션 명령은 하나의 행으로 기록됩니다.
system.named_collectionsSQL 쿼리를 통해 생성되었거나 설정 파일에서 파싱된 모든 이름이 지정된 컬렉션의 목록을 포함합니다.
system.numbers단일 UInt64 컬럼 number 하나만을 가지며, 0부터 시작하는 거의 모든 자연수가 이 컬럼에 저장되는 시스템 테이블입니다.
system.numbers_mtsystem.numbers와 유사한 시스템 테이블로, 읽기가 병렬화되어 숫자가 임의의 순서로 반환될 수 있습니다.
system.one값 0이 저장된 dummy UInt8 컬럼 하나와 단일 행만을 포함하는 시스템 테이블입니다. 다른 DBMS에서 사용되는 DUAL 테이블과 유사합니다.
system.opentelemetry_span_log실행된 쿼리에 대한 트레이스 스팬 정보를 담는 시스템 테이블입니다.
system.part_log데이터 추가나 병합과 같이 MergeTree 계열 테이블의 데이터 파트에서 발생한 이벤트에 대한 정보를 담는 시스템 테이블입니다.
system.part_moves_between_shards현재 세그먼트 간 이동이 진행 중인 파트와 그 진행 상태에 대한 정보를 담고 있습니다.
system.partsMergeTree 파트에 대한 정보를 담는 시스템 테이블입니다.
system.parts_columnsMergeTree 테이블의 파트 및 컬럼에 대한 정보를 담는 시스템 테이블입니다.
system.predicate_statistics_log쿼리 실행 중 MergeTree 읽기 파이프라인에서 수집된 샘플링된 필터 및 인덱스 선택도 통계를 포함하는 시스템 테이블입니다.
system.primesprime이라는 이름의 단일 UInt64 컬럼을 포함하는 시스템 테이블로, 2부터 시작하는 소수가 오름차순으로 저장됩니다.
system.privileges사용자 또는 역할에 부여할 수 있는 사용 가능한 모든 특권의 목록을 포함합니다.
system.processesSHOW PROCESSLIST 쿼리를 구현하는 데 사용되는 시스템 테이블입니다.
system.processors_profile_log프로세서 수준의 프로파일링 정보를 포함하는 시스템 테이블입니다(EXPLAIN PIPELINE 출력에서 확인할 수 있습니다).
system.projection_partsMergeTree 계열 테이블에 대한 프로젝션 파트 정보를 담는 시스템 테이블입니다.
system.projection_parts_columnsMergeTree 계열 테이블의 프로젝션 파트에 포함된 컬럼 정보를 담는 시스템 테이블입니다.
system.projections모든 테이블에 존재하는 프로젝션에 대한 정보를 담는 시스템 테이블입니다.
system.query_log시작 시간, 처리 시간, 오류 메시지 등 실행된 쿼리에 대한 정보를 담는 시스템 테이블입니다.
system.query_metric_logsystem.events 테이블에서 개별 쿼리별 메모리 및 메트릭 값 이력을 저장하며, 주기적으로 디스크에 플러시되는 시스템 테이블입니다.
system.query_thread_log스레드 이름, 스레드 시작 시간, 쿼리 처리 시간 등 쿼리를 실행하는 스레드에 대한 정보를 담는 시스템 테이블입니다.
system.query_views_log뷰 유형, 실행 시간 등 쿼리 실행 시 함께 실행되는 종속 뷰에 대한 정보를 담는 시스템 테이블입니다.
system.query_cache쿼리 캐시의 내용을 보여주는 시스템 테이블입니다.
system.query_condition_cache쿼리 조건 캐시의 내용을 보여주는 시스템 테이블입니다.
system.quota_limits모든 쿼터(quota)의 각 구간(interval)에 대한 최대값 정보를 담고 있는 시스템 테이블입니다. 하나의 쿼터에는 0개 이상의 행이 대응될 수 있습니다.
system.quota_usage현재 사용자에 대한 쿼터 사용량 정보(예: 사용된 양과 남은 양)를 담고 있는 시스템 테이블입니다.
system.quotas쿼터에 관한 정보를 담고 있는 시스템 테이블입니다.
system.quotas_usage모든 사용자의 쿼터 사용량 정보(예: 사용된 양과 남은 양)를 담고 있는 시스템 테이블입니다.
system.remote_data_pathsS3 또는 Azure Blob Storage와 같은 원격 디스크에 저장된 데이터 파일 정보를 담고 있는 시스템 테이블입니다.
system.replicas로컬 서버에 존재하는 복제된 테이블들의 정보와 상태를 담고 있는 시스템 테이블입니다. 모니터링에 유용합니다.
system.replicated_fetches현재 실행 중인 백그라운드 페치(fetch) 작업들에 대한 정보를 담고 있는 시스템 테이블입니다.
system.replicated_merge_tree_settingsReplicatedMergeTree 엔진 전용 설정과 각 설정의 현재 값, 기본값 및 설명 목록을 포함합니다. 이 설정은 CREATE 쿼리의 SETTINGS 섹션에서 변경할 수 있습니다.
system.replication_queueReplicatedMergeTree 계열 테이블에 대해 ClickHouse Keeper 또는 ZooKeeper에 저장된 복제 큐에 있는 작업에 대한 정보를 제공하는 시스템 테이블입니다.
system.resources로컬 서버에 존재하는 리소스들에 대한 정보를 담고 있는 시스템 테이블로, 각 리소스마다 한 행이 있습니다.
system.rocksdbembedded RocksDB에서 노출되는 메트릭 목록을 포함합니다.
system.role_grants사용자 및 역할에 부여된 역할 그랜트(role grants)에 관한 정보를 담고 있는 시스템 테이블입니다.
system.roles구성된 역할들에 대한 정보를 담고 있는 시스템 테이블입니다.
system.row_policies특정 테이블에 대한 필터(로우 정책)와 해당 로우 정책을 사용해야 하는 역할 및/또는 사용자 목록을 담고 있는 시스템 테이블입니다.
system.s3_queue_settingsS3Queue 테이블의 설정 정보를 포함하는 시스템 테이블입니다. 서버 24.10 버전부터 사용할 수 있습니다.
system.s3queue_logS3Queue 엔진에서 처리한 파일에 대한 정보를 담은 로그 항목을 포함합니다.
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.warningsclickhouse-client가 서버에 연결된 직후 표시되는 서버 구성 관련 경고를 포함합니다.
system.workloads로컬 서버에 있는 워크로드에 대한 정보를 포함하는 시스템 테이블입니다.
system.zeros구체화되지 않은 0을 무제한으로 생성합니다.
system.zeros_mtsystem.zeros의 멀티스레드 버전입니다.
system.zookeeperClickHouse Keeper 또는 ZooKeeper가 구성된 경우에만 존재하는 시스템 테이블입니다. 설정에 정의된 Keeper 클러스터의 데이터를 노출합니다.
system.zookeeper_connectionZooKeeper가 구성된 경우에만 존재하는 시스템 테이블입니다. 현재 ZooKeeper(보조 ZooKeeper 포함)와의 연결을 보여줍니다.
system.zookeeper_connection_logZooKeeper 연결 이력(보조 ZooKeeper 포함)을 보여주는 시스템 테이블입니다.
system.zookeeper_info사용 가능한 모든 Keeper 노드에 대한 내부 정보를 출력하는 시스템 테이블입니다.
system.zookeeper_logZooKeeper 서버에 대한 요청의 파라미터와 그에 대한 응답 정보를 포함하는 시스템 테이블입니다.
system.zookeeper_watches이 ClickHouse 서버에 등록된 현재 활성 상태의 ZooKeeper watch를 보여주는 시스템 테이블입니다.