Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs
49.6kGet Started

Fonctions conditionnelles

View as MarkdownEdit this pageReport an issueSet up docs MCP

Vue d’ensemble

Utiliser directement les résultats conditionnels

Les expressions conditionnelles renvoient toujours 0, 1 ou NULL. Vous pouvez donc utiliser directement ces résultats, comme ceci :

SELECT left < right AS is_small
FROM LEFT_RIGHT

┌

Valeurs NULL dans les expressions conditionnelles

Lorsque des valeurs NULL entrent en jeu dans des expressions conditionnelles, le résultat est également NULL.

SELECT
    NULL < 1,
    2 < NULL,
    NULL < NULL,
    NULL = NULL

┌

Vous devez donc construire vos requêtes avec soin si les types sont Nullable.

L’exemple suivant l’illustre en omettant d’ajouter une condition equals à multiIf.

SELECT
    left,
    right,
    multiIf(left < right, 'left is smaller', left > right, 'right is smaller', 'Both equal') AS faulty_result
FROM LEFT_RIGHT

┌

Instruction CASE

L'expression CASE dans ClickHouse fournit une logique conditionnelle similaire à celle de l'opérateur SQL CASE. Elle évalue les conditions et renvoie des valeurs en fonction de la première condition satisfaite.

ClickHouse prend en charge deux formes de CASE :

  1. CASE WHEN ... THEN ... ELSE ... END
    Cette forme offre une flexibilité totale et est implémentée en interne à l'aide de la fonction multiIf. Chaque condition est évaluée indépendamment, et les expressions peuvent inclure des valeurs non constantes.
SELECT
    number,
    CASE
        WHEN number % 2 = 0 THEN number + 1
        WHEN number % 2 = 1 THEN number * 10
        ELSE number
    END AS result
FROM system.numbers
WHERE number < 5;

-- is translated to
SELECT
    number,
    multiIf((number % 2) = 0, number + 1, (number % 2) = 1, number * 10, number) AS result
FROM system.numbers
WHERE number < 5

┌
  1. CASE <expr> WHEN <val1> THEN ... WHEN <val2> THEN ... ELSE ... END
    Cette forme plus compacte est optimisée pour la mise en correspondance de valeurs constantes et utilise en interne caseWithExpression().

Par exemple, l'exemple suivant est valide :

SELECT
    number,
    CASE number
        WHEN 0 THEN 100
        WHEN 1 THEN 200
        ELSE 0
    END AS result
FROM system.numbers
WHERE number < 3;

-- is translated to

SELECT
    number,
    caseWithExpression(number, 0, 100, 1, 200, 0) AS result
FROM system.numbers
WHERE number < 3

┌

Cette forme n’exige pas non plus que les expressions de résultat soient des constantes.

SELECT
    number,
    CASE number
        WHEN 0 THEN number + 1
        WHEN 1 THEN number * 10
        ELSE number
    END
FROM system.numbers
WHERE number < 3;

-- is translated to

SELECT
    number,
    caseWithExpression(number, 0, number + 1, 1, number * 10, number)
FROM system.numbers
WHERE number < 3

┌

Mises en garde

ClickHouse détermine le type de résultat d’une expression CASE (ou de son équivalent interne, tel que multiIf) avant d’évaluer les conditions. C’est important lorsque les expressions renvoyées sont de types différents, par exemple avec des fuseaux horaires ou des types numériques distincts.

  • Le type de résultat est choisi en fonction du plus grand type compatible parmi toutes les branches.
  • Une fois ce type choisi, toutes les autres branches y sont converties implicitement, même si leur logique ne serait jamais exécutée au runtime.
  • Pour des types comme DateTime64, où le fuseau horaire fait partie de la signature du type, cela peut entraîner un comportement surprenant : le premier fuseau horaire rencontré peut être utilisé pour toutes les branches, même lorsque d’autres branches spécifient des fuseaux horaires différents.

Par exemple, ci-dessous, toutes les lignes renvoient le timestamp dans le fuseau horaire de la première branche correspondante, c.-à-d. Asia/Kolkata

SELECT
    number,
    CASE
        WHEN number = 0 THEN fromUnixTimestamp64Milli(0, 'Asia/Kolkata')
        WHEN number = 1 THEN fromUnixTimestamp64Milli(0, 'America/Los_Angeles')
        ELSE fromUnixTimestamp64Milli(0, 'UTC')
    END AS tz
FROM system.numbers
WHERE number < 3;

-- is translated to

SELECT
    number,
    multiIf(number = 0, fromUnixTimestamp64Milli(0, 'Asia/Kolkata'), number = 1, fromUnixTimestamp64Milli(0, 'America/Los_Angeles'), fromUnixTimestamp64Milli(0, 'UTC')) AS tz
