> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-fix-nav-issues.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
> 모든 테이블의 컬럼 정보를 담은 시스템 테이블
# system.columns
## 설명
모든 테이블의 컬럼 정보를 포함합니다.
이 테이블을 사용하면 여러 테이블에 대해 한 번에 [DESCRIBE TABLE](/ko/reference/statements/describe-table) 쿼리와 유사한 정보를 확인할 수 있습니다.
[temporary tables](/ko/reference/statements/create/table#temporary-tables)의 컬럼은 해당 테이블이 생성된 session에서만 `system.columns`에 표시됩니다. 이 컬럼들은 `database` 필드가 비어 있는 상태로 표시됩니다.
## 컬럼
* `database` ([String](/ko/reference/data-types)) — 데이터베이스 이름입니다.
* `table` ([String](/ko/reference/data-types)) — 테이블 이름입니다.
* `name` ([String](/ko/reference/data-types)) — 컬럼 이름입니다.
* `type` ([String](/ko/reference/data-types)) — 컬럼 타입입니다.
* `position` ([UInt64](/ko/reference/data-types)) — 테이블에서 컬럼의 순서 위치이며 1부터 시작합니다.
* `default_kind` ([String](/ko/reference/data-types)) — 기본값의 표현식 타입(DEFAULT, MATERIALIZED, ALIAS)이며, 정의되지 않은 경우 빈 문자열입니다.
* `default_expression` ([String](/ko/reference/data-types)) — 기본값의 표현식이며, 정의되지 않은 경우 빈 문자열입니다.
* `data_compressed_bytes` ([UInt64](/ko/reference/data-types)) — 압축된 데이터 크기(바이트)입니다.
* `data_uncompressed_bytes` ([UInt64](/ko/reference/data-types)) — 압축 해제된 데이터 크기(바이트)입니다.
* `marks_bytes` ([UInt64](/ko/reference/data-types)) — 마크의 크기(바이트)입니다.
* `comment` ([String](/ko/reference/data-types)) — 컬럼 주석이며, 정의되지 않은 경우 빈 문자열입니다.
* `is_in_partition_key` ([UInt8](/ko/reference/data-types)) — 컬럼이 파티션 표현식에 포함되는지를 나타내는 플래그입니다.
* `is_in_sorting_key` ([UInt8](/ko/reference/data-types)) — 컬럼이 정렬 키 표현식에 포함되는지를 나타내는 플래그입니다.
* `is_in_primary_key` ([UInt8](/ko/reference/data-types)) — 컬럼이 프라이머리 키 표현식에 포함되는지를 나타내는 플래그입니다.
* `is_in_sampling_key` ([UInt8](/ko/reference/data-types)) — 컬럼이 샘플링 키 표현식에 포함되는지를 나타내는 플래그입니다.
* `compression_codec` ([String](/ko/reference/data-types)) — 압축 코덱 이름입니다.
* `character_octet_length` ([Nullable(UInt64)](/ko/reference/data-types)) — 바이너리 데이터, 문자 데이터 또는 텍스트 데이터와 이미지의 최대 길이(바이트)입니다. ClickHouse에서는 FixedString 데이터 타입에만 의미가 있습니다. 그 외에는 NULL 값이 반환됩니다.
* `numeric_precision` ([Nullable(UInt64)](/ko/reference/data-types)) — 근사 숫자 데이터, 정확한 숫자 데이터, 정수 데이터 또는 통화 데이터의 정밀도입니다. ClickHouse에서는 정수 타입의 비트 폭과 Decimal 타입의 정밀도를 의미합니다. 그 외에는 NULL 값이 반환됩니다.
* `numeric_precision_radix` ([Nullable(UInt64)](/ko/reference/data-types)) — 근사 숫자 데이터, 정확한 숫자 데이터, 정수 데이터 또는 통화 데이터의 정밀도에 사용되는 진법의 밑입니다. ClickHouse에서는 정수 타입의 경우 2, Decimal 타입의 경우 10입니다. 그 외에는 NULL 값이 반환됩니다.
* `numeric_scale` ([Nullable(UInt64)](/ko/reference/data-types)) — 근사 숫자 데이터, 정확한 숫자 데이터, 정수 데이터 또는 통화 데이터의 스케일입니다. ClickHouse에서는 Decimal 타입에만 의미가 있습니다. 그 외에는 NULL 값이 반환됩니다.
* `datetime_precision` ([Nullable(UInt64)](/ko/reference/data-types)) — DateTime64 데이터 타입의 소수 정밀도입니다. 다른 데이터 타입에서는 NULL 값이 반환됩니다.
* `serialization_hint` ([Nullable(String)](/ko/reference/data-types)) — 컬럼이 통계에 따라 삽입 시 사용할 직렬화를 선택하기 위한 힌트입니다.
* `statistics` ([String](/ko/reference/data-types)) — 이 컬럼에 생성된 통계의 타입입니다.
## 예시
```sql theme={null}
SELECT * FROM system.columns LIMIT 2 FORMAT Vertical;
```
```text theme={null}
Row 1:
──────
database: INFORMATION_SCHEMA
table: COLUMNS
name: table_catalog
type: String
position: 1
default_kind:
default_expression:
data_compressed_bytes: 0
data_uncompressed_bytes: 0
marks_bytes: 0
comment:
is_in_partition_key: 0
is_in_sorting_key: 0
is_in_primary_key: 0
is_in_sampling_key: 0
compression_codec:
character_octet_length: ᴺᵁᴸᴸ
numeric_precision: ᴺᵁᴸᴸ
numeric_precision_radix: ᴺᵁᴸᴸ
numeric_scale: ᴺᵁᴸᴸ
datetime_precision: ᴺᵁᴸᴸ
Row 2:
──────
database: INFORMATION_SCHEMA
table: COLUMNS
name: table_schema
type: String
position: 2
default_kind:
default_expression:
data_compressed_bytes: 0
data_uncompressed_bytes: 0
marks_bytes: 0
comment:
is_in_partition_key: 0
is_in_sorting_key: 0
is_in_primary_key: 0
is_in_sampling_key: 0
compression_codec:
character_octet_length: ᴺᵁᴸᴸ
numeric_precision: ᴺᵁᴸᴸ
numeric_precision_radix: ᴺᵁᴸᴸ
numeric_scale: ᴺᵁᴸᴸ
datetime_precision: ᴺᵁᴸᴸ
```