演算子

ClickHouse は、クエリの解析時に、演算子をその優先度、優先順位、および結合性に従って対応する関数へ変換します。

アクセス演算子

a[N] – 配列の要素へのアクセス。arrayElement(a, N) 関数。

a.N – タプルの要素へのアクセス。tupleElement(a, N) 関数。

数値の符号反転演算子

-a – negate(a) 関数。

タプルの符号反転: tupleNegate。

乗算および除算演算子

a * b – multiply (a, b) 関数。

タプルを数値で乗算する場合: tupleMultiplyByNumber、スカラー積の場合: dotProduct。

a / b – divide(a, b) 関数。

タプルを数値で除算する場合: tupleDivideByNumber。

a % b – modulo(a, b) 関数。

加算および減算演算子

a + b – plus(a, b) 関数。

タプルの加算: tuplePlus。

a - b – minus(a, b) 関数。

タプルの減算: tupleMinus。

比較演算子

equals 関数

a = b – equals(a, b) 関数と同じです。

a == b – equals(a, b) 関数と同じです。

notEquals 関数

a != b – notEquals(a, b) 関数。

a <> b – notEquals(a, b) 関数。

lessOrEquals関数

a <= b – lessOrEquals(a, b) 関数を表します。

lessOrEquals関数

a >= b – greaterOrEquals(a, b) 関数です。

greaterOrEquals関数

a < b – less(a, b) 関数。

less関数

a > b – less(a, b) 関数。

like関数

a LIKE b – like(a, b) 関数です。

notLike 関数

a LIKE b – like(a, b)関数

notLike関数

a NOT LIKE b – notLike(a, b)関数。

ilike関数

a BETWEEN b AND c – a >= b AND a <= c と同じ意味です。

a NOT BETWEEN b AND c – a < b OR a > c と同じ意味です。

is not distinct from 演算子 (`<=>`)

注記

バージョン 25.10 以降では、<=> を他の演算子と同様に使用できます。バージョン 25.10 より前では、次の例のように JOIN 式の中でのみ使用できました。

CREATE TABLE a (x String) ENGINE = Memory;
INSERT INTO a VALUES ('ClickHouse');

SELECT * FROM a AS a1 JOIN a AS a2 ON a1.x <=> a2.x;

┌─x──────────┬─a2.x───────┐
│ ClickHouse │ ClickHouse │
└────────────┴────────────┘

<=> 演算子は NULL セーフな等価比較演算子であり、IS NOT DISTINCT FROM と同等です。通常の等価演算子 (=) と同様に動作しますが、NULL 値を互いに比較可能なものとして扱います。 2 つの NULL 値は等しいと見なされ、NULL と NULL 以外の値を比較した場合は、NULL ではなく 0 (偽) を返します。

SELECT
  'ClickHouse' <=> NULL,
  NULL <=> NULL

┌─isNotDistinc⋯use', NULL)─┬─isNotDistinc⋯NULL, NULL)─┐
│                        0 │                        1 │
└──────────────────────────┴──────────────────────────┘

文字列を扱うオペレーター

OVERLAY

OVERLAY(string PLACING replacement FROM offset) - overlay(string, replacement, offset) 関数です。
OVERLAY(string PLACING replacement FROM offset FOR length) - overlay(string, replacement, offset, length) 関数です。
OVERLAYUTF8(string PLACING replacement FROM offset) - overlayUTF8(string, replacement, offset) 関数です。
OVERLAYUTF8(string PLACING replacement FROM offset FOR length) - overlayUTF8(string, replacement, offset, length) 関数です。

データセットを扱う演算子

IN 演算子およびEXISTS 演算子を参照してください。

in 関数

a IN ... は in(a, b) 関数です。

notIn 関数

a NOT IN ... – notIn(a, b) 関数に対応します。

globalIn 関数

a GLOBAL IN ... – globalIn(a, b) 関数です。

