tuple-map-functions

description: 'Документация по функциям Map для Tuple' sidebar_label: 'Map' sidebar_position: 120 slug: /sql-reference/functions/tuple-map-functions title: 'Функции Map'

Аргументы

• key_n — Ключи записей карты. Любой тип, поддерживаемый в качестве типа ключа для Map.
• value_n — Значения записей карты. Любой тип, поддерживаемый в качестве типа значения для Map.

Возвращаемое значение

• Карта, содержащая пары key:value. Map(key, value).

Примеры

Запрос:

Результат:

mapFromArrays

Создает карту из массива или карты ключей и массива или карты значений.

Функция является удобной альтернативой синтаксису CAST([...], 'Map(key_type, value_type)'). Например, вместо записи

• CAST((['aa', 'bb'], [4, 5]), 'Map(String, UInt32)'), или
• CAST([('aa',4), ('bb',5)], 'Map(String, UInt32)')

вы можете записать mapFromArrays(['aa', 'bb'], [4, 5]).

Синтаксис

Псевдоним: MAP_FROM_ARRAYS(keys, values)

Аргументы

• keys — Массив или карта ключей для создания карты из Array или Map. Если keys является массивом, принимаем Array(Nullable(T)) или Array(LowCardinality(Nullable(T))) в качестве его типа, при условии, что он не содержит значений NULL.
• values - Массив или карта значений для создания карты из Array или Map.

Возвращаемое значение

• Карта с ключами и значениями, сконструированными из массива ключей и массива/карты значений.

Пример

Запрос:

Результат:

mapFromArrays также принимает аргументы типа Map. Они преобразуются в массив кортежей во время выполнения.

Результат:

Результат:

extractKeyValuePairs

Преобразует строку пар ключ-значение в Map(String, String). Парсинг нечувствителен к шуму (например, файлы логов). Пар ключ-значение во входной строке состоит из ключа, за которым следует разделитель ключ-значение и значение. Парные ключи разделяются разделителем пар. Ключи и значения могут быть в кавычках.

Синтаксис

Псевдонимы:

• str_to_map
• mapFromString

Аргументы

• data - Строка для извлечения пар ключ-значение. String или FixedString.
• key_value_delimiter - Один символ, разделяющий ключи и значения. По умолчанию :. String или FixedString.
• pair_delimiters - Набор символов, разделяющих пары. По умолчанию , , и ;. String или FixedString.
• quoting_character - Один символ, используемый в качестве символа кавычек. По умолчанию ". String или FixedString.

Возвращаемые значения

• Массив пар ключ-значение. Тип: Map(String, String)

Примеры

Запрос

Результат:

С одинарной кавычкой ' в качестве символа кавычек:

Результат:

Эскапированные последовательности без поддержки эскейпирования:

Результат:

Чтобы восстановить строку карты пар ключ-значение, сериализованную с помощью toString:

Результат:

extractKeyValuePairsWithEscaping

То же самое, что и extractKeyValuePairs, но поддерживает эскейпирование.

Поддерживаемые escape-последовательности: \x, \N, \a, \b, \e, \f, \n, \r, \t, \v и \0. Нестандартные escape-последовательности возвращаются такими, какие они есть (включая обратный слеш), если они не являются одним из следующих: \\, ', ", backtick, /, = или условные управляющие символы ASCII (c <= 31).

Эта функция удовлетворяет использование случаев, когда предварительное и последующее экранирование неприменимо. Например, рассмотрим следующую входную строку: a: "aaaa\"bbb". Ожидаемый вывод: a: aaaa\"bbbb.

• Предварительное экранирование: Экранирование приведет к выводу: a: "aaaa"bbb", а затем extractKeyValuePairs выдаст: a: aaaa
• Последующее экранирование: extractKeyValuePairs выдаст a: aaaa\, а последующее экранирование оставит это как есть.

Ведущие escape-последовательности будут пропущены в ключах и будут считаться недопустимыми для значений.

Примеры

Escape-последовательности с поддержкой escape-последовательностей:

Результат:

mapAdd

Собирает все ключи и суммирует соответствующие значения.

Синтаксис

Аргументы

Аргументы являются map или кортежами из двух массивов, где элементы первого массива представляют ключи, а второй массив содержит значения для каждого ключа. Все массивы ключей должны быть одного типа, а все массивы значений должны содержать элементы, которые преобразуются в один тип (Int64, UInt64 или Float64). Общий преобразуемый тип используется как тип для результирующего массива.

Возвращаемое значение

