Map(key, value)
Тип данных Map(key, value) хранит пары ключ:значение.
Параметры
key— ключ. String, Integer, LowCardinality или FixedString.value— значение. String, Integer, Array, LowCardinality или FixedString.
Чтобы получить значение из колонки a Map('key', 'value'), используйте синтаксис a['key']. В настоящее время такая подстановка работает по алгоритму с линейной сложностью.
Примеры
Рассмотрим таблицу:
CREATE TABLE table_map (a Map(String, UInt64)) ENGINE=Memory;
INSERT INTO table_map VALUES ({'key1':1, 'key2':10}), ({'key1':2,'key2':20}), ({'key1':3,'key2':30});
Выборка всех значений ключа key2:
SELECT a['key2'] FROM table_map;
Результат:
┌─arrayElement(a, 'key2')─┐
│ 10 │
│ 20 │
│ 30 │
└─────────────────────────┘
Если для какого-то ключа key в колонке с типом Map() нет значения, запрос возвращает нули для числовых колонок, пустые строки или пустые массивы.
INSERT INTO table_map VALUES ({'key3':100}), ({});
SELECT a['key3'] FROM table_map;
Результат:
┌─arrayElement(a, 'key3')─┐
│ 100 │
│ 0 │
└─────────────────────────┘
┌─arrayElement(a, 'key3')─┐
│ 0 │
│ 0 │
│ 0 │
└─────────────────────────┘
Подстолбцы Map.keys и Map.values
Для оптимизации обработки столбцов Map в некоторых случаях можно использовать подстолбцы keys и values вместо чтения всего столбца.
Пример
Запрос:
CREATE TABLE t_map (`a` Map(String, UInt64)) ENGINE = Memory;
INSERT INTO t_map VALUES (map('key1', 1, 'key2', 2, 'key3', 3));
SELECT a.keys FROM t_map;
SELECT a.values FROM t_map;
Результат:
┌─a.keys─────────────────┐
│ ['key1','key2','key3'] │
└────────────────────────┘
┌─a.values─┐
│ [1,2,3] │
└──────────┘
См. также