文档中心

文档数据库 MongoDB 版

向量索引

创建向量索引

文档数据库 MongoDB 版提供向量搜索能力，支持基于语义相似度的数据检索。向量索引是实现高效向量检索的基础，适用于 RAG 知识库、智能问答、相似推荐等场景。本文介绍如何在控制台开通索引功能并创建向量索引。

前提条件

已创建 MongoDB 8.3 及以上版本的实例。具体操作步骤，请参见创建实例。

实例状态为运行中。关于实例状态的更多详情，请参见实例状态。

说明

当前 MongoDB 8.3 版本正处于邀测阶段，如需使用向量搜索功能，请提交工单联系技术申请使用。

背景信息

MongoDB 提供以下两种索引类型，您可根据业务场景按需选择。

向量索引

基于语义相似度进行检索，适用于 RAG 知识库、智能问答、相似推荐等 AI 应用场景，可实现文档与向量数据的一体化存储与检索。

全文索引

基于关键词匹配进行检索，适用于站内搜索、商品检索、日志查询等文档搜索场景，支持模糊匹配、相关性排序、自动补全等功能。

操作步骤

开通索引功能

说明

创建向量索引前，请先确认实例是否已启用检索功能（即是否已部署 Mongot 节点）。

已启用：无需执行本节操作，可直接创建向量索引。请根据向量化方式选择创建入口：

手动：使用您自行生成的向量数据，请参见创建向量索引。

自动：由系统调用方舟 Embedding 模型生成向量，请参见创建 Auto Embedding 向量索引。

未启用：请先启用检索功能并部署 Mongot 节点，再执行本节操作。完成后即可创建向量索引。该操作仅需执行一次。

索引功能开通后即时生效，且暂不支持关闭。

在顶部菜单栏，选择实例所属的项目和地域。

根据实例类型，在左侧导航栏中选择副本集实例列表或分片集实例列表。

在目标实例类型列表页，单击目标实例名称。

在实例详情页，单击搜索索引页签。

在搜索索引页签下，单击立即开通。

在 Mongot 节点配置页面，配置如下参数。

参数			说明
基本信息	实例类型	实例类型由系统自动识别，您无需选择。关于实例类型的更多信息，请参见产品架构。
实例配置			若实例类型为副本集，需配置如下参数： Mongot 节点节点规格：选择副本集实例中 Mongot 节点的规格。更多详情，请参见计算节点规格。节点数：当前固定为 2 个，暂不支持变更。存储空间：选择 Mongot 节点的存储空间，单位：GiB，步长为 10。建议与 Mongod 节点的初始配置保持一致。说明 Mongot 节点仅在开启检索功能后显示。 Mongot 节点采用双节点高可用架构部署，系统会自动执行故障切换，将流量路由到健康节点，请确保业务具备重试机制。为了确保在存储调整场景或备份恢复场景下的数据完整性，同时考虑到不同规格所能提供的最小存储差异，请确保此次变配或者恢复输入的存储空间不低于 20 GiB。请在满足上述条件下，购买匹配的规格和存储空间，步长为10 GiB，规格与存储范围对应表请参见产品规格。若实例类型为分片集群，需配置如下参数： Mongot 节点节点规格：选择分片集群中 Mongot 的节点规格。更多详情，请参见计算节点规格。单分片下节点数量：当前固定为 2 个。存储空间：选择 Mongot 节点的存储空间，单位：GiB，步长为 10。说明 Mongot 组件仅在开启检索功能后显示。

参数配置完成后，单击右下角的立即开通。

说明

单击立即开通后，实例会进入变更配置中状态，过程可能持续数分钟，请耐心等待。

该状态下不支持对实例进行任何其他操作（如查看实例信息详情、进行账号或备份管理等操作）。

开通后，根据您选择的计费类型完成后续支付步骤。

计费类型	操作步骤
按量计费	在确认订单页面，确认订单详情，阅读并勾选服务条款，单击立即购买。
包年包月	在确认订单页面，确认订单详情，阅读并勾选服务条款，单击提交订单。在确认订单信息页面，再次确认订单详情，单击下一步。在提交支付信息页面，确认支付明细并选择支付方式，单击去支付。

创建向量索引

在顶部菜单栏，选择实例所属的项目和地域。

根据实例类型，在左侧导航栏中选择副本集实例列表或分片集实例列表。

在目标实例类型列表页，单击目标实例名称。

在实例详情页，单击 AI 能力页签。