• В зависимости от аргументов возвращает один map или tuple, где первый массив содержит отсортированные ключи, а второй массив содержит значения.

Пример

Запрос с типом Map:

Результат:

Запрос с кортежем:

Результат:

mapSubtract

Собирает все ключи и вычитает соответствующие значения.

Синтаксис

Аргументы

Аргументы являются map или кортежами из двух массивов, где элементы первого массива представляют ключи, а второй массив содержит значения для каждого ключа. Все массивы ключей должны быть одного типа, а все массивы значений должны содержать элементы, которые преобразуются в один тип (Int64, UInt64 или Float64). Общий преобразуемый тип используется как тип для результирующего массива.

Возвращаемое значение

• В зависимости от аргументов возвращает один map или tuple, где первый массив содержит отсортированные ключи, а второй массив содержит значения.

Пример

Запрос с типом Map:

Результат:

Запрос с кортежем map:

Результат:

mapPopulateSeries

Заполняет отсутствующие пары ключ-значение в карте с целочисленными ключами. Чтобы поддержать расширение ключей за пределы наибольшего значения, можно указать максимальный ключ. Более конкретно, функция возвращает карту, в которой ключи образуют последовательность от наименьшего до наибольшего ключа (или аргумента max, если он указан) с шагом 1, и соответствующие значения. Если для ключа не указано значение, используется значение по умолчанию. В случае повторения ключей только первое значение (по порядку появления) связывается с ключом.

Синтаксис

Для массивных аргументов количество элементов в keys и values должно быть одинаковым для каждой строки.

Аргументы

Аргументы являются Map или двумя Arrays, где первый и второй массив содержат ключи и значения для каждого ключа.

Сопоставленные массивы:

• map — Карта с целочисленными ключами. Map.

или

• keys — Массив ключей. Array(Int).
• values — Массив значений. Array(Int).
• max — Максимальное значение ключа. Необязательный. Int8, Int16, Int32, Int64, Int128, Int256.

Возвращаемое значение

• В зависимости от аргументов возвращает Map или Tuple из двух Arrays: ключи в отсортированном порядке и соответствующие значения.

Пример

Запрос с типом Map:

Результат:

Запрос с сопоставленными массивами:

Результат:

mapKeys

Возвращает ключи данной карты.

Эта функция может быть оптимизирована путем включения настройки optimize_functions_to_subcolumns. С включенной настройкой функция читает только подколонку keys вместо всей карты. Запрос SELECT mapKeys(m) FROM table преобразуется в SELECT m.keys FROM table.

Синтаксис

Аргументы

• map — Карта. Map.

Возвращаемое значение

• Массив, содержащий все ключи из map. Array.

Пример

Запрос:

Результат:

mapContains

Возвращает, если данный ключ содержится в данной карте.

Синтаксис

Псевдоним: mapContainsKey(map, key)

Аргументы

• map — Карта. Map.
• key — Ключ. Тип должен соответствовать типу ключа map.

Возвращаемое значение

• 1, если map содержит key, 0, если нет. UInt8.

Пример

Запрос:

Результат:

mapContainsKeyLike

Синтаксис

Аргументы

• map — Карта. Map.
• pattern - Шаблон строки для сопоставления.

Возвращаемое значение

• 1, если map содержит key, соответствующий указанному шаблону, 0, если нет.

Пример

Запрос:

Результат:

mapExtractKeyLike

Данная функция принимает карту с ключами-строками и шаблон LIKE и возвращает карту с элементами, ключи которых соответствуют шаблону.

Синтаксис

Аргументы

• map — Карта. Map.
• pattern - Шаблон строки для сопоставления.

Возвращаемое значение

• Карта, содержащая элементы, у которых ключ соответствует указанному шаблону. Если ни один элемент не соответствует шаблону, возвращается пустая карта.

Пример

Запрос:

Результат:

mapValues

Возвращает значения данной карты.

Эта функция может быть оптимизирована путем включения настройки optimize_functions_to_subcolumns. С включенной настройкой функция читает только подколонку values вместо всей карты. Запрос SELECT mapValues(m) FROM table преобразуется в SELECT m.values FROM table.

Синтаксис

Аргументы

• map — Карта. Map.

Возвращаемое значение

• Массив, содержащий все значения из map. Array.

Пример

Запрос:

Результат:

mapContainsValue

Возвращает, если данное значение содержится в данной карте.

Синтаксис

Псевдоним: mapContainsValue(map, value)

Аргументы

• map — Карта. Map.
• value — Значение. Тип должен соответствовать типу значения map.

Возвращаемое значение

