system.tables 시스템 테이블
system.tables 시스템 테이블
system.tables 는 서버가 알고 있는 각 테이블의 메타데이터를 담고 있어요. Detached 테이블은 system.tables 에 표시되지 않아요.
출처: 문서
본문
Description
서버가 알고 있는 각 테이블의 메타데이터를 포함해요.
Detached 테이블은 system.tables 에 표시되지 않아요.
임시 테이블 은 생성된 세션에서만 system.tables 에 보여요. 이들은 빈 database 필드와 is_temporary 플래그가 켜진 상태로 표시돼요.
Columns
-
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)이에요. -
dependencies_table(Array(String)) — 테이블 의존성(현재 테이블의 구체화된 뷰들)이에요. -
create_table_query(String) — 테이블을 만드는 데 사용된 쿼리예요. -
engine_full(String) — 테이블 엔진의 파라미터예요. -
as_select(String) — 뷰를 위한 SELECT 쿼리예요. -
parameterized_view_parameters(Array(Tuple(name String, type String))) — 파라미터화된 뷰의 파라미터예요. -
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와 Distributed 엔진을 사용하는 테이블과 관련이 있어요. -
total_rows(Nullable(UInt64)) — 테이블의 정확한 행 수를 빠르게 결정할 수 있으면 총 행 수, 그렇지 않으면 NULL이에요(기본 Buffer 테이블 포함). -
total_bytes(Nullable(UInt64)) — 테이블의 저장소에서 정확한 바이트 수를 빠르게 결정할 수 있으면 총 바이트 수, 그렇지 않으면 NULL이에요(기본 저장소는 포함하지 않아요). 테이블이 디스크에 데이터를 저장하면 디스크에서 사용한 공간(즉, 압축된 크기)을 반환해요. 테이블이 메모리에 데이터를 저장하면 메모리에서 사용한 대략적인 바이트 수를 반환해요. -
total_bytes_uncompressed(Nullable(UInt64)) — 파트 체크섬에서 테이블 저장소의 정확한 바이트 수를 빠르게 결정할 수 있으면 압축되지 않은 총 바이트 수, 그렇지 않으면 NULL이에요(기본 저장소가 있으면 고려하지 않아요). -
parts(Nullable(UInt64)) — 이 테이블의 총 파트 수예요. -
active_parts(Nullable(UInt64)) — 이 테이블의 활성 파트 수예요. -
total_marks(Nullable(UInt64)) — 이 테이블의 모든 파트에 있는 총 마크 수예요. -
active_on_fly_data_mutations(UInt64) — 즉석(on the fly) 적용에 적합한 활성 데이터 돌연변이(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) — 테이블에 대한 설명(comment)이에요. -
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) — 구체화된 뷰의 경우, 뷰가 쓰는 대상 테이블의 데이터베이스예요(TO대상 또는 암시적.inner.*테이블). 다른 엔진에서는 비어 있어요. -
target_table(String) — 구체화된 뷰의 경우, 뷰가 쓰는 대상 테이블의 이름이에요(TO대상 또는 암시적.inner.*테이블). 다른 엔진에서는 비어 있어요. -
definer(String) — 테이블에 사용되는 SQL security definer의 이름이에요.
별칭(Aliases):
table—name의 별칭이에요.
Example
SELECT * FROM system.tables LIMIT 2 FORMAT Vertical;
Row 1:
──────
database: base
name: t1
uuid: 81b1c20a-b7c6-4116-a2ce-7583fb6b6736
engine: MergeTree
is_temporary: 0
data_paths: ['/var/lib/clickhouse/store/81b/81b1c20a-b7c6-4116-a2ce-7583fb6b6736/']
metadata_path: /var/lib/clickhouse/store/461/461cf698-fd0b-406d-8c01-5d8fd5748a91/t1.sql
metadata_modification_time: 2021-01-25 19:14:32
dependencies_database: []
dependencies_table: []
create_table_query: CREATE TABLE base.t1 (`n` UInt64) ENGINE = MergeTree ORDER BY n
engine_full: MergeTree ORDER BY n
as_select: SELECT database AS table_catalog
partition_key:
sorting_key: n
primary_key: n
sampling_key:
skipping_indices_types: []
storage_policy: default
total_rows: 1
total_bytes: 99
lifetime_rows: ᴺᵁᴸᴸ
lifetime_bytes: ᴺᵁᴸᴸ
comment:
has_own_data: 0
loading_dependencies_database: []
loading_dependencies_table: []
loading_dependent_database: []
loading_dependent_table: []
Row 2:
──────
database: default
name: 53r93yleapyears
uuid: 00000000-0000-0000-0000-000000000000
engine: MergeTree
is_temporary: 0
data_paths: ['/var/lib/clickhouse/data/default/53r93yleapyears/']
metadata_path: /var/lib/clickhouse/metadata/default/53r93yleapyears.sql
metadata_modification_time: 2020-09-23 09:05:36
dependencies_database: []
dependencies_table: []
create_table_query: CREATE TABLE default.`53r93yleapyears` (`id` Int8, `febdays` Int8) ENGINE = MergeTree ORDER BY id
engine_full: MergeTree ORDER BY id
as_select: SELECT name AS catalog_name
partition_key:
sorting_key: id
primary_key: id
sampling_key:
skipping_indices_types: []
storage_policy: default
total_rows: 2
total_bytes: 155
lifetime_rows: ᴺᵁᴸᴸ
lifetime_bytes: ᴺᵁᴸᴸ
comment:
has_own_data: 0
loading_dependencies_database: []
loading_dependencies_table: []
loading_dependent_database: []
loading_dependent_table: []