メインコンテンツへスキップ
メインコンテンツへスキップ

system.columns

説明

すべてのテーブル内のカラムに関する情報を格納しています。

このテーブルを使用すると、複数のテーブルに対してまとめて、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)) — 統計に基づいて挿入時にカラムのシリアライゼーションを選択するためのヒント。
  • statistics (String) — このカラムに対して作成される統計の種類。

別名:

  • columnname のエイリアス。

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:      ᴺᵁᴸᴸ