Ajouter une colonne à une table

Nous utiliserons clickhouse-local :

clickhouse -m --output_format_pretty_row_numbers=

Supposons que nous ayons la table suivante :

CREATE TABLE events (
    date Date DEFAULT today(), 
    name String
) 
ENGINE = MergeTree
ORDER BY date;

Ajoutons un enregistrement :

INSERT INTO events (name) VALUES ('Alexey');

Et maintenant, interrogez la table events :

SELECT *
FROM events;

┌───────date─┬─name───┐
│ 2024-12-18 │ Alexey │
└────────────┴────────┘

Ajout d’une nouvelle colonne

Supposons maintenant que nous voulions ajouter une nouvelle colonne appelée favoriteNumber, qui sera de type Float64. Nous pouvons le faire à l’aide de la clause ALTER TABLE...ADD COLUMN :

ALTER TABLE events 
ADD COLUMN favoriteNumber Float64 DEFAULT 7;

Si l’on interroge la table events, on obtient le résultat suivant :

┌───────date─┬─name───┬─favoriteNumber─┐
│ 2024-12-18 │ Alexey │              7 │
└────────────┴────────┴────────────────┘

La ligne Alexey a par défaut la valeur 7, puisque cette colonne n’existait pas lorsque nous avons ajouté cette ligne. Ensuite, ajoutons une autre colonne :

INSERT INTO events (name) VALUES ('Tyler');

Si l’on interroge la table events, on verra le résultat suivant :

┏━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━━┓
┃       date ┃ name   ┃ favoriteNumber ┃
┡━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━━┩
│ 2024-12-18 │ Tyler  │              7 │
├────────────┼────────┼────────────────┤
│ 2024-12-18 │ Alexey │              7 │
└────────────┴────────┴────────────────┘

Modification de la valeur par défaut d’une colonne

Si l’on modifie la colonne favoriteNumber pour lui attribuer un type différent à l’aide de la clause ALTER TABLE...MODIFY COLUMN, les choses deviennent intéressantes :

ALTER TABLE events 
MODIFY COLUMN favoriteNumber Float64 DEFAULT 99;

Si nous interrogeons de nouveau events, nous verrons le résultat suivant :

┏━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━━┓
┃       date ┃ name   ┃ favoriteNumber ┃
┡━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━━┩
│ 2024-12-18 │ Tyler  │              7 │
├────────────┼────────┼────────────────┤
│ 2024-12-18 │ Alexey │             99 │
└────────────┴────────┴────────────────┘

Tyler conserve la valeur 7, qui était la valeur par défaut lorsque cette ligne a été créée. Alexey prend la nouvelle valeur par défaut de 99, car la colonne favoriteNumber n’existait pas lorsque cette ligne a été créée. Si nous voulons que la ligne Alexey utilise immédiatement la valeur par défaut actuelle, nous devons appeler OPTIMIZE TABLE pour forcer l’écriture des valeurs par défaut actuelles sur le disque :

OPTIMIZE TABLE events;

Une fois cela fait, supposons que nous modifiions à nouveau la valeur par défaut :

ALTER TABLE events 
MODIFY COLUMN favoriteNumber Float64 DEFAULT 21;

Ensuite, insérez une autre ligne :

INSERT INTO events (name) VALUES ('Tanya');

Enfin, interrogeons à nouveau events :

┏━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━━┓
┃       date ┃ name   ┃ favoriteNumber ┃
┡━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━━┩
│ 2024-12-18 │ Alexey │             99 │
├────────────┼────────┼────────────────┤
│ 2024-12-18 │ Tyler  │              7 │
├────────────┼────────┼────────────────┤
│ 2024-12-18 │ Tanya  │             21 │
└────────────┴────────┴────────────────┘

Tanya hérite de la nouvelle valeur par défaut 21, tandis que Alexey conserve l’ancienne valeur par défaut 99.

Contrôler la position d’une colonne dans une table

Lorsque nous ajoutons une nouvelle colonne, elle est ajoutée par défaut à la fin de la table. Nous pouvons toutefois utiliser les clauses FIRST et AFTER pour déterminer la position d’une colonne. Par exemple, si nous voulions ajouter une colonne appelée favoriteColor après la colonne name, nous pourrions procéder ainsi :

ALTER TABLE events
ADD COLUMN favoriteColor String DEFAULT 'Yellow' AFTER name;

Interrogeons events :

┏━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━┓
┃       date ┃ name   ┃ favoriteColor ┃ favoriteNumber ┃
┡━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━┩
│ 2024-12-18 │ Alexey │ Yellow        │             99 │
├────────────┼────────┼───────────────┼────────────────┤
│ 2024-12-18 │ Tyler  │ Yellow        │              7 │
├────────────┼────────┼───────────────┼────────────────┤
│ 2024-12-18 │ Tanya  │ Yellow        │             21 │
└────────────┴────────┴───────────────┴────────────────┘

Et si nous voulions ajouter une colonne favoriteDatabase et la faire figurer en tête de liste, nous pourrions procéder ainsi :

ALTER TABLE events
ADD COLUMN favoriteDatabase String DEFAULT 'ClickHouse' FIRST;

┏━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━┓
┃ favoriteDatabase ┃       date ┃ name   ┃ favoriteColor ┃ favoriteNumber ┃
┡━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━┩
│ ClickHouse       │ 2024-12-18 │ Tanya  │ Yellow        │             21 │
├──────────────────┼────────────┼────────┼───────────────┼────────────────┤
│ ClickHouse       │ 2024-12-18 │ Alexey │ Yellow        │             99 │
├──────────────────┼────────────┼────────┼───────────────┼────────────────┤
│ ClickHouse       │ 2024-12-18 │ Tyler  │ Yellow        │              7 │
└──────────────────┴────────────┴────────┴───────────────┴────────────────┘

Voyons maintenant la définition de la table :

SHOW CREATE TABLE events
FORMAT LineAsString

CREATE TABLE default.`clickhouse-local-ab404c86-56cc-495b-ad1d-fb343cac3bc0events`
(
    `favoriteDatabase` String DEFAULT 'ClickHouse',
    `date` Date DEFAULT today(),
    `name` String,
    `favoriteColor` String DEFAULT 'Yellow',
    `favoriteNumber` Float64 DEFAULT 21
)
ENGINE = MergeTree
ORDER BY date