sys.dm_db_vector_indexes(Transact-SQL)

适用于: SQL Server 2025 (17.x)Azure SQL 数据库Azure SQL 托管实例Microsoft Fabric 中的 SQL 数据库

sys.dm_db_vector_indexes动态管理视图返回关于向量索引健康和背景维护的实时信息。 使用此视图监控 DiskANN 图的补足操作,并识别可能需要关注的向量索引。

Transact-SQL 语法约定

列名称 数据类型 说明
object_id int 包含向量索引的表的对象ID。
index_id int 向量索引的识别。
graph_catchup_pending_percent 十进制(10,2) 等待被纳入 DiskANN 图的变更的概率。 随着后台维护处理待处理变更,值逐渐趋近于零。 如果没有执行图追赶任务,则该值可以为 NULL 。
quantized_keys_used_percent 十进制(10,2) 向量索引所占量化密钥空间的百分比。
last_background_task_execution_time datetime2 最近一次后台维护任务执行的时间。 NULL 如果没有执行任何后台任务。
last_background_task_succeeded bit 最近背景维护任务的成功状态。 1 表示成功, 0 表示失败, NULL 表示无后台任务执行。
last_background_task_duration_seconds bigint 最近一次后台维护任务的持续时间,以秒计。 NULL 如果没有执行任何后台任务。
last_background_task_processed_inserts bigint 最近一次背景维护任务处理的插入数量。 NULL 如果没有执行任何后台任务。
last_background_task_processed_deletes bigint 最近一次后台维护任务处理的删除次数。 NULL 如果没有执行任何后台任务。
last_background_task_error_message nvarchar(max) 最近一次后台维护任务报告的错误信息。 NULL 如果没有报告错误或没有执行任何后台任务。

注解

该视图为当前数据库中的每个向量索引返回一行。

向量索引通过异步后台维护将数据修改(包括插入、更新和删除)纳入DiskANN图中。 该 graph_catchup_pending_percent 列显示了尚未被纳入图表的变更的大致百分比。

功能可用性

向量数据类型和向量函数通常可在 SQL Server 2025、Azure SQL 数据库、Azure SQL 托管实例 以及 Fabric 中的 SQL 数据库中提供。

向量索引通常以Azure SQL 数据库形式提供,SQL 数据库可在Fabric中提供,并且Azure SQL 托管实例配置为 Always-up-to-date更新策略。

矢量索引是SQL Server 2025和Azure SQL 托管实例中的预览功能,配置为SQL Server 2025更新策略。

分析graph_catchup_pending_percent

该 graph_catchup_pending_percent 栏表示尚未被纳入DiskANN图的数据变更的大致百分比。

当你在带有向量索引的表格中插入、更新或删除行时,这些更改不会立即被纳入图表中。 这些变更由后台维护任务异步排队和处理。

数据修改后预期会有一个临时非零值。 随着后台维护将待处理的变更纳入图表,百分比逐渐趋近于零。

值为零表示图维护已经赶上。 NULL 值可能表示尚未执行任何图追赶任务。

对VECTOR_SEARCH查询的影响

VECTOR_SEARCH 在图追赶过程中,仍在运行。 它使用当前的 DiskANN 图,并加入尚未完全整合进图中的变更。

此行为意味着:

  • VECTOR_SEARCH 仍然可以考虑最近插入或更新的行。
  • 没有完全融入图表的行无法充分利用图的导航功能。
  • 在处理大量图的积压时,搜索性能或回忆可能会受到影响。
  • 当 graph_catchup_pending_percent 搜索质量和表现为零或持续处于低水平时最为可预测。

解释图追赶值

没有一个统一的阈值来保证高图的追赶百分比。 合适的阈值取决于工作负载、数据修改速率、数据库配置和预期维护周期。

在批量加载或DML活动高峰期,预计图追赶百分比会暂时上升。 监测工作量减少后,数值是否趋近于零。