FROM system.numbers
WHERE number < 3

┌

Ici, ClickHouse voit plusieurs types de retour DateTime64(3, <timezone>). Il déduit que le type commun est DateTime64(3, 'Asia/Kolkata', car c’est le premier qu’il rencontre, et convertit implicitement les autres branches vers ce type.

On peut résoudre ce problème en convertissant en chaîne de caractères afin de préserver le formatage souhaité du fuseau horaire :

SELECT
    number,
    multiIf(
        number = 0, formatDateTime(fromUnixTimestamp64Milli(0), '%F %T', 'Asia/Kolkata'),
        number = 1, formatDateTime(fromUnixTimestamp64Milli(0), '%F %T', 'America/Los_Angeles'),
        formatDateTime(fromUnixTimestamp64Milli(0), '%F %T', 'UTC')
    ) AS tz
FROM system.numbers
WHERE number < 3;

-- is translated to

SELECT
    number,
    multiIf(number = 0, formatDateTime(fromUnixTimestamp64Milli(0), '%F %T', 'Asia/Kolkata'), number = 1, formatDateTime(fromUnixTimestamp64Milli(0), '%F %T', 'America/Los_Angeles'), formatDateTime(fromUnixTimestamp64Milli(0), '%F %T', 'UTC')) AS tz
FROM system.numbers
WHERE number < 3

┌

clamp

Introduit dans : v24.5.0

Contraint une valeur à rester dans les bornes minimale et maximale spécifiées.

Si la valeur est inférieure au minimum, renvoie le minimum. Si la valeur est supérieure au maximum, renvoie le maximum. Sinon, renvoie la valeur elle-même.

Tous les arguments doivent être de types comparables. Le type du résultat est le plus grand type compatible parmi tous les arguments.

Syntaxe

clamp(value, min, max)

Arguments

  • value — La valeur à borner. - min — La borne minimale. - max — La borne maximale.

Valeur renvoyée

Renvoie la valeur, limitée à l’intervalle [min, max].

Exemples

Utilisation de base

SELECT clamp(5, 1, 10) AS result;
┌─result─┐
│      5 │
└────────┘

Valeur en dessous du minimum

SELECT clamp(-3, 0, 7) AS result;
┌─result─┐
│      0 │
└────────┘

Valeur au-dessus du maximum

SELECT clamp(15, 0, 7) AS result;
┌─result─┐
│      7 │
└────────┘

greatest

Introduit dans : v1.1.0

Renvoie la plus grande valeur parmi les arguments. Les arguments NULL sont ignorés.

  • Pour les tableaux, renvoie le tableau le plus grand dans l’ordre lexicographique.
  • Pour les types DateTime, le type de résultat est promu au type le plus large (par exemple, DateTime64 en cas de mélange avec DateTime32).

Syntaxe

greatest(x1[, x2, ...])

Arguments

  • x1[, x2, ...] — Une ou plusieurs valeurs à comparer. Tous les arguments doivent être de types comparables. Any

Valeur renvoyée

Renvoie la plus grande valeur parmi les arguments, promue au plus grand type compatible. Any

Exemples

Types numériques

-- The type returned is a Float64 as the UInt8 must be promoted to 64 bit for the comparison.
SELECT greatest(1, 2, toUInt8(3), 3.) AS result, toTypeName(result) AS type;
┌─result─┬─type────┐
│      3 │ Float64 │
└────────┴─────────┘

Tableaux

SELECT greatest(['hello'], ['there'], ['world']);
┌─greatest(['hello'], ['there'], ['world'])─┐
│ ['world']                                 │
└───────────────────────────────────────────┘

Types DateTime

-- The type returned is a DateTime64 as the DateTime32 must be promoted to 64 bit for the comparison.
SELECT greatest(toDateTime32('2025-01-02 12:00:00'), toDateTime64('2025-01-01 12:00:00.000', 3));
┌─greatest(toDateTime32('2025-01-02 12:00:00'), toDateTime64('2025-01-01 12:00:00.000', 3))─┐
│                                                                   2025-01-02 12:00:00.000 │
└───────────────────────────────────────────────────────────────────────────────────────────┘

if

Introduit dans : v1.1.0

Effectue un branchement conditionnel.

  • Si la condition cond s'évalue à une valeur non nulle, la fonction renvoie le résultat de l'expression then.
  • Si cond s'évalue à zéro ou à NULL, le résultat de l'expression else est renvoyé.

Le paramètre short_circuit_function_evaluation détermine si l'évaluation en court-circuit est utilisée.

S'il est activé, l'expression then n'est évaluée que sur les lignes où cond est true, et l'expression else sur celles où cond est false.

Par exemple, avec l'évaluation en court-circuit, aucune exception de division par zéro n'est levée lors de l'exécution de la requête suivante :

SELECT if(number = 0, 0, intDiv(42, number)) FROM numbers(10)

then et else doivent être de type similaire.

Syntaxe

if(cond, then, else)

Arguments

  • cond — La condition évaluée. UInt8 ou Nullable(UInt8) ou NULL
  • then — L'expression renvoyée si cond est true. - else — L'expression renvoyée si cond est false ou NULL.

Valeur renvoyée

Le résultat de l'expression then ou else, selon la condition cond.

Exemples

Exemple d’utilisation

SELECT if(1, 2 + 2, 2 + 6) AS res;
┌─res─┐
│   4 │
└─────┘

least

Introduit dans : v1.1.0

Renvoie la plus petite valeur parmi les arguments. Les arguments NULL sont ignorés.

  • Pour les tableaux, renvoie le tableau le plus petit selon l’ordre lexicographique.
  • Pour les types DateTime, le type de résultat est promu au type le plus large (par ex. DateTime64 s’il est mélangé à DateTime32).

Syntaxe

least(x1[, x2, ...])

Arguments

  • x1[, x2, ...] — Une seule valeur ou plusieurs valeurs à comparer. Tous les arguments doivent être de types comparables. Any

Valeur renvoyée

Renvoie la plus petite valeur parmi les arguments, promue au plus grand type compatible. Any

Exemples

Types numériques

-- The type returned is a Float64 as the UInt8 must be promoted to 64 bit for the comparison.
SELECT least(1, 2, toUInt8(3), 3.) AS result, toTypeName(result) AS type;
┌─result─┬─type────┐
│      1 │ Float64 │
└────────┴─────────┘

Tableaux

SELECT least(['hello'], ['there'], ['world']);
┌─least(['hello'], ['there'], ['world'])─┐
│ ['hello']                              │
└────────────────────────────────────────┘

Types DateTime

-- The type returned is a DateTime64 as the DateTime32 must be promoted to 64 bit for the comparison.
SELECT least(toDateTime32('2025-01-02 12:00:00'), toDateTime64('2025-01-01 12:00:00.000', 3));
┌─least(toDateTime32('2025-01-02 12:00:00'), toDateTime64('2025-01-01 12:00:00.000', 3))─┐
│                                                                2025-01-01 12:00:00.000 │
└────────────────────────────────────────────────────────────────────────────────────────┘

multiIf

Introduit dans : v1.1.0

Permet d'écrire l'opérateur CASE de manière plus compacte dans la requête. Évalue chaque condition dans l'ordre. Pour la première condition qui est vraie (non égale à zéro et différente de NULL), renvoie la valeur correspondante. Si aucune des conditions n'est vraie, renvoie la valeur else.

Le paramètre short_circuit_function_evaluation contrôle si l'évaluation en court-circuit est utilisée. S'il est activé, l'expression then_i est évaluée uniquement sur les lignes où ((NOT cond_1) AND ... AND (NOT cond_{i-1}) AND cond_i) est vraie.

Par exemple, avec l'évaluation en court-circuit, aucune exception de division par zéro n'est levée lors de l'exécution de la requête suivante :

SELECT multiIf(number = 2, intDiv(1, number), number = 5) FROM numbers(10)

Toutes les expressions des branches et de else doivent avoir un supertype commun. Les conditions NULL sont considérées comme false.

Syntaxe

multiIf(cond_1, then_1, cond_2, then_2, ..., else)

Alias : caseWithoutExpression, caseWithoutExpr

Arguments

  • cond_N — La N-ième condition évaluée, qui détermine si then_N est renvoyé. UInt8 ou Nullable(UInt8) ou NULL
  • then_N — Le résultat de la fonction lorsque cond_N est true. - else — Le résultat de la fonction si aucune des conditions n’est true.

Valeur renvoyée

Renvoie le résultat de then_N pour le cond_N correspondant, sinon renvoie la valeur else.

Exemples

Exemple d’utilisation

CREATE TABLE LEFT_RIGHT (left Nullable(UInt8), right Nullable(UInt8)) ENGINE = Memory;
INSERT INTO LEFT_RIGHT VALUES (NULL, 4), (1, 3), (2, 2), (3, 1), (4, NULL);

SELECT
    left,
    right,
    multiIf(left < right, 'left is smaller', left > right, 'left is greater', left = right, 'Both equal', 'Null value') AS result
FROM LEFT_RIGHT;
┌─left─┬─right─┬─result──────────┐
│ ᴺᵁᴸᴸ │     4 │ Null value      │
│    1 │     3 │ left is smaller │
│    2 │     2 │ Both equal      │
│    3 │     1 │ left is greater │
│    4 │  ᴺᵁᴸᴸ │ Null value      │
└──────┴───────┴─────────────────┘
Navigation