---
title: "INDEX_VECTOR_MEMORY_ADVISOR - OceanBase 数据库 V4.3.5 | OceanBase 文档中心"
description: INDEX_VECTOR_MEMORY_ADVISOR INDEX_VECTOR_MEMORY_ADVISOR 过程用于估算未建表的向量索引内存使用情况。 说明 该函数从 V4.3.5 BP3 版本开始支持。 语法 FUNCTION index_vector_memory_advisor ( IN idx_type …
---
切换语言

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

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

# INDEX_VECTOR_MEMORY_ADVISOR

更新时间：2026-07-15 20:42:46

[编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.3.5/zh-CN/700.reference/600.pl-reference/200.pl-mysql/1000.pl-system-package-mysql/17850.dbms-vector-mysql/500.index-vector-memory-advisor-mysql.md)  

`INDEX_VECTOR_MEMORY_ADVISOR` 过程用于估算未建表的向量索引内存使用情况。

#### 说明

该函数从 V4.3.5 BP3 版本开始支持。

## 语法

```sql
FUNCTION index_vector_memory_advisor (
    IN     idx_type          VARCHAR(65535),
    IN     num_vectors       BIGINT UNSIGNED,
    IN     dim_count         INT UNSIGNED,
    IN     dim_type          VARCHAR(65535) DEFAULT 'FLOAT32',
    IN     idx_parameters    LONGTEXT DEFAULT NULL,
    IN     max_tablet_vectors BIGINT UNSIGNED DEFAULT 0)

```

## 参数说明

| 参数 | 描述 |
| --- | --- |
| idx_type | 索引类型。支持 `HNSW`/`HNSW_SQ`/`HNSW_BQ`/`IVF_FLAT`/`IVF_SQ8`/`IVF_PQ`，大小写不敏感。 |
| num_vectors | 向量数据量。 |
| dim_count | 向量维度。 |
| dim_type | 向量元素的数据类型。默认且仅支持为 `FLOAT32`，大小写不敏感。 |
| idx_parameters | 索引参数。即建表时所用的向量索引参数字符串，如 `distance=l2, type=hnsw, lib=vsag`。更多参数请参见[创建向量索引](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000004920599)。 |
| max_tablet_vectors | 分区表中最大分区的向量数据量。默认为 `0`，表示最大分区向量数据量等于向量总数据量。使用分区表可以在总数据量相同的情况下降低最低内存需求。 |

返回值为字符串格式的描述内存估算结果的一句话。

#### 注意

在 OceanBase 中，创建 HNSW_BQ 索引时，系统会根据内存情况自动选择并行或串行方式为分区表创建索引。`INDEX_VECTOR_MEMORY_ADVISOR` 函数返回的建议值是串行创建索引时的最大内存需求值。如果内存仅满足这个值，可能会因为无法并行创建索引而延长索引创建时间。

为确保向量索引重建的成功执行，建议的内存预留值应大于索引构建完成后向量索引实际占用的内存值。建议的内存值与最大分区向量数量存在关联：

- 对于 HNSW 和 HNSW_SQ 索引，返回建议的内存值。
 - 对于 HNSW_BQ 索引，返回建议的内存值和索引创建完成后的实际内存占用值。
 - 对于 IVF_FLAT, IVF_SQ8, IVF_PQ 索引，返回建议的内存值和索引创建完成后的实际内存占用值。

## 示例

查询 HNSW 索引的建议内存值：

```sql
SELECT dbms_vector.index_vector_memory_advisor('HNSW',1000000,768,'FLOAT32','M=10,DISTANCE=L2');
+------------------------------------------------------------------------------------------+
| dbms_vector.index_vector_memory_advisor('HNSW',1000000,768,'FLOAT32','M=10,DISTANCE=L2') |
+------------------------------------------------------------------------------------------+
| Suggested minimum vector memory is 7.2 GB                                                |
+------------------------------------------------------------------------------------------+
1 row in set

```

查询 HNSW_BQ 索引的建议内存值和索引创建完成后的实际内存占用值：

```sql
SELECT dbms_vector.index_vector_memory_advisor('HNSW_BQ',1000000,768,'FLOAT32','M=10,DISTANCE=L2');
+---------------------------------------------------------------------------------------------------------+
| dbms_vector.index_vector_memory_advisor('HNSW_BQ',1000000,768,'FLOAT32','M=10,DISTANCE=L2')             |
+---------------------------------------------------------------------------------------------------------+
| Suggested minimum vector memory is 4.1 GB, memory consumption when providing search service is 347.5 MB |
+---------------------------------------------------------------------------------------------------------+
1 row in set

```

查询 IVF 索引的建议内存值和索引创建完成后的实际内存占用值：

```sql
SELECT dbms_vector.index_vector_memory_advisor('IVF_FLAT',1000000,768,'FLOAT32','SAMPLE_PER_NLIST=1024,DISTANCE=L2');
+---------------------------------------------------------------------------------------------------------------+
| dbms_vector.index_vector_memory_advisor('IVF_FLAT',1000000,768,'FLOAT32','SAMPLE_PER_NLIST=1024,DISTANCE=L2') |
+---------------------------------------------------------------------------------------------------------------+
| Suggested minimum vector memory is 452.7 MB, memory consumption when providing search service is 384.0 KB     |
+---------------------------------------------------------------------------------------------------------------+
1 row in set

```

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