如果你观察到以下任何条件,请研究向量指数:

  • 持续的图表补足积压:graph_catchup_pending_percent 保持高位,未向零移动。
  • 背景任务失败:last_background_task_succeeded 为0。
  • 后台任务错误:last_background_task_error_message 包含一个错误。
  • 召回率降低:VECTOR_SEARCH 返回的相关结果少于预期。
  • 意外的性能下降: 向量搜索延迟增加,而图的补足积压仍居高不下。

NULL 后台任务列的数值不一定代表失败。 他们可以表示尚未执行任何背景维护任务。

何时重新生成向量索引

当你观察到可测量的性能或回忆退化时,考虑重建向量指数。 不要仅凭临时非零 graph_catchup_pending_percent 值重建指数。

可能适合重建的情景包括:

  • 显著的回忆退化: 图追赶完成后,向量搜索返回的相关结果比预期的要少。
  • 大规模数据替换: 大多数或全部嵌入都会被替换,例如当数据被重新嵌入到不同模型时。
  • 持续维护问题: 图的追赶百分比没有下降,后台维护反复失败。

欲了解更多信息,请参见 向量指数的数据质量与维护指南。

Permissions

需要对数据库拥有 VIEW DATABASE STATE 权限。

Examples

A. 监视所有矢量索引

以下查询返回当前数据库中所有向量索引的图、补期和背景维护信息:

SELECT
    DB_NAME() AS database_name,
    OBJECT_SCHEMA_NAME(v.object_id) AS schema_name,
    OBJECT_NAME(v.object_id) AS table_name,
    i.name AS vector_index_name,
    v.graph_catchup_pending_percent,
    v.quantized_keys_used_percent,
    v.last_background_task_execution_time,
    v.last_background_task_succeeded,
    v.last_background_task_duration_seconds,
    v.last_background_task_processed_inserts,
    v.last_background_task_processed_deletes,
    v.last_background_task_error_message
FROM sys.dm_db_vector_indexes AS v
INNER JOIN sys.indexes AS i
    ON i.object_id = v.object_id
    AND i.index_id = v.index_id
ORDER BY
    v.graph_catchup_pending_percent DESC,
    schema_name,
    table_name,
    vector_index_name;

B。 监控特定表格

以下查询返回表的 dbo.Articles 向量索引维护信息:

SELECT
    OBJECT_SCHEMA_NAME(v.object_id) AS schema_name,
    OBJECT_NAME(v.object_id) AS table_name,
    i.name AS vector_index_name,
    v.graph_catchup_pending_percent,
    v.last_background_task_execution_time,
    v.last_background_task_succeeded,
    v.last_background_task_error_message
FROM sys.dm_db_vector_indexes AS v
INNER JOIN sys.indexes AS i
    ON i.object_id = v.object_id
    AND i.index_id = v.index_id
WHERE v.object_id = OBJECT_ID(N'dbo.Articles');

C. 识别可能需要关注的索引

以下示例使用15%作为示例监测阈值。 根据你的工作量选择合适的阈值:

DECLARE @GraphCatchupThreshold decimal(10,2) = 15.0;

SELECT
    OBJECT_SCHEMA_NAME(v.object_id) AS schema_name,
    OBJECT_NAME(v.object_id) AS table_name,
    i.name AS vector_index_name,
    v.graph_catchup_pending_percent,
    v.last_background_task_execution_time,
    v.last_background_task_succeeded,
    v.last_background_task_error_message
FROM sys.dm_db_vector_indexes AS v
INNER JOIN sys.indexes AS i
    ON i.object_id = v.object_id
    AND i.index_id = v.index_id
WHERE
    v.graph_catchup_pending_percent > @GraphCatchupThreshold
    OR v.last_background_task_succeeded = 0
    OR v.last_background_task_error_message IS NOT NULL
ORDER BY v.graph_catchup_pending_percent DESC;