Функции работы с картами

Имя	Описание
`cardinality(map)`	Возвращает размер карты (или количество элементов в карте).
`element_at(map, key)`	Возвращает список, содержащий значение для заданного ключа, или пустой список, если ключ не содержится в карте. Тип ключа, указанного во втором параметре, должен совпадать с типом ключей карты, иначе возвращается ошибка.
`map_contains(map, key)`	Проверяет, содержит ли карта заданный ключ.
`map_contains_entry(map, key, value)`	Проверяет, содержит ли карта заданную пару ключ-значение.
`map_contains_value(map, value)`	Проверяет, содержит ли карта заданное значение.
`map_entries(map)`	Возвращает список структур (k, v) для каждой пары ключ-значение в карте.
`map_extract(map, key)`	Псевдоним для `element_at`. Возвращает список, содержащий значение для заданного ключа, или пустой список, если ключ не содержится в карте. Тип ключа, указанного во втором параметре, должен совпадать с типом ключей карты, иначе возвращается ошибка.
`map_from_entries(STRUCT(k, v)[])`	Возвращает карту, созданную из элементов массива.
`map_keys(map)`	Возвращает список всех ключей в карте.
`map_values(map)`	Возвращает список всех значений в карте.
`map()`	Возвращает пустую карту.
`map[entry]`	Псевдоним для `element_at`.

`cardinality(map)`

Описание	Возвращает размер карты (или количество элементов в карте).
Пример	`cardinality(map([4, 2], ['a', 'b']))`
Результат	`2`

`element_at(map, key)`

Описание	Возвращает список, содержащий значение для заданного ключа, или пустой список, если ключ не содержится в карте. Тип ключа, указанного во втором параметре, должен совпадать с типом ключей карты, иначе возвращается ошибка.
Пример	`element_at(map([100, 5], [42, 43]), 100)`
Результат	`[42]`

`map_contains(map, key)`

Описание	Проверяет, содержит ли карта заданный ключ.
Пример	`map_contains(MAP {'key1': 10, 'key2': 20, 'key3': 30}, 'key2')`
Результат	`true`

`map_contains_entry(map, key, value)`

Описание	Проверяет, содержит ли карта заданную пару ключ-значение.
Пример	`map_contains_entry(MAP {'key1': 10, 'key2': 20, 'key3': 30}, 'key2', 20)`
Результат	`true`

`map_contains_value(map, value)`

Описание	Проверяет, содержит ли карта заданное значение.
Пример	`map_contains_value(MAP {'key1': 10, 'key2': 20, 'key3': 30}, 20)`
Результат	`true`

`map_entries(map)`

Описание	Возвращает список структур (k, v) для каждой пары ключ-значение в карте.
Пример	`map_entries(map([100, 5], [42, 43]))`
Результат	`[{'key': 100, 'value': 42}, {'key': 5, 'value': 43}]`

`map_extract(map, key)`

Описание	Псевдоним для `element_at`. Возвращает список, содержащий значение для заданного ключа, или пустой список, если ключ не содержится в карте. Тип ключа, предоставленного во втором параметре, должен соответствовать типу ключей карты, иначе возвращается ошибка.
Пример	`map_extract(map([100, 5], [42, 43]), 100)`
Результат	`[42]`

`map_from_entries(STRUCT(k, v)[])`

Описание	Возвращает карту, созданную из элементов массива.
Пример	`map_from_entries([{k: 5, v: 'val1'}, {k: 3, v: 'val2'}])`
Результат	`{5=val1, 3=val2}`

`map_keys(map)`

Описание	Возвращает список всех ключей в карте.
Пример	`map_keys(map([100, 5], [42,43]))`
Результат	`[100, 5]`

`map_values(map)`

Описание	Возвращает список всех значений в карте.
Пример	`map_values(map([100, 5], [42, 43]))`
Результат	`[42, 43]`

`map()`

Описание	Возвращает пустую карту.
Пример	`map()`
Результат	`{}`

`map[entry]`

Описание	Псевдоним для `element_at`.
Пример	`map([100, 5], ['a', 'b'])[100]`
Результат	`[a]`

© Copyright 2018–2024 Stichting DuckDB Foundation
Licensed under the MIT License.
https://duckdb.org/docs/sql/functions/map.html

спецификации, руководства, описания, API

free hit counter