适用于: SQL Server 2025 (17.x)
Azure SQL 数据库
Azure SQL 托管实例
Microsoft Fabric 中的 SQL 数据库
sys.dm_db_vector_indexes动态管理视图返回关于向量索引健康和背景维护的实时信息。 使用此视图监控 DiskANN 图的补足操作,并识别可能需要关注的向量索引。
| 列名称 | 数据类型 | 说明 |
|---|---|---|
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;