> ## 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](/ja/reference/data-types/string) 値を持つ行を返します。

* `name` — カラム名。
* `type` — カラムの型。
* `default_type` — カラムの[デフォルト式](/ja/reference/statements/create/table)で使用される句: `DEFAULT`、`MATERIALIZED`、または `ALIAS`。デフォルト式がない場合は、空文字列が返されます。
* `default_expression` — `DEFAULT` 句の後に指定される式。
* `comment` — [カラムコメント](/ja/reference/statements/alter/column#comment-column)。
* `codec_expression` — カラムに適用される [codec](/ja/reference/statements/create/table#column_compression_codec)。
* `ttl_expression` — [有効期限 (TTL)](/ja/reference/engines/table-engines/mergetree-family/mergetree#table_engine-mergetree-ttl) 式。
* `is_subcolumn` — 内部サブカラムの場合に `1` となるフラグ。[describe\_include\_subcolumns](/ja/reference/settings/session-settings#describe_include_subcolumns) 設定でサブカラム定義が有効になっている場合にのみ、結果に含まれます。

[Nested](/ja/reference/data-types/nested-data-structures) データ構造内のすべてのカラムは、それぞれ個別に記述されます。各カラム名には、親カラム名とドットがプレフィックスとして付きます。

他のデータ型の内部サブカラムを表示するには、[describe\_include\_subcolumns](/ja/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) │              │                    │         │                  │                │
└──────┴───────────────────────────────┴──────────────┴────────────────────┴─────────┴──────────────────┴────────────────┘
```

2つ目のクエリでは、サブカラムも表示されます:

```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](/ja/reference/settings/session-settings#describe_include_subcolumns) 設定。