---
title: undo_retention 介绍-OceanBase数据库使用指南
description: 了解OceanBase数据库在实际应用中关于undo_retention 介绍相关的常见问题和使用技巧，帮助您快速解决undo_retention 介绍的难题。
---
切换语言

- 简体中文
- English

划线反馈

# undo_retention 介绍

更新时间：2026-06-12 08:51

适用版本： V1.4.x、V2.1.x、V2.2.x、V3.1.x、V3.2.x、V4.0.x、V4.1.x、V4.2.x 内容类型：TechNote  

本文主要介绍 OceanBase 数据库中的租户级变量 `undo_retention`。

## undo_retention 是什么?

`undo_retention` 表示系统应保留的多版本数据范围，单位为秒，在转储时控制多版本数据的回收。默认值：1800 秒（30 分钟）。

假设在 t1 时刻设置 `undo_retention = 600s` 后，可以查询从 `MAX(current_time - 600s, t1)` 之后的多版本数据。

例如在 5 点设置 `undo_retention = 3600s`，在 5 点 30 分可以查询 5 点后的多版本数据，在 7 点可以查询 6 点之后的多版本数据，在 8 点可以查询 7 点后的多版本数据。

## undo_retention 设置得过大有什么影响？

最直观的影响是会导致多版本数据增多。

可能的间接影响：

- 多版本数据增多 -> SSTable 数据量变大/数量变多 -> 导致 Minor Merge 变慢 -> SSTable 数量回收慢 -> Table Store 数组爆掉 -> 影响转储 -> 影响合并。
 - 多版本数据增多 -> SSTable 数据量变大 -> 查询时定位 RowKey 变慢 -> 查询变慢。

## 适用版本

OceanBase 数据库所有版本。

Previous

[OceanBase 如何查看距离上一次冻结过去的小时数](https://www.oceanbase.com/knowledge-base/oceanbase-database-1000000000209898)

Next

[转储错误，错误代码 4138/ORA-01555](https://www.oceanbase.com/knowledge-base/oceanbase-database-20000000158) ![有帮助](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) 咨询热线