⌘+k ctrl+k
1.4 (LTS)
搜索快捷键 cmd + k | ctrl + k
映射函数
名称 描述
cardinality(map) 返回 map 的大小(即 map 中的条目数量)。
element_at(map, key) 返回给定 key 对应的值(以列表形式返回),如果 map 中不包含该 key,则返回空列表。第二个参数提供的 key 类型必须与 map 的 key 类型匹配;否则,将抛出错误。
map_concat(maps...) 返回通过合并输入 maps 创建的新 map。当出现 key 冲突时,取最后一个包含该 key 的 map 中的值。
map_contains(map, key) 检查 map 是否包含给定的 key。
map_contains_entry(map, key, value) 检查 map 是否包含给定的键值对。
map_contains_value(map, value) 检查 map 是否包含给定的值。
map_entries(map) 返回一个包含 map 中每个键值对的 struct(k, v) 列表。
map_extract(map, key) 返回给定 key 对应的值(以列表形式返回),如果 map 中不包含该 key,则返回空列表。第二个参数提供的 key 类型必须与 map 的 key 类型匹配;否则,将抛出错误。
map_extract_value(map, key) 返回给定 key 对应的值;如果 map 中不包含该 key,则返回 NULL。第二个参数提供的 key 类型必须与 map 的 key 类型匹配;否则,将抛出错误。
map_from_entries(STRUCT(k, v)[]) 返回通过数组中的条目创建的 map。
map_keys(map) 返回 map 中所有 key 的列表。
map_values(map) 返回 map 中所有 value 的列表。
map() 返回一个空 map。
map[entry] 返回给定 key 对应的值;如果 map 中不包含该 key,则返回 NULL。第二个参数提供的 key 类型必须与 map 的 key 类型匹配;否则,将抛出错误。

cardinality(map)

描述 返回 map 的大小(即 map 中的条目数量)。
示例 cardinality(map([4, 2], ['a', 'b']))
结果 2

element_at(map, key)

描述 返回给定 key 对应的值(以列表形式返回),如果 map 中不包含该 key,则返回空列表。第二个参数提供的 key 类型必须与 map 的 key 类型匹配;否则,将抛出错误。
示例 element_at(map([100, 5], [42, 43]), 100)
结果 [42]
别名 map_extract(map, key)

map_concat(maps...)

描述 返回通过合并输入 maps 创建的新 map。当出现 key 冲突时,取最后一个包含该 key 的 map 中的值。
示例 map_concat(MAP {'key1': 10, 'key2': 20}, MAP {'key3': 30}, MAP {'key2': 5})
结果 {key1=10, key2=5, key3=30}

map_contains(map, key)

描述 检查 map 是否包含给定的 key。
示例 map_contains(MAP {'key1': 10, 'key2': 20, 'key3': 30}, 'key2')
结果 true

map_contains_entry(map, key, value)

描述 检查 map 是否包含给定的键值对。
示例 map_contains_entry(MAP {'key1': 10, 'key2': 20, 'key3': 30}, 'key2', 20)
结果 true

map_contains_value(map, value)

描述 检查 map 是否包含给定的值。
示例 map_contains_value(MAP {'key1': 10, 'key2': 20, 'key3': 30}, 20)
结果 true

map_entries(map)

描述 返回一个包含 map 中每个键值对的 struct(k, v) 列表。
示例 map_entries(map([100, 5], [42, 43]))
结果 [{'key': 100, 'value': 42}, {'key': 5, 'value': 43}]

map_extract(map, key)

描述 返回给定 key 对应的值(以列表形式返回),如果 map 中不包含该 key,则返回 NULL。第二个参数提供的 key 类型必须与 map 的 key 类型匹配,否则将返回错误。
示例 map_extract(map([100, 5], [42, 43]), 100)
结果 [42]
别名 element_at(map, key)

map_extract_value(map, key)

描述 返回给定 key 对应的值;如果 map 中不包含该 key,则返回 NULL。第二个参数提供的 key 类型必须与 map 的 key 类型匹配;否则,将抛出错误。
示例 map_extract_value(map([100, 5], [42, 43]), 100);
结果 42
别名 map[key]

map_from_entries(STRUCT(k, v)[])

描述 返回通过数组中的条目创建的 map。
示例 map_from_entries([{k: 5, v: 'val1'}, {k: 3, v: 'val2'}])
结果 {5=val1, 3=val2}

map_keys(map)

描述 返回 map 中所有 key 的列表。
示例 map_keys(map([100, 5], [42,43]))
结果 [100, 5]

map_values(map)

描述 返回 map 中所有 value 的列表。
示例 map_values(map([100, 5], [42, 43]))
结果 [42, 43]

map()

描述 返回一个空 map。
示例 map()
结果 {}

map[entry]

描述 返回给定 key 对应的值;如果 map 中不包含该 key,则返回 NULL。第二个参数提供的 key 类型必须与 map 的 key 类型匹配;否则,将抛出错误。
示例 map([100, 5], ['a', 'b'])[100]
结果 a
别名 map_extract_value(map, key)
© 2025 DuckDB 基金会,阿姆斯特丹,荷兰
行为准则 商标使用指南