メインコンテンツまでスキップ
メインコンテンツまでスキップ

system.columns

カラムに関する情報をすべてのテーブルから取得できます。

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

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

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

  • databaseString) — データベース名。
  • tableString) — テーブル名。
  • nameString) — カラム名。
  • typeString) — カラムタイプ。
  • positionUInt64) — テーブルにおけるカラムの序列位置(1から始まる)。
  • default_kindString) — デフォルト値の式タイプ(DEFAULTMATERIALIZEDALIAS)、未定義の場合は空文字列。
  • default_expressionString) — デフォルト値の式、未定義の場合は空文字列。
  • data_compressed_bytesUInt64) — 圧縮データのサイズ(バイト単位)。
  • data_uncompressed_bytesUInt64) — 非圧縮データのサイズ(バイト単位)。
  • marks_bytesUInt64) — マークのサイズ(バイト単位)。
  • commentString) — カラムに関するコメント、未定義の場合は空文字列。
  • is_in_partition_keyUInt8) — カラムがパーティション式に含まれているかどうかを示すフラグ。
  • is_in_sorting_keyUInt8) — カラムがソートキー式に含まれているかどうかを示すフラグ。
  • is_in_primary_keyUInt8) — カラムが主キー式に含まれているかどうかを示すフラグ。
  • is_in_sampling_keyUInt8) — カラムがサンプリングキー式に含まれているかどうかを示すフラグ。
  • compression_codecString) — 圧縮コーデックの名前。
  • character_octet_lengthNullable(UInt64)) — バイナリデータ、文字データ、テキストデータ、画像の最大長(バイト単位)。ClickHouseでは FixedString データタイプに対してのみ意味を持ちます。それ以外の場合は NULL 値が返されます。
  • numeric_precisionNullable(UInt64)) — おおよその数値データ、正確な数値データ、整数データ、または金銭データの精度。ClickHouseでは整数タイプのビット幅と Decimal タイプの小数精度です。それ以外の場合は NULL 値が返されます。
  • numeric_precision_radixNullable(UInt64)) — おおよその数値データ、正確な数値データ、整数データ、または金銭データの精度を表す数値システムの基数。ClickHouseでは整数タイプには 2、Decimal タイプには 10 が対応します。それ以外の場合は NULL 値が返されます。
  • numeric_scaleNullable(UInt64)) — おおよその数値データ、正確な数値データ、整数データ、または金銭データのスケール。ClickHouseでは Decimal タイプに対してのみ意味を持ちます。それ以外の場合は NULL 値が返されます。
  • datetime_precisionNullable(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:      ᴺᵁᴸᴸ