> ## 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.

> DESCRIBE TABLE 문서

# DESCRIBE TABLE

테이블 컬럼 정보를 반환합니다.

**구문**

```sql theme={null}
DESC|DESCRIBE TABLE [db.]table [INTO OUTFILE filename] [FORMAT format]
```

`DESCRIBE` 문은 각 테이블 컬럼에 대해 다음 [String](/ko/reference/data-types/string) 값을 가진 하나의 행을 반환합니다:

* `name` — 컬럼 이름입니다.
* `type` — 컬럼 타입입니다.
* `default_type` — 컬럼 [기본 표현식](/ko/reference/statements/create/table)에 사용되는 절입니다: `DEFAULT`, `MATERIALIZED` 또는 `ALIAS`. 기본 표현식이 없으면 빈 문자열이 반환됩니다.
* `default_expression` — `DEFAULT` 절 뒤에 지정된 표현식입니다.
* `comment` — [컬럼 주석](/ko/reference/statements/alter/column#comment-column)입니다.
* `codec_expression` — 컬럼에 적용되는 [코덱](/ko/reference/statements/create/table#column_compression_codec)입니다.
* `ttl_expression` — [TTL](/ko/reference/engines/table-engines/mergetree-family/mergetree#table_engine-mergetree-ttl) 표현식입니다.
* `is_subcolumn` — 내부 서브컬럼이면 `1`이 되는 플래그입니다. [describe\_include\_subcolumns](/ko/reference/settings/session-settings#describe_include_subcolumns) 설정으로 서브컬럼 설명이 활성화된 경우에만 결과에 포함됩니다.

[Nested](/ko/reference/data-types/nested-data-structures) 데이터 구조의 모든 컬럼은 각각 별도로 설명됩니다. 각 컬럼 이름에는 상위 컬럼 이름과 점이 접두사로 붙습니다.

다른 데이터 타입의 내부 서브컬럼을 표시하려면 [describe\_include\_subcolumns](/ko/reference/settings/session-settings#describe_include_subcolumns) 설정을 사용하십시오.

**예시**

```sql title="Query" theme={null}
CREATE TABLE describe_example (
    id UInt64, text String DEFAULT 'unknown' CODEC(ZSTD),
    user Tuple (name String, age UInt8)
) ENGINE = MergeTree() ORDER BY id;

DESCRIBE TABLE describe_example;
DESCRIBE TABLE describe_example SETTINGS describe_include_subcolumns=1;
```

```text title="Response" theme={null}
┌─name─┬─type──────────────────────────┬─default_type─┬─default_expression─┬─comment─┬─codec_expression─┬─ttl_expression─┐
│ id   │ UInt64                        │              │                    │         │                  │                │
│ text │ String                        │ DEFAULT      │ 'unknown'          │         │ ZSTD(1)          │                │
│ user │ Tuple(name String, age UInt8) │              │                    │         │                  │                │
└──────┴───────────────────────────────┴──────────────┴────────────────────┴─────────┴──────────────────┴────────────────┘
```

두 번째 쿼리에서는 서브컬럼도 추가로 표시됩니다:

```text title="Response" theme={null}
┌─name──────┬─type──────────────────────────┬─default_type─┬─default_expression─┬─comment─┬─codec_expression─┬─ttl_expression─┬─is_subcolumn─┐
│ id        │ UInt64                        │              │                    │         │                  │                │            0 │
│ text      │ String                        │ DEFAULT      │ 'unknown'          │         │ ZSTD(1)          │                │            0 │
│ user      │ Tuple(name String, age UInt8) │              │                    │         │                  │                │            0 │
│ user.name │ String                        │              │                    │         │                  │                │            1 │
│ user.age  │ UInt8                         │              │                    │         │                  │                │            1 │
└───────────┴───────────────────────────────┴──────────────┴────────────────────┴─────────┴──────────────────┴────────────────┴──────────────┘
```

DESCRIBE 문은 서브쿼리나 스칼라 표현식에도 사용할 수 있습니다:

```SQL theme={null}
DESCRIBE SELECT 1 FORMAT TSV;
```

또는

```SQL theme={null}
DESCRIBE (SELECT 1) FORMAT TSV;
```

```text title="Response" theme={null}
1       UInt8
```

이 사용 방식은 지정된 쿼리 또는 서브쿼리의 결과 컬럼에 대한 메타데이터를 반환합니다. 실행하기 전에 복잡한 쿼리의 구조를 파악하는 데 유용합니다.

**관련 항목**

* [describe\_include\_subcolumns](/ko/reference/settings/session-settings#describe_include_subcolumns) 설정.