Array(T)

Массив элементов типа T с индексацией, начинающейся с 1. T может быть любым типом данных, включая массив.

Создание массива

Для создания массива можно использовать функцию:

array(T)

Можно также использовать квадратные скобки.

[]

Пример создания массива:

SELECT array(1, 2) AS x, toTypeName(x)

┌─x─────┬─toTypeName(array(1, 2))─┐
│ [1,2] │ Array(UInt8)            │
└───────┴─────────────────────────┘

SELECT [1, 2] AS x, toTypeName(x)

┌─x─────┬─toTypeName([1, 2])─┐
│ [1,2] │ Array(UInt8)       │
└───────┴────────────────────┘

Работа с типами данных

При создании массива «на лету» ClickHouse автоматически определяет тип аргумента как самый узкий тип данных, который может хранить все перечисленные аргументы. Если в массиве есть значения Nullable или литералы NULL, тип элемента массива также становится Nullable.

Если ClickHouse не может определить тип данных, генерируется исключение. Например, это происходит при попытке создать массив, содержащий одновременно строки и числа (SELECT array(1, 'a')).

Примеры автоматического определения типа данных:

SELECT array(1, 2, NULL) AS x, toTypeName(x)

┌─x──────────┬─toTypeName(array(1, 2, NULL))─┐
│ [1,2,NULL] │ Array(Nullable(UInt8))        │
└────────────┴───────────────────────────────┘

Если вы попытаетесь создать массив несовместимых типов данных, ClickHouse выбросит исключение:

SELECT array(1, 'a')

Получено исключение от сервера (версия 1.1.54388):
Код: 386. DB::Exception: Получено от localhost:9000, 127.0.0.1. DB::Exception: Отсутствует общий супертип для типов UInt8, String, так как часть из них относится к String/FixedString, а часть — нет.

Размер массива

Можно определить размер массива, используя подстолбец size0, не считывая весь столбец целиком. Для многомерных массивов вы можете использовать sizeN-1, где N — требуемая размерность.

Пример

Запрос:

CREATE TABLE t_arr (`arr` Array(Array(Array(UInt32)))) ENGINE = MergeTree ORDER BY tuple();

INSERT INTO t_arr VALUES ([[[12, 13, 0, 1],[12]]]);

SELECT arr.size0, arr.size1, arr.size2 FROM t_arr;

Результат:

┌─arr.size0─┬─arr.size1─┬─arr.size2─┐
│         1 │ [2]       │ [[4,1]]   │
└───────────┴───────────┴───────────┘

Чтение вложенных подколонок из Array

Если вложенный тип T внутри Array имеет подколонки (например, если это именованный кортеж), вы можете читать его подколонки из типа Array(T) с теми же именами подколонок. Тип подколонки будет Array от типа исходной подколонки.

Пример

CREATE TABLE t_arr (arr Array(Tuple(field1 UInt32, field2 String))) ENGINE = MergeTree ORDER BY tuple();
INSERT INTO t_arr VALUES ([(1, 'Hello'), (2, 'World')]), ([(3, 'This'), (4, 'is'), (5, 'subcolumn')]);
SELECT arr.field1, toTypeName(arr.field1), arr.field2, toTypeName(arr.field2) from t_arr;

┌─arr.field1─┬─toTypeName(arr.field1)─┬─arr.field2────────────────┬─toTypeName(arr.field2)─┐
│ [1,2]      │ Array(UInt32)          │ ['Hello','World']         │ Array(String)          │
│ [3,4,5]    │ Array(UInt32)          │ ['This','is','subcolumn'] │ Array(String)          │
└────────────┴────────────────────────┴───────────────────────────┴────────────────────────┘