Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs
49.6kGet Started

system.columns

View as MarkdownEdit this pageReport an issueSet up docs MCP

説明

すべてのテーブルのカラムに関する情報が含まれています。

このテーブルを使うと、DESCRIBE TABLE クエリと同様の情報を、複数のテーブルについて一度に取得できます。

一時テーブル のカラムは、作成されたセッションでのみ system.columns に表示されます。これらは database フィールドが空の状態で表示されます。

カラム

  • database (String) — データベース名。
  • table (String) — テーブル名。
  • name (String) — カラム名。
  • type (String) — カラム型。
  • position (UInt64) — テーブル内でのカラムの順序位置。1 から始まります。
  • default_kind (String) — デフォルト値の式の種類 (DEFAULT、MATERIALIZED、ALIAS) 。定義されていない場合は空文字列です。
  • default_expression (String) — デフォルト値の式。定義されていない場合は空文字列です。
  • data_compressed_bytes (UInt64) — 圧縮データのサイズ (バイト単位) 。
  • data_uncompressed_bytes (UInt64) — 解凍後のデータのサイズ (バイト単位) 。
  • marks_bytes (UInt64) — マークのサイズ (バイト単位) 。
  • comment (String) — カラムに関するコメント。定義されていない場合は空文字列です。
  • is_in_partition_key (UInt8) — カラムがパーティション式に含まれるかどうかを示すフラグ。
  • is_in_sorting_key (UInt8) — カラムがソートキー式に含まれるかどうかを示すフラグ。
  • is_in_primary_key (UInt8) — カラムが主キー式に含まれるかどうかを示すフラグ。
  • is_in_sampling_key (UInt8) — カラムがサンプリングキー式に含まれるかどうかを示すフラグ。
  • compression_codec (String) — 圧縮コーデック名。
  • character_octet_length (Nullable(UInt64)) — バイナリデータ、文字データ、テキストデータ、イメージの最大長 (バイト単位) 。ClickHouse では FixedString データ型でのみ意味を持ちます。それ以外の場合は、NULL 値が返されます。
  • numeric_precision (Nullable(UInt64)) — 近似数値データ、正確な数値データ、整数データ、または通貨データの精度。ClickHouse では、整数型ではビット幅、Decimal 型では10進精度を表します。それ以外の場合は、NULL 値が返されます。
  • numeric_precision_radix (Nullable(UInt64)) — 近似数値データ、正確な数値データ、整数データ、または通貨データの精度に用いる数値体系の基数。ClickHouse では、整数型は 2、Decimal 型は 10 です。それ以外の場合は、NULL 値が返されます。
  • numeric_scale (Nullable(UInt64)) — 近似数値データ、正確な数値データ、整数データ、または通貨データのスケール。ClickHouse では Decimal 型でのみ意味を持ちます。それ以外の場合は、NULL 値が返されます。
  • datetime_precision (Nullable(UInt64)) — DateTime64 データ型の小数精度。その他のデータ型では、NULL 値が返されます。
  • serialization_hint (Nullable(String)) — 統計情報に基づき、INSERT 時にカラムが使用するシリアライゼーションを選択するためのヒント。
  • statistics (String) — このカラムで作成される統計情報の種類。

別名:

  • column — name の別名。

例

SELECT * FROM system.columns LIMIT 2 FORMAT Vertical;
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:      ᴺᵁᴸᴸ
Navigation