---
title: "映射构造函数 - OceanBase 数据库 V4.5.0 | OceanBase 文档中心"
description: "映射构造函数 映射构造函数/运算符用于构建新的映射数据类型。OceanBase 数据库当前所支持的映射构造函数包括 map() ，操作符包括 {} 。 map map() 函数用于构建一个映射数据。语法如下： map(key1, value1, key2, value2, ..., keyN, valueN) 输入参…"
---
切换语言

- 中文站 - 简体中文
- International - English
- 日本站 - 日本語

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*P8CuR4UJ_FkAAAAAAAAAAAAADiGDAQ/original) OceanBase 数据库分布式版 - V 4.5.0

# 映射构造函数

更新时间：2026-01-19 18:09:48

[编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.5.0/zh-CN/700.reference/500.sql-reference/100.sql-syntax/200.common-tenant-of-mysql-mode/400.functions-of-mysql-mode/980.map-functions-of-mysql-mode/200.map-constructor-functions-of-mysql-mode.md)  

映射构造函数/运算符用于构建新的映射数据类型。OceanBase 数据库当前所支持的映射构造函数包括 `map()`，操作符包括 `{}`。

## map

`map()` 函数用于构建一个映射数据。语法如下：

```sql
map(key1, value1, key2, value2, ..., keyN, valueN)

```

输入参数说明如下：

- 输入的参数个数需为偶数，序数为奇数的参数构成 Key 数组 ，序数为偶数的参数构成 Value 数组。
 - key1~keyN 和 value1~valueN 的数据元素类型请参见[映射数据类型概述](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000004481461)。
 - 注意，输入的键值对中 Key 不可重复，如有重复的 Key，则以后输入的 Value 为准，前面的 Value 会被覆盖。

返回值为映射数据类型（MAP）。

示例如下：

```sql
-- 构建出的映射数据只有一个键值对，key 为 1，value 为 2
SELECT map(1,2);
+----------+
| map(1,2) |
+----------+
| {1:2}    |
+----------+
1 row in set

```

```sql
-- 构建出的映射数据有 3 个键值对
SELECT map(1,"a",2,"b",3,"c");
+------------------------+
| map(1,"a",2,"b",3,"c") |
+------------------------+
| {1:"a",2:"b",3:"c"}    |
+------------------------+
1 row in set

```

```sql
-- Key 数组的数据类型由奇数序数的参数决定，Value 数组的数据类型由偶数序数的参数决定
SELECT map(1,"a","b",1.8,"ccc",3);
+-------------------------------+
| map(1,"a","b",1.8,"ccc",3)    |
+-------------------------------+
| {"1":"a","b":"1.8","ccc":"3"} |
+-------------------------------+

```

 上一篇 下一篇 ![有帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*y6ocSqN8cqsAAAAAAAAAAAAAARQnAQ)![无帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*BG9IQJyLHF8AAAAAAAAAAAAAARQnAQ)![反馈](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*eTWdQKCRKHwAAAAAAAAAAAAAARQnAQ)[AI](https://www.oceanbase.com/obi) 咨询热线