在向量索引页签下，单击创建索引。

在创建向量索引页面，配置如下参数。

参数			是否必填	说明
索引配置	检索类型	是	该参数固定为向量搜索，您无需选择。
索引配置		向量化方式	是	选择手动，即使用已经生成或计划使用自有模型、API 生成的向量。说明创建向量化方式为自动的向量索引，请参见创建 Auto Embedding 向量索引。
索引名称和数据源	索引名称	是	设置索引名称。名称需同时满足如下条件：只能以小写英文字母开头。只能以小写英文字母或数字结尾。只能包含英文字母、数字、下划线（_）和中划线（-）。长度需要在 3~128 个字符之间。更多详情，请参见约束与限制。不能以数字、中划线（-）开头。不能包含空格、中文、特殊字符和连续特殊符号。注意同一个实例下，索引名称必须是唯一的。
		数据库名	是	从下拉列表中选择索引所属的数据库。说明数据库名和表名均在创建数据库时设置。具体操作步骤，请参见数据库管理。
		表名	是	从下拉列表中选择索引所属的表。说明数据库名和表名均在创建数据库时设置。具体操作步骤，请参见数据库管理。

完成上述配置后，单击右下角的下一步，进入索引配置页面。

参数			是否必填	说明
配置信息	配置方法	是	您可选择可视化编辑器和 JSON 编辑器进行配置。可视化编辑器向量字段必填，单击添加向量字段，配置如下参数：字段路径：设置字段路径，即明确索引需要建立在哪个字段上。更多详情，请参见 path。向量维度：设置 MongoDB 向量搜索在索引时和查询时强制执行的向量维度数量。取值范围：1~8192。更多详情，请参见 numDimensions。相似度计算方式：从下拉列表中选择相似度算法。取值范围如下：点积（默认）：基于向量之间的夹角和幅度来衡量相似度。更多详情，请参见 Dot Product。欧氏距离：测量向量端点之间的距离，可用于从不同维度来衡量相似度。更多详情，请参见 Euclidean。余弦相似度：基于向量之间的夹角来测量相似度，可用于衡量不受 Magnitude （幅度）缩放影响的相似度。更多详情，请参见 Cosine。量化方式：从下拉列表中选择量化方式。量化是一种通过降低向量数据精度，来减少向量搜索索引对存储空间和内存占用的技术。更多详情，请参见向量量化。您可以根据实际业务对成本、性能、精度的需要，选择合适的量化方式： Binary：即对向量的数值信息二值化（Binarization）。若您的业务对向量搜索速度和成本有较高要求，可以选择二进制量化方式。更多详情，请参见 Binary quantization。 Scalar：即对向量的每一个维度（即每一个数值）进行独立量化。若您的业务对数据精度要求较高，可以选择标量量化方式。更多详情，请参见 Scalar quantization。 None：不使用任何量化方式压缩精度，可以保证向量完全不失真。说明支持同时添加多个向量字段，最多添加 20 个。过滤字段选填，单击添加过滤字段，为索引设置预过滤字段的路径。说明对于嵌套字段，使用点分法来指定嵌入式字段的路径，只需要填写字段的 key 即可，不需要填写字段类型。比如 name 、info.age 都是合法值。支持同时添加多个过滤字段，最多添加 20个。 JSON 编辑器您可在 JSON 编辑器中自行配置字段路径、向量维度、相似度计算方式、量化方式和量化方式路径。

索引配置完成后，单击下一步，确认创建信息。

可视化编辑器，确认您配置的向量字段、过滤字段及 JSON 预览信息。

JSON 编辑器，确认您编辑的 JSON 预览信息。

确认无误后，单击右下角的确定，完成索引创建。

创建完成后，在索引列表中查看新创建的索引，状态显示为运行中，即表示创建成功。

说明

索引创建是一个异步操作，需要一定时间完成，建议在确认索引状态变为 READY 后再执行搜索。关于索引状态的更多信息，请参见 $listSearchIndexes（聚合阶段）。

API	描述
CreateDBInstance	调用 CreateDBInstance 接口创建 MongoDB 实例。
DescribeNodeSpecs	调用 DescribeNodeSpecs 接口查询 MongoDB 支持的节点规格列表。
DescribeDBInstances	调用 DescribeDBInstances 接口查询 MongoDB 实例的基本信息。
DescribeDBInstanceDetail	调用 DescribeDBInstanceDetail 接口查询目标 MongoDB 实例的详细信息。