---
title: "内存控制 - OceanBase 数据库 V4.2.5 | OceanBase 文档中心"
description: 内存控制 OceanBase 数据库当前版本支持追踪单条 SQL 查询过程中的内存使用情况，当内存使用超过一定的阈值后，系统会报错并中断 SQL 的执行，来预防 OOM 或者排查 OOM 原因。 调整单条 SQL 执行过程中的内存使用阈值 OceanBase 数据库通过租户级配置项 query_memory_limi…
---
切换语言

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

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

# 内存控制

更新时间：2026-04-15 17:16:59

[编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.2.5/zh-CN/700.reference/200.system-management/700.memory-management/820.memory-control.md)  

OceanBase 数据库当前版本支持追踪单条 SQL 查询过程中的内存使用情况，当内存使用超过一定的阈值后，系统会报错并中断 SQL 的执行，来预防 OOM 或者排查 OOM 原因。

## 调整单条 SQL 执行过程中的内存使用阈值

OceanBase 数据库通过租户级配置项 `query_memory_limit_percentage` 来控制单条 SQL 可使用的租户内存百分比。其默认值为 `50`，表示当单条 SQL 所使用的内存超过租户内存的 50% 后，系统会报错并中断该 SQL 的执行。用户可以根据实际场景，调整该配置项的值。

调整方法如下：

1. 租户管理员登录到集群的用户租户。

   #### 说明

   MySQL 模式的默认管理员用户为 `root` 用户，Oracle 模式的默认管理员用户为 `SYS` 用户。

   连接示例如下：

   ```shell
   obclient -h172.30.xxx.xxx -P2883 -uroot@mysqltenant#obdemo -pxxxx -A

   ```
 2. 查看当前配置项 `query_memory_limit_percentage` 的值。

   ```shell
   obclient> SHOW PARAMETERS LIKE '%query_memory_limit_percentage%';

   ```
 3. 调整配置项 `query_memory_limit_percentage` 的值。

   示例如下：

   ```shell
   obclient> ALTER SYSTEM SET query_memory_limit_percentage = 50;

   ```

## 相关文档

[query_memory_limit_percentage](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001502064)

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