globalNotIn 関数

a GLOBAL NOT IN ... は globalNotIn(a, b) 関数です。

in サブクエリ用関数

a = ANY (subquery) – in(a, subquery) 関数です。

notIn サブクエリ関数

a != ANY (subquery) – a NOT IN (SELECT singleValueOrNull(*) FROM subquery) と同じ意味になります。

in subquery 関数

a = ALL (subquery) は、a IN (SELECT singleValueOrNull(*) FROM subquery) と同じです。

notIn サブクエリ関数

a != ALL (subquery) – notIn(a, subquery) 関数。

例

ALL を使用したクエリ:

SELECT number AS a FROM numbers(10) WHERE a > ALL (SELECT number FROM numbers(3, 3));

┌─a─┐
│ 6 │
│ 7 │
│ 8 │
│ 9 │
└───┘

ANYを使用したクエリ:

SELECT number AS a FROM numbers(10) WHERE a > ANY (SELECT number FROM numbers(3, 3));

┌─a─┐
│ 4 │
│ 5 │
│ 6 │
│ 7 │
│ 8 │
│ 9 │
└───┘

日付と時刻を扱う演算子

EXTRACT

EXTRACT(part FROM date);

指定した日付から各部分を抽出します。たとえば、特定の日付から月を取得したり、時刻から秒を取得したりできます。

partパラメータは、どの部分を取得するかを指定します。指定可能な値は次のとおりです:

SECOND — 秒。指定可能な値: 0–59。
MINUTE — 分。指定可能な値: 0–59。
HOUR — 時。指定可能な値: 0–23。
DAY — 月の日付。指定可能な値: 1–31。
WEEK — ISO 8601 の週番号。指定可能な値: 1–53。
MONTH — 月を表す番号。指定可能な値: 1–12。
QUARTER — 四半期。指定可能な値: 1–4。
YEAR — 年。
EPOCH — Unix タイムスタンプ (1970-01-01 00:00:00 UTC からの秒数) 。注: DateTime64 では、秒未満の部分は切り捨てられます。
DOW — 曜日 (PostgreSQL互換) 。0 = 日曜日、6 = 土曜日。
DOY — 年間通算日。指定可能な値: 1–366。
ISODOW — ISO の曜日。1 = 月曜日、7 = 日曜日。
ISOYEAR — ISO 8601 の週番号付け年。
CENTURY — 世紀。たとえば、2024年は21世紀です。
DECADE — 十年単位 (年を 10 で割った値) 。たとえば、2024年の decade は 202 です。
MILLENNIUM — 千年紀。たとえば、2024年は第3千年紀です。

partパラメータは大文字小文字を区別しません。

date パラメータは処理する日付または時刻を指定します。Date、Date32、DateTime、および DateTime64 型を使用できます。

例:

SELECT EXTRACT(DAY FROM toDate('2017-06-15'));
SELECT EXTRACT(MONTH FROM toDate('2017-06-15'));
SELECT EXTRACT(YEAR FROM toDate('2017-06-15'));
SELECT EXTRACT(EPOCH FROM toDateTime('2024-01-15 12:30:45', 'UTC'));
SELECT EXTRACT(DOW FROM toDate('2024-01-15'));
SELECT EXTRACT(CENTURY FROM toDate('2024-01-01'));

以下の例では、テーブルを作成し、DateTime 型の値を挿入します。

CREATE TABLE test.Orders
(
    OrderId UInt64,
    OrderName String,
    OrderDate DateTime
) ENGINE = MergeTree
ORDER BY ();

INSERT INTO test.Orders VALUES (1, 'Jarlsberg Cheese', toDateTime('2008-10-11 13:23:44'));

SELECT
    toYear(OrderDate) AS OrderYear,
    toMonth(OrderDate) AS OrderMonth,
    toDayOfMonth(OrderDate) AS OrderDay,
    toHour(OrderDate) AS OrderHour,
    toMinute(OrderDate) AS OrderMinute,
    toSecond(OrderDate) AS OrderSecond
FROM test.Orders;

┌─OrderYear─┬─OrderMonth─┬─OrderDay─┬─OrderHour─┬─OrderMinute─┬─OrderSecond─┐
│      2008 │         10 │       11 │        13 │          23 │          44 │
└───────────┴────────────┴──────────┴───────────┴─────────────┴─────────────┘

さらに多くの例については、tests を参照してください。

INTERVAL

Date 型および DateTime 型の値との算術演算で使用するための Interval 型の値を作成します。

使用できる interval の種類:

SECOND
MINUTE
HOUR
DAY
WEEK
MONTH
QUARTER
YEAR

INTERVAL の値を設定する際には、文字列リテラルも使用できます。たとえば、INTERVAL 1 HOUR は INTERVAL '1 hour' や INTERVAL '1' hour と同じ意味になります。

ヒント

異なる型の interval は組み合わせられません。INTERVAL 4 DAY 1 HOUR のような式は使用できません。INTERVAL 25 HOUR のように、その interval の最小単位と同じか、それより小さい単位で指定してください。以下の例のように、連続した演算として記述できます。

例:

SELECT now() AS current_date_time, current_date_time + INTERVAL 4 DAY + INTERVAL 3 HOUR;

┌───current_date_time─┬─plus(plus(now(), toIntervalDay(4)), toIntervalHour(3))─┐
│ 2020-11-03 22:09:50 │                                    2020-11-08 01:09:50 │
└─────────────────────┴────────────────────────────────────────────────────────┘

SELECT now() AS current_date_time, current_date_time + INTERVAL '4 day' + INTERVAL '3 hour';

┌───current_date_time─┬─plus(plus(now(), toIntervalDay(4)), toIntervalHour(3))─┐
│ 2020-11-03 22:12:10 │                                    2020-11-08 01:12:10 │
└─────────────────────┴────────────────────────────────────────────────────────┘

SELECT now() AS current_date_time, current_date_time + INTERVAL '4' day + INTERVAL '3' hour;

┌───current_date_time─┬─plus(plus(now(), toIntervalDay('4')), toIntervalHour('3'))─┐
│ 2020-11-03 22:33:19 │                                        2020-11-08 01:33:19 │
└─────────────────────┴────────────────────────────────────────────────────────────┘

注記

INTERVAL 構文または addDays 関数の使用を常に推奨します。単純な加算や減算 (now() + ... のような構文) は、サマータイムなどの時間関連の設定を考慮しません。

例:

SELECT toDateTime('2014-10-26 00:00:00', 'Asia/Istanbul') AS time, time + 60 * 60 * 24 AS time_plus_24_hours, time + toIntervalDay(1) AS time_plus_1_day;

┌────────────────time─┬──time_plus_24_hours─┬─────time_plus_1_day─┐
│ 2014-10-26 00:00:00 │ 2014-10-26 23:00:00 │ 2014-10-27 00:00:00 │
└─────────────────────┴─────────────────────┴─────────────────────┘

関連項目

Interval データ型
toInterval 型変換関数

日付と時刻の加算

Date または Date32 の値には、+ 演算子を使って Time または Time64 の値を加算できます。結果は、指定した時刻の日付を表す DateTime または DateTime64 になります。この演算は可換です。

結果の型は、オペランドの型によって決まります。

左オペランド	右オペランド	結果の型
`Date`	`Time`	`DateTime`
`Date`	`Time64(s)`	`DateTime64(s)`
`Date32`	`Time`	`DateTime64(0)`
`Date32`	`Time64(s)`	`DateTime64(s)`

注記

結果には session timezone が使用されます (session timezone が設定されていない場合は、サーバーのデフォルトタイムゾーンが使用されます) 。date_time_overflow_behavior 設定は、結果が表現可能な範囲を超えた場合の動作を制御します。

例:

SET use_legacy_to_time = 0;
SELECT toDate('2024-07-15') + toTime('14:30:25') AS dt, toTypeName(dt);

┌──────────────────dt─┬─toTypeName(dt)─┐
│ 2024-07-15 14:30:25 │ DateTime       │
└─────────────────────┴────────────────┘

SELECT toDate('2024-07-15') + toTime64('14:30:25.123456', 6) AS dt, toTypeName(dt);

┌─────────────────────────dt─┬─toTypeName(dt)─┐
│ 2024-07-15 14:30:25.123456 │ DateTime64(6)  │
└────────────────────────────┴────────────────┘

SELECT toTime64('23:59:59.999', 3) + toDate32('2024-07-15') AS dt, toTypeName(dt);

┌──────────────────────dt─┬─toTypeName(dt)─┐
│ 2024-07-15 23:59:59.999 │ DateTime64(3)  │
└─────────────────────────┴────────────────┘

論理AND演算子

構文 SELECT a AND b — 関数 and を用いて、a と b の論理積を計算します。

論理OR演算子

構文 SELECT a OR b — 関数 or を使用して、a と b の論理和を計算します。

論理否定演算子

構文 SELECT NOT a — 関数 not により、a の論理否定を計算します。

条件演算子

a ? b : c – if(a, b, c) 関数です。

注記:

条件演算子は、b と c の値を計算した後、条件 a が満たされているかを確認し、該当する値を返します。b または c が arrayJoin() 関数である場合、条件 a に関係なく、各行が複製されます。

条件式

CASE [x]
    WHEN a THEN b
    [WHEN ... THEN ...]
    [ELSE c]
END

x が指定されている場合は、transform(x, [a, ...], [b, ...], c) 関数が使用されます。そうでない場合は、multiIf(a, b, ..., c) 関数が使用されます。

式に ELSE c 句がない場合、デフォルト値は NULL になります。

transform 関数は NULL を処理できません。

連結演算子

s1 || s2 – concat(s1, s2) 関数。

Lambda 作成演算子

x -> expr – lambda(x, expr) 関数です。

次の演算子は括弧として扱われるため、優先順位は定義されていません。

配列作成演算子

[x1, ...] – array(x1, ...) 関数を表します。

タプル作成演算子

(x1, x2, ...) – tuple(x1, x2, ...) 関数。

タプル生成演算子

すべての二項演算子は左結合です。例えば、1 + 2 + 3 は plus(plus(1, 2), 3) に変換されます。場合によっては、これは期待どおりには動作しません。例えば、SELECT 4 > 2 > 3 の結果は 0 になります。

効率のために、and および or は任意個数の引数を受け取る関数です。対応する AND および OR 演算子の連なりは、これらの関数の 1 回の呼び出しに変換されます。

`NULL` のチェック

ClickHouse は IS NULL および IS NOT NULL 演算子をサポートします。

IS NULL

Nullable 型の値に対しては、IS NULL 演算子は次の値を返します。
- 値が NULL の場合は 1
- それ以外の場合は 0
Nullable 以外の値に対しては、IS NULL 演算子は常に 0 を返します。

optimize_functions_to_subcolumns 設定を有効にすると最適化できます。optimize_functions_to_subcolumns = 1 の場合、この関数はカラム全体のデータを読み取って処理する代わりに、null サブカラムだけを読み取ります。クエリ SELECT n IS NULL FROM table は SELECT n.null FROM TABLE に変換されます。

SELECT x+100 FROM t_null WHERE y IS NULL

┌─plus(x, 100)─┐
│          101 │
└──────────────┘

IS NOT NULL

Nullable 型の値に対しては、IS NOT NULL 演算子は次を返します：
- 値が NULL の場合は 0
- それ以外の場合は 1
それ以外の型の値に対しては、IS NOT NULL 演算子は常に 1 を返します。

SELECT * FROM t_null WHERE y IS NOT NULL

┌─x─┬─y─┐
│ 2 │ 3 │
└───┴───┘

optimize_functions_to_subcolumns SETTING を有効にすることで最適化できます。optimize_functions_to_subcolumns = 1 の場合、関数はカラム全体のデータを読み取って処理するのではなく、null サブカラムのみを読み込みます。クエリ SELECT n IS NOT NULL FROM table は SELECT NOT n.null FROM TABLE に変換されます。

真偽値の判定

ClickHouse は、IS TRUE、IS FALSE、IS UNKNOWN、IS NOT TRUE、IS NOT FALSE、および IS NOT UNKNOWN 演算子をサポートしています。これらは Bool および Nullable(Bool) の式で使用されます。

expr IS TRUE は、expr が true の場合にのみ 1 を返します。
expr IS FALSE は、expr が false の場合にのみ 1 を返します。
expr IS UNKNOWN は、expr が NULL の場合にのみ 1 を返します。
expr IS NOT TRUE は、expr が false または NULL の場合に 1 を返します。
expr IS NOT FALSE は、expr が true または NULL の場合に 1 を返します。
expr IS NOT UNKNOWN は、expr が NULL ではない場合に 1 を返します。

真偽値式では、IS UNKNOWN は IS NULL と同等であり、IS NOT UNKNOWN は IS NOT NULL と同等です。

CREATE TABLE t_bool (x Nullable(Bool)) ENGINE = Memory;
INSERT INTO t_bool VALUES (true), (false), (NULL);

SELECT
    x,
    x IS TRUE,
    x IS FALSE,
    x IS UNKNOWN,
    x IS NOT TRUE,
    x IS NOT FALSE,
    x IS NOT UNKNOWN
FROM t_bool;

アクセス演算子​

数値の符号反転演算子​

乗算および除算演算子​

加算および減算演算子​

比較演算子​

equals 関数​

notEquals 関数​

lessOrEquals関数​

lessOrEquals関数​

greaterOrEquals関数​

less関数​

like関数​

notLike 関数​

notLike関数​

ilike関数​

is not distinct from 演算子 (<=>)​

文字列を扱うオペレーター​

OVERLAY​

データセットを扱う演算子​

in 関数​

notIn 関数​

globalIn 関数​

globalNotIn 関数​

in サブクエリ用関数​

notIn サブクエリ関数​

in subquery 関数​

notIn サブクエリ関数​

日付と時刻を扱う演算子​

EXTRACT​

INTERVAL​

日付と時刻の加算​

論理AND演算子​

論理OR演算子​

論理否定演算子​

条件演算子​

条件式​

連結演算子​

Lambda 作成演算子​

配列作成演算子​

タプル作成演算子​

タプル生成演算子​

NULL のチェック​

IS NULL​

IS NOT NULL​

真偽値の判定​

アクセス演算子

数値の符号反転演算子

乗算および除算演算子

加算および減算演算子

比較演算子

equals 関数

notEquals 関数

lessOrEquals関数

lessOrEquals関数

greaterOrEquals関数

less関数

like関数

notLike 関数

notLike関数

ilike関数

is not distinct from 演算子 (`<=>`)

文字列を扱うオペレーター

OVERLAY

データセットを扱う演算子

in 関数

notIn 関数

globalIn 関数

globalNotIn 関数

in サブクエリ用関数

notIn サブクエリ関数

in subquery 関数

notIn サブクエリ関数

日付と時刻を扱う演算子

EXTRACT

INTERVAL

日付と時刻の加算

論理AND演算子

論理OR演算子

論理否定演算子

条件演算子

条件式

連結演算子

Lambda 作成演算子

配列作成演算子

タプル作成演算子

タプル生成演算子

`NULL` のチェック

IS NULL

IS NOT NULL

真偽値の判定