• 1, если map содержит value, 0, если нет. UInt8.

Пример

Запрос:

Результат:

mapContainsValueLike

Синтаксис

Аргументы

• map — Карта. Map.
• pattern - Шаблон строки для сопоставления.

Возвращаемое значение

• 1, если map содержит value, соответствующий указанному шаблону, 0, если нет.

Пример

Запрос:

Результат:

mapExtractValueLike

Данная функция принимает карту с значениями-строками и шаблон LIKE и возвращает карту с элементами, у которых значение соответствует шаблону.

Синтаксис

Аргументы

• map — Карта. Map.
• pattern - Шаблон строки для сопоставления.

Возвращаемое значение

• Карта, содержащая элементы, у которых значение соответствует указанному шаблону. Если ни один элемент не соответствует шаблону, возвращается пустая карта.

Пример

Запрос:

Результат:

mapApply

Применяет функцию к каждому элементу карты.

Синтаксис

Аргументы

• func — Лямбда-функция.
• map — Map.

Возвращаемое значение

• Возвращает карту, полученную из оригинальной карты путем применения func(map1[i], ..., mapN[i]) для каждого элемента.

Пример

Запрос:

Результат:

mapFilter

Фильтрует карту, применяя функцию к каждому элементу карты.

Синтаксис

Аргументы

• func - Лямбда-функция.
• map — Map.

Возвращаемое значение

• Возвращает карту, содержащую только элементы в map, для которых func(map1[i], ..., mapN[i]) возвращает что-то, кроме 0.

Пример

Запрос:

Результат:

mapUpdate

Синтаксис

Аргументы

• map1 Map.
• map2 Map.

Возвращаемое значение

• Возвращает map1 с обновленными значениями для соответствующих ключей в map2.

Пример

Запрос:

Результат:

mapConcat

Конкатенирует несколько карт на основе равенства их ключей. Если элементы с одинаковым ключом существуют в более чем одной входной карте, все элементы добавляются в результирующую карту, но только первый из них доступен через оператор [].

Синтаксис

Аргументы

• maps – Произвольное количество Maps.

Возвращаемое значение

• Возвращает карту с конкатенированными картами, переданными в аргументах.

Примеры

Запрос:

Результат:

Запрос:

Результат:

mapExists([func,], map)

Возвращает 1, если хотя бы одна пара ключ-значение в map существует, для которой func(key, value) возвращает что-то, кроме 0. В противном случае возвращает 0.

примечание

mapExists является функцией высшего порядка. Вы можете передать лямбда-функцию в качестве первого аргумента.

Пример

Запрос:

Результат:

mapAll([func,] map)

Возвращает 1, если func(key, value) возвращает что-то, кроме 0 для всех пар ключ-значение в map. В противном случае возвращает 0.

примечание

Обратите внимание, что mapAll является функцией высшего порядка. Вы можете передать лямбда-функцию в качестве первого аргумента.

Пример

Запрос:

Результат:

mapSort([func,], map)

Сортирует элементы карты в порядке возрастания. Если функция func указана, порядок сортировки определяется результатом функции func, применяемой к ключам и значениям карты.

Примеры

Для получения дополнительных сведений смотрите справочник по функции arraySort.

mapPartialSort

Сортирует элементы карты в порядке возрастания с дополнительным аргументом limit, позволяющим частичную сортировку. Если функция func указана, порядок сортировки определяется результатом функции func, применяемой к ключам и значениям карты.

Синтаксис

Аргументы

• func – Необязательная функция, применяемая к ключам и значениям карты. Лямбда-функция.
• limit – Элементы в диапазоне [1..limit] сортируются. (U)Int.
• map – Карта для сортировки. Map.

Возвращаемое значение

• Частично отсортированная карта. Map.

Пример

mapReverseSort([func,], map)

Сортирует элементы карты в порядке убывания. Если функция func указана, порядок сортировки определяется результатом функции func, применяемой к ключам и значениям карты.

Примеры

Для получения дополнительных сведений смотрите функцию arrayReverseSort.

mapPartialReverseSort

Сортирует элементы карты в порядке убывания с дополнительным аргументом limit, позволяющим частичную сортировку. Если функция func указана, порядок сортировки определяется результатом функции func, применяемой к ключам и значениям карты.

Синтаксис

Аргументы

• func – Необязательная функция, применяемая к ключам и значениям карты. Лямбда-функция.
• limit – Элементы в диапазоне [1..limit] сортируются. (U)Int.
• map – Карта для сортировки. Map.

Возвращаемое значение

• Частично отсортированная карта. Map.

Пример