Tuple(T1, T2, ...)

要素のタプルで、それぞれが個別の タイプ を持っています。タプルは少なくとも1つの要素を含む必要があります。

タプルは一時的なカラムのグルーピングに使用されます。カラムはクエリで IN 式が使用されている場合にグループ化され、ラムダ関数の特定の形式的パラメータを指定するためにも使用されます。詳細については、IN 演算子 および 高階関数 のセクションを参照してください。

タプルはクエリの結果となる場合があります。この場合、JSON 以外のテキスト形式では、値はカンマ区切りで括弧内に表示されます。JSON 形式では、タプルは配列として出力されます（角括弧内に表示）。

Creating Tuples

関数を使用してタプルを作成することができます：

tuple(T1, T2, ...)

タプルを作成する例：

SELECT tuple(1, 'a') AS x, toTypeName(x)

┌─x───────┬─toTypeName(tuple(1, 'a'))─┐
│ (1,'a') │ Tuple(UInt8, String)      │
└─────────┴───────────────────────────┘

タプルは単一の要素を含むことができます。

例：

SELECT tuple('a') AS x;

┌─x─────┐
│ ('a') │
└───────┘

構文 (tuple_element1, tuple_element2) を使用して、tuple() 関数を呼び出すことなく、複数の要素のタプルを作成することができます。

例：

SELECT (1, 'a') AS x, (today(), rand(), 'someString') AS y, ('a') AS not_a_tuple;

┌─x───────┬─y──────────────────────────────────────┬─not_a_tuple─┐
│ (1,'a') │ ('2022-09-21',2006973416,'someString') │ a           │
└─────────┴────────────────────────────────────────┴─────────────┘

Data Type Detection

タプルをその場で作成する際、ClickHouse は引数の最小型としてタプルの型を推測します。値が NULL の場合、推測された型は Nullable です。

自動データ型検出の例：

SELECT tuple(1, NULL) AS x, toTypeName(x)

┌─x─────────┬─toTypeName(tuple(1, NULL))──────┐
│ (1, NULL) │ Tuple(UInt8, Nullable(Nothing)) │
└───────────┴─────────────────────────────────┘

Referring to Tuple Elements

タプルの要素には、名前またはインデックスでアクセスできます：

CREATE TABLE named_tuples (`a` Tuple(s String, i Int64)) ENGINE = Memory;
INSERT INTO named_tuples VALUES (('y', 10)), (('x',-10));

SELECT a.s FROM named_tuples; -- by name
SELECT a.2 FROM named_tuples; -- by index

結果：

┌─a.s─┐
│ y   │
│ x   │
└─────┘

┌─tupleElement(a, 2)─┐
│                 10 │
│                -10 │
└────────────────────┘

Comparison operations with Tuple

2つのタプルは、その要素を左から右へ順に比較することによって比較されます。最初のタプルの要素が2番目のタプルの対応する要素よりも大きい（小さい）場合、最初のタプルは2番目のタプルより大きい（小さい）と見なされます。それ以外の場合（両方の要素が等しい場合）、次の要素が比較されます。

例：

SELECT (1, 'z') > (1, 'a') c1, (2022, 01, 02) > (2023, 04, 02) c2, (1,2,3) = (3,2,1) c3;

┌─c1─┬─c2─┬─c3─┐
│  1 │  0 │  0 │
└────┴────┴────┘

現実の例：

CREATE TABLE test
(
    `year` Int16,
    `month` Int8,
    `day` Int8
)
ENGINE = Memory AS
SELECT *
FROM values((2022, 12, 31), (2000, 1, 1));

SELECT * FROM test;

┌─year─┬─month─┬─day─┐
│ 2022 │    12 │  31 │
│ 2000 │     1 │   1 │
└──────┴───────┴─────┘

SELECT *
FROM test
WHERE (year, month, day) > (2010, 1, 1);

┌─year─┬─month─┬─day─┐
│ 2022 │    12 │  31 │
└──────┴───────┴─────┘
CREATE TABLE test
(
    `key` Int64,
    `duration` UInt32,
    `value` Float64
)
ENGINE = Memory AS
SELECT *
FROM values((1, 42, 66.5), (1, 42, 70), (2, 1, 10), (2, 2, 0));

SELECT * FROM test;

┌─key─┬─duration─┬─value─┐
│   1 │       42 │  66.5 │
│   1 │       42 │    70 │
│   2 │        1 │    10 │
│   2 │        2 │     0 │
└─────┴──────────┴───────┘

-- Let's find a value for each key with the biggest duration, if durations are equal, select the biggest value

SELECT
    key,
    max(duration),
    argMax(value, (duration, value))
FROM test
GROUP BY key
ORDER BY key ASC;

┌─key─┬─max(duration)─┬─argMax(value, tuple(duration, value))─┐
│   1 │            42 │                                    70 │
│   2 │             2 │                                     0 │
└─────┴───────────────┴───────────────────────────────────────┘