---
title: "向量索引内存管理 - OceanBase 数据库 V4.3.5 | OceanBase 文档中心"
description: 向量索引内存管理 本文档介绍如何估算和管理 OceanBase 数据库中向量索引的内存占用。 配置向量索引内存 OceanBase 向量搜索通过设置 ob_vector_memory_limit_percentage 配置向量索引内存： V4.3.5 BP3 版本之前，使用 HNSW/HNSW_SQ/HNSW_BQ …
---
切换语言

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

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

# 向量索引内存管理

更新时间：2026-04-07 20:57:20

[编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.3.5/zh-CN/640.ob-vector-search/200.ob-vector-index/200.ob-vector-index-memory-management.md)  

本文档介绍如何估算和管理 OceanBase 数据库中向量索引的内存占用。

## 配置向量索引内存

OceanBase 向量搜索通过设置 [ob_vector_memory_limit_percentage](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000002015585) 配置向量索引内存：

- **V4.3.5 BP3 版本之前，使用 HNSW/HNSW_SQ/HNSW_BQ 向量索引前**，需要手动设置 `ob_vector_memory_limit_percentage` 开启向量功能，建议设置为 `30`，以获得最佳的搜索性能。如保持默认值，则表示不为向量索引分配内存，创建索引会报错。IVF/IVF_PQ 索引不需要常驻内存，所以无需关注此参数。配置示例如下：

  ```sql
  ALTER SYSTEM SET ob_vector_memory_limit_percentage = 30;

  ```
 - **从 V4.3.5 BP3 版本开始**，向量搜索功能默认启用。默认值为 `0` 表示自适应模式，即系统自动调整租户中的向量索引数据的内存占用比例，无需手动调整：

     - 租户实际内存为 8GB 及以下时，该值自适应为 `40`。
     - 租户实际内存为 8GB 以上时，该值自适应为 `50`。

## 索引内存估算与实际占用查询

支持通过 `DBMS_VECTOR` 系统包进行索引内存估算：

- 未建表时，通过 [INDEX_VECTOR_MEMORY_ADVISOR](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000003532843) 过程估算索引内存。
 - 已建表且插入数据时，通过 [INDEX_VECTOR_MEMORY_ESTIMATE](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000003532842) 过程分析索引内存。

向量索引内存估算会返回两项信息：创建向量索引所需的最少内存配置，以及 HNSW_SQ 和 IVF 索引创建完成后的实际内存占用情况。

实际占用内存的详细信息可以通过视图 [GV$OB_VECTOR_MEMORY](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000003532846) 或 [V$OB_VECTOR_MEMORY](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000003532847) 获取。

## 索引重建内存优化

对于分区表的向量索引重建操作，我们还提供了 `vector_index_memory_saving_mode` 配置项来控制索引重建的内存占用。开启此模式可以降低分区表向量索引重建（rebuild）过程中的内存消耗。通常，向量索引重建需要消耗相当于索引两倍的内存。开启省内存模式后，系统会在分区表单个分区构建完成后，通过暂时删除该分区的内存索引来释放内存，从而有效降低重建操作所需的总内存。语法和示例请参见[vector_index_memory_saving_mode](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000004177563)。

## 相关文档

- [向量索引概述](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000004920599)

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