Passer au contenu principal

​
Description

Contient des informations sur les colonnes de toutes les tables. Vous pouvez utiliser cette table pour obtenir des informations similaires à celles de la requête DESCRIBE TABLE, mais pour plusieurs tables à la fois. Les colonnes des tables temporaires ne sont visibles dans system.columns que dans les sessions où elles ont été créées. Elles sont affichées avec le champ database vide.

​
Colonnes

  • database (String) — Nom de la base de données.
  • table (String) — Nom de la table.
  • name (String) — Nom de la colonne.
  • type (String) — Type de la colonne.
  • position (UInt64) — Position ordinale d’une colonne dans une table, à partir de 1.
  • default_kind (String) — Type d’expression (DEFAULT, MATERIALIZED, ALIAS) de la valeur par défaut, ou chaîne vide s’il n’est pas défini.
  • default_expression (String) — Expression de la valeur par défaut, ou chaîne vide si elle n’est pas définie.
  • data_compressed_bytes (UInt64) — Taille des données compressées, en octets.
  • data_uncompressed_bytes (UInt64) — Taille des données décompressées, en octets.
  • marks_bytes (UInt64) — Taille des marks, en octets.
  • comment (String) — Commentaire sur la colonne, ou chaîne vide s’il n’est pas défini.
  • is_in_partition_key (UInt8) — Indicateur signalant si la colonne figure dans l’expression de partition.
  • is_in_sorting_key (UInt8) — Indicateur signalant si la colonne figure dans l’expression de clé de tri.
  • is_in_primary_key (UInt8) — Indicateur signalant si la colonne figure dans l’expression de clé primaire.
  • is_in_sampling_key (UInt8) — Indicateur signalant si la colonne figure dans l’expression de clé d’échantillonnage.
  • compression_codec (String) — Nom du codec de compression.
  • character_octet_length (Nullable(UInt64)) — Longueur maximale, en octets, des données binaires, des données de caractères ou des données de texte et d’images. Dans ClickHouse, cela n’a de sens que pour le type de données FixedString. Sinon, la valeur NULL est renvoyée.
  • numeric_precision (Nullable(UInt64)) — Précision des données numériques approximatives, des données numériques exactes, des données entières ou des données monétaires. Dans ClickHouse, il s’agit de la largeur en bits pour les types entiers et de la précision décimale pour les types Decimal. Sinon, la valeur NULL est renvoyée.
  • numeric_precision_radix (Nullable(UInt64)) — Base du système de numération pour la précision des données numériques approximatives, des données numériques exactes, des données entières ou des données monétaires. Dans ClickHouse, c’est 2 pour les types entiers et 10 pour les types Decimal. Sinon, la valeur NULL est renvoyée.
  • numeric_scale (Nullable(UInt64)) — Échelle des données numériques approximatives, des données numériques exactes, des données entières ou des données monétaires. Dans ClickHouse, cela n’a de sens que pour les types Decimal. Sinon, la valeur NULL est renvoyée.
  • datetime_precision (Nullable(UInt64)) — Précision décimale du type de données DateTime64. Pour les autres types de données, la valeur NULL est renvoyée.
  • serialization_hint (Nullable(String)) — Indication permettant à une colonne de choisir la sérialisation lors des insertions en fonction des statistiques.
  • statistics (String) — Types de statistiques créés pour cette colonne.

​
Exemple

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:      ᴺᵁᴸᴸ
Dernière modification le 29 juin 2026