---
title: github-fill
description: "映射数据类型概述 OceanBase 数据库支持了映射数据类型（MAP），映射类型用于存储无序的键值对 (Key-value Pair)。映射数据类型（MAP）由键（Key）和对应的值（Value）组成。该数据类型允许你轻松管理无序的键值对，例如 {a:1, b:2, c:3} ，在保存配置选项、用户属性和产品信息等…"
---
切换语言

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

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

# 映射数据类型概述

更新时间：2026-03-30 18:57:16

[编辑](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/100.basic-elements-of-mysql-mode/100.data-type-of-mysql-mode/1300.map-data-type-of-mysql-mode/100.map-data-type-overview-of-mysql-mode.md)  

OceanBase 数据库支持了映射数据类型（MAP），映射类型用于存储无序的键值对 (Key-value Pair)。映射数据类型（MAP）由键（Key）和对应的值（Value）组成。该数据类型允许你轻松管理无序的键值对，例如 `{a:1, b:2, c:3}`，在保存配置选项、用户属性和产品信息等场景中非常实用。

目前，MAP 主要实现了映射数据的定义（DDL）和操作（DML）。你可以通过两种方式构建映射：一种是使用映射表达式，另一种是通过字符串构建。此外，提供了两个表达式 `map_keys` 和 `map_values`，用于提取映射中的键或值数组，方便数据处理和分析。

OceanBase 数据库当前版本 Key 所支持的映射元素类型如下：

- 整数类型：`TINYINT`、`SMALLINT`、`INT`/`INTEGER` 和 `BIGINT`，支持 `UNSIGNED` 修饰。
 - 浮点类型：`FLOAT` 和 `DOUBLE`。
 - 字符串类型：`VARCHAR`。

Value 支持的元素类型如下：

- 整数类型：`TINYINT`、`SMALLINT`、`INT`/`INTEGER` 和 `BIGINT`，支持 `UNSIGNED` 修饰。
 - 浮点类型：`FLOAT` 和 `DOUBLE`。
 - 字符串类型：`VARCHAR`。
 - 数组类型：`ARRAY`。

说明及限制如下：

- 不支持 `<`、`>`、`>=`、`<=` 用于比较大小的操作符。
 - 不支持 `ORDER BY`、`GROUP BY`、`MIN`、`MAX`、`AVG`、`SUM` 聚合操作。
 - Value 中若为数组类型，其嵌套数组深度最大为 5 层。因 Map 本身计为 1 层，总深度限制为 6 层，故 Value 内数组最多可再嵌套 5 层。

除了提供映射数据类型，还提供了函数可用于映射数据。详细信息请参见 [映射函数](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000004480785)。

 上一篇 下一篇 ![有帮助](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) 咨询热线