Функции сравнения

Правила сравнения

Перечисленные ниже функции сравнения возвращают значения 0 или 1 типа UInt8. Сравнивать можно только значения внутри одной группы (например, UInt16 и UInt64), но не между группами (например, UInt16 и DateTime). Возможны сравнения чисел и строк, а также строк с датами и дат с временем. Для кортежей и массивов используется лексикографическое сравнение, то есть сравнение выполняется для каждого соответствующего элемента кортежа/массива слева и справа.

Сравнивать можно следующие типы:

• числа и десятичные числа
• строки и строки фиксированной длины
• даты
• даты со временем
• кортежи (лексикографическое сравнение)
• массивы (лексикографическое сравнение)

Примечание

Строки сравниваются побайтно. Это может приводить к неожиданным результатам, если одна из строк содержит многобайтовые символы в кодировке UTF-8. Строка S1, для которой строка S2 является префиксом, считается более длинной, чем S2.

equals

Добавлена в версии: v1.1

Сравнивает два значения на равенство.

Синтаксис

equals(a, b)
        -- a = b
        -- a == b

Аргументы

• a — первое значение.^* - b — второе значение.^*

Возвращаемое значение

Возвращает 1, если a равно b, иначе 0 типа UInt8.

Примеры

Пример использования

SELECT 1 = 1, 1 = 2;

┌─equals(1, 1)─┬─equals(1, 2)─┐
│            1 │            0 │
└──────────────┴──────────────┘

greater

Добавлена в версии v1.1

Проверяет, является ли одно значение больше другого.

Синтаксис

greater(a, b)
    -- a > b

Аргументы

• a — Первое значение.^* - b — Второе значение.^*

Возвращаемое значение

Возвращает 1, если a больше b, иначе 0 типа UInt8

Примеры

Пример использования

SELECT 2 > 1, 1 > 2;

┌─greater(2, 1)─┬─greater(1, 2)─┐
│             1 │             0 │
└───────────────┴───────────────┘

greaterOrEquals

Появилась в версии: v1.1

Сравнивает два значения, проверяя, выполняется ли отношение «больше или равно».

Синтаксис

greaterOrEquals(a, b)
    -- a >= b

Аргументы

• a — первое значение.^* - b — второе значение.^*

Возвращаемое значение

Возвращает 1, если a больше либо равно b, в противном случае — 0 типа UInt8.

Примеры

Пример использования

SELECT 2 >= 1, 2 >= 2, 1 >= 2;

┌─greaterOrEquals(2, 1)─┬─greaterOrEquals(2, 2)─┬─greaterOrEquals(1, 2)─┐
│                     1 │                     1 │                     0 │
└───────────────────────┴───────────────────────┴───────────────────────┘

isDistinctFrom

Введена в версии: v25.11

Выполняет NULL-безопасное сравнение «не равно» между двумя значениями. Возвращает true, если значения различаются (не равны), включая случай, когда одно значение равно NULL, а другое — нет. Возвращает false, если значения равны или если оба равны NULL.

Синтаксис

isDistinctFrom(x, y)

Аргументы

• x — первое значение для сравнения. Может иметь любой тип данных ClickHouse. Any
• y — второе значение для сравнения. Может иметь любой тип данных ClickHouse. Any

Возвращаемое значение

Возвращает true, если два значения различаются, при этом NULL считаются сравнимыми значениями:

• Возвращает true, если x != y.
  • Возвращает true, если ровно одно из x или y равно NULL.
  • Возвращает false, если x = y или оба x и y равны NULL. Bool

Примеры

Базовое использование с числами и NULL

SELECT
    isDistinctFrom(1, 2) AS result_1,
    isDistinctFrom(1, 1) AS result_2,
    isDistinctFrom(NULL, 1) AS result_3,
    isDistinctFrom(NULL, NULL) AS result_4

┌─result_1─┬─result_2─┬─result_3─┬─result_4─┐
│        1 │        0 │        1 │        0 │
└──────────┴──────────┴──────────┴──────────┘

isNotDistinctFrom

Добавлена в версии: v25.10

Выполняет безопасное в отношении NULL сравнение на равенство между двумя значениями. Возвращает true, если значения равны, включая случай, когда оба равны NULL. Возвращает false, если значения различаются или если ровно одно из них равно NULL.

Синтаксис

isNotDistinctFrom(x, y)

Аргументы

• x — первое значение для сравнения. Может быть любого типа данных ClickHouse. Any
• y — второе значение для сравнения. Может быть любого типа данных ClickHouse. Any

Возвращаемое значение

Возвращает true, если два значения равны, считая значения NULL сравнимыми:

• Возвращает true, если x = y.
  • Возвращает true, если и x, и y равны NULL.
  • Возвращает false, если x != y или только одно из x или y равно NULL. Bool

Примеры

Базовое использование с числами и NULL

SELECT
    isNotDistinctFrom(1, 1) AS result_1,
    isNotDistinctFrom(1, 2) AS result_2,
    isNotDistinctFrom(NULL, NULL) AS result_3,
    isNotDistinctFrom(NULL, 1) AS result_4

┌─result_1─┬─result_2─┬─result_3─┬─result_4─┐
│        1 │        0 │        1 │        0 │
└──────────┴──────────┴──────────┴──────────┘

less

Впервые появилась в версии: v1.1

Сравнивает два значения на предмет отношения «меньше чем».

Синтаксис

less(a, b)
    -- a < b

Аргументы

• a — первое значение.^* - b — второе значение.^*

Возвращаемое значение

Возвращает 1, если a меньше b, в противном случае — 0 UInt8.

Примеры

Пример использования

SELECT 1 < 2, 2 < 1;

┌─less(1, 2)─┬─less(2, 1)─┐
│          1 │          0 │
└────────────┴────────────┘

lessOrEquals

Добавлена в версии: v1.1

Сравнивает два значения на предмет отношения «меньше или равно».

Синтаксис

lessOrEquals(a, b)
-- a <= b

Аргументы

• a — первое значение.^* - b — второе значение.^*

Возвращаемое значение

Возвращает 1, если a меньше или равно b, иначе — 0 (типа UInt8).

Примеры

Пример использования

SELECT 1 <= 2, 2 <= 2, 3 <= 2;

┌─lessOrEquals(1, 2)─┬─lessOrEquals(2, 2)─┬─lessOrEquals(3, 2)─┐
│                  1 │                  1 │                  0 │
└────────────────────┴────────────────────┴────────────────────┘

notEquals

Появилась в версии: v1.1

Сравнивает два значения на неравенство.

Синтаксис

notEquals(a, b)
    -- a != b
    -- a <> b

Аргументы

• a — первое значение.^* - b — второе значение.^*

Возвращаемое значение

Возвращает 1, если a не равно b, в противном случае — 0. UInt8

Примеры

Пример использования

SELECT 1 != 2, 1 != 1;

┌─notEquals(1, 2)─┬─notEquals(1, 1)─┐
│               1 │               0 │
└─────────────────┴─────────────────┘