Skip to main content
Edit this page

columns

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

このテーブルを使用すると、複数のテーブルに対して一度にDESCRIBE TABLEクエリに似た情報を取得できます。

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

system.columns テーブルには以下のカラムが含まれています（カラムタイプは括弧内に示されています）：

  • 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 型に対する小数精度です。それ以外の場合は NULL 値が返されます。
  • numeric_precision_radix (Nullable(UInt64)) — 近似数値データ、正確な数値データ、整数データ、または貨幣データの正確さを表す数値システムの基数です。ClickHouseでは整数型に対しては2、Decimal 型に対しては10です。それ以外の場合は NULL 値が返されます。
  • numeric_scale (Nullable(UInt64)) — 近似数値データ、正確な数値データ、整数データ、または貨幣データのスケール。ClickHouseでは Decimal 型にのみ意味があります。それ以外の場合は NULL 値が返されます。
  • datetime_precision (Nullable(UInt64)) — DateTime64 データ型の小数精度。他のデータ型の場合は NULL 値が返されます。

例

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