Skip to main content

​
설명

서버가 인식하고 있는 각 테이블의 메타데이터를 포함합니다. 분리된 테이블은 system.tables에 표시되지 않습니다. 임시 테이블은 생성된 세션에서만 system.tables에 표시됩니다. 이러한 테이블은 database 필드가 비어 있고 is_temporary 플래그가 켜진 상태로 표시됩니다.

​
컬럼

  • database (String) — 테이블이 속한 데이터베이스의 이름입니다.
  • name (String) — 테이블 이름입니다.
  • uuid (UUID) — 테이블 UUID(Atomic 데이터베이스)입니다.
  • engine (String) — 테이블 엔진 이름(매개변수 제외)입니다.
  • is_temporary (UInt8) — 테이블이 임시 테이블인지 나타내는 플래그입니다.
  • data_paths (Array(String)) — 파일 시스템에 있는 테이블 데이터의 경로입니다.
  • metadata_path (String) — 파일 시스템에 있는 테이블 메타데이터의 경로입니다.
  • metadata_modification_time (DateTime) — 테이블 메타데이터가 마지막으로 수정된 시간입니다.
  • metadata_version (Int32) — ReplicatedMergeTree 테이블의 메타데이터 버전이며, ReplicatedMergeTree가 아닌 테이블에서는 0입니다.
  • dependencies_database (Array(String)) — 데이터베이스 의존성입니다.
  • dependencies_table (Array(String)) — 테이블 의존성(현재 테이블에 종속된 materialized view)입니다.
  • create_table_query (String) — 테이블 생성에 사용된 쿼리입니다.
  • engine_full (String) — 테이블 엔진의 매개변수입니다.
  • as_select (String) — 뷰의 SELECT 쿼리입니다.
  • parameterized_view_parameters (Array(Tuple(name String, type String))) — parameterized view의 매개변수입니다.
  • partition_key (String) — 테이블에 지정된 파티션 키 표현식입니다.
  • sorting_key (String) — 테이블에 지정된 정렬 키 표현식입니다.
  • primary_key (String) — 테이블에 지정된 프라이머리 키 표현식입니다.
  • sampling_key (String) — 테이블에 지정된 샘플링 키 표현식입니다.
  • unique_key (String) — 테이블에 지정된 고유 키 표현식(UNIQUE KEY 절)입니다.
  • skipping_indices_types (Array(String)) — 테이블에 정의된 데이터 스킵 인덱스의 고유한 타입 배열입니다(예: minmax, set, bloom_filter, ngrambf_v1, tokenbf_v1, text, vector_similarity). 스킵 인덱스가 없는 테이블에서는 비어 있습니다.
  • storage_policy (String) — 스토리지 정책입니다. MergeTree 및 분산 엔진을 사용하는 테이블에 적용됩니다.
  • total_rows (Nullable(UInt64)) — 테이블의 정확한 전체 행 수를 빠르게 확인할 수 있으면 해당 값을 반환하고, 그렇지 않으면 NULL을 반환합니다(기반 Buffer 테이블 포함).
  • total_bytes (Nullable(UInt64)) — 스토리지에 저장된 테이블의 정확한 전체 바이트 수를 빠르게 확인할 수 있으면 해당 값을 반환하고, 그렇지 않으면 NULL을 반환합니다(기반 스토리지는 포함하지 않음). 테이블이 데이터를 디스크에 저장하는 경우 사용 중인 디스크 공간(즉, 압축된 크기)을 반환합니다. 테이블이 데이터를 메모리에 저장하는 경우 메모리에서 사용 중인 바이트 수의 근사값을 반환합니다.
  • total_bytes_uncompressed (Nullable(UInt64)) — 스토리지에 저장된 테이블의 part checksums에서 정확한 전체 비압축 바이트 수를 빠르게 확인할 수 있으면 해당 값을 반환하고, 그렇지 않으면 NULL을 반환합니다(기반 스토리지가 있는 경우에도 고려하지 않음).
  • parts (Nullable(UInt64)) — 이 테이블의 총 파트 수입니다.
  • active_parts (Nullable(UInt64)) — 이 테이블의 활성 파트 수입니다.
  • total_marks (Nullable(UInt64)) — 이 테이블의 모든 파트에 있는 총 마크 수입니다.
  • active_on_fly_data_mutations (UInt64) — 즉시 적용할 수 있는 활성 데이터 뮤테이션(UPDATE 및 DELETE)의 총수입니다.
  • active_on_fly_alter_mutations (UInt64) — 즉시 적용할 수 있는 활성 ALTER 뮤테이션(MODIFY COLUMN)의 총수입니다.
  • active_on_fly_metadata_mutations (UInt64) — 즉시 적용할 수 있는 활성 메타데이터 뮤테이션(RENAME)의 총수입니다.
  • columns_descriptions_cache_size (UInt64) — *MergeTree 테이블의 컬럼 설명 캐시 크기입니다.
  • lifetime_rows (Nullable(UInt64)) — 서버 시작 이후 INSERT된 총 행 수입니다(Buffer 테이블에만 해당).
  • lifetime_bytes (Nullable(UInt64)) — 서버 시작 이후 INSERT된 총 바이트 수입니다(Buffer 테이블에만 해당).
  • comment (String) — 테이블의 주석입니다.
  • has_own_data (UInt8) — 테이블 자체가 디스크에 데이터를 저장하는지, 아니면 다른 소스에만 액세스하는지를 나타내는 플래그입니다.
  • loading_dependencies_database (Array(String)) — 데이터베이스 로딩 의존성(현재 객체보다 먼저 로드해야 하는 객체 목록)입니다.
  • loading_dependencies_table (Array(String)) — 테이블 로딩 의존성(현재 객체보다 먼저 로드해야 하는 객체 목록)입니다.
  • loading_dependent_database (Array(String)) — 로딩에 종속된 데이터베이스입니다.
  • loading_dependent_table (Array(String)) — 로딩에 종속된 테이블입니다.
  • target_database (String) — materialized view의 경우, 뷰가 데이터를 기록하는 대상 테이블의 데이터베이스입니다(TO 대상 또는 암시적 .inner.* 테이블). 다른 엔진에서는 비어 있습니다.
  • target_table (String) — materialized view의 경우, 뷰가 데이터를 기록하는 대상 테이블의 이름입니다(TO 대상 또는 암시적 .inner.* 테이블). 다른 엔진에서는 비어 있습니다.
  • definer (String) — 테이블에 사용되는 SQL security 정의자의 이름입니다.
별칭:
  • table — name의 별칭입니다.

​
예시

마지막 수정일 2026년 8월 14일