Перейти к основному содержимому
Перейти к основному содержимому

Map(K, V)

Тип данных Map(K, V) хранит пары ключ-значение.

В отличие от других баз данных, в ClickHouse карты не уникальны, то есть карта может содержать два элемента с одинаковым ключом. (Причина этого заключается в том, что карты внутренне реализованы как Array(Tuple(K, V)).)

Вы можете использовать синтаксис m[k], чтобы получить значение для ключа k в карте m. Также m[k] сканирует карту, то есть время выполнения этой операции линейно зависимо от размера карты.

Параметры

  • K — Тип ключей Map. Произвольный тип, за исключением Nullable и LowCardinality, вложенных с Nullable типами.
  • V — Тип значений Map. Произвольный тип.

Примеры

Создайте таблицу со столбцом типа map:

CREATE TABLE tab (m Map(String, UInt64)) ENGINE=Memory;
INSERT INTO tab VALUES ({'key1':1, 'key2':10}), ({'key1':2,'key2':20}), ({'key1':3,'key2':30});

Чтобы выбрать значения key2:

SELECT m['key2'] FROM tab;

Результат:

┌─arrayElement(m, 'key2')─┐
│                      10 │
│                      20 │
│                      30 │
└─────────────────────────┘

Если запрашиваемый ключ k не содержится в карте, m[k] возвращает значение по умолчанию для данного типа, например 0 для целочисленных типов и '' для строковых типов. Чтобы проверить, существует ли ключ в карте, вы можете использовать функцию mapContains.

CREATE TABLE tab (m Map(String, UInt64)) ENGINE=Memory;
INSERT INTO tab VALUES ({'key1':100}), ({});
SELECT m['key1'] FROM tab;

Результат:

┌─arrayElement(m, 'key1')─┐
│                     100 │
│                       0 │
└─────────────────────────┘

Преобразование Tuple в Map​

Значения типа Tuple() могут быть приведены к значениям типа Map() с использованием функции CAST:

Пример

Запрос:

SELECT CAST(([1, 2, 3], ['Ready', 'Steady', 'Go']), 'Map(UInt8, String)') AS map;

Результат:

┌─map───────────────────────────┐
│ {1:'Ready',2:'Steady',3:'Go'} │
└───────────────────────────────┘

Чтение подколонок Map​

Чтобы избежать чтения всей карты, вы можете использовать подколонки keys и values в некоторых случаях.

Пример

Запрос:

CREATE TABLE tab (m Map(String, UInt64)) ENGINE = Memory;
INSERT INTO tab VALUES (map('key1', 1, 'key2', 2, 'key3', 3));

SELECT m.keys FROM tab; --   same as mapKeys(m)
SELECT m.values FROM tab; -- same as mapValues(m)

Результат:

┌─m.keys─────────────────┐
│ ['key1','key2','key3'] │
└────────────────────────┘

┌─m.values─┐
│ [1,2,3]  │
└──────────┘

См. также

Связанное содержимое​