--- title: "oceanbase.DBA_OB_VECTOR_INDEX_TASK_HISTORY - OceanBase 数据库 V4.6.0 | OceanBase 文档中心" description: oceanbase.DBA_OB_VECTOR_INDEX_TASK_HISTORY 说明 该视图从 V4.4.1 版本开始引入。 功能描述 视图 DBA_OB_VECTOR_INDEX_TASK_HISTORY 展示了当前租户下所有向量索引相关后台任务的历史信息，包括分区重建、Segment 转储与合并、IVF 聚… image: https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*OSPzQ6GUQF4AAAAAQHAAAAgAeiGDAQ/original --- 切换语言 - 中文站 - 简体中文 - International - English - 日本站 - 日本語 文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*P8CuR4UJ_FkAAAAAAAAAAAAADiGDAQ/original) OceanBase 数据库分布式版 - V 4.6.0 # oceanbase.DBA_OB_VECTOR_INDEX_TASK_HISTORY 更新时间：2026-08-18 15:31:44 [编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.6.0/zh-CN/700.reference/700.system-views/300.system-view-of-sys-tenant/200.dictionary-view-of-sys-tenant/24160.o-dba_ob_vector_index_task_history-of-sys-tenant.md) #### 说明 该视图从 V4.4.1 版本开始引入。 ## 功能描述 视图 `DBA_OB_VECTOR_INDEX_TASK_HISTORY` 展示了当前租户下所有向量索引相关后台任务的历史信息，包括分区重建、Segment 转储与合并、IVF 聚类中心加载与清理、语义索引刷新、内存同步等，可通过视图中的 `TASK_TYPE` 字段区分任务类型。 ## 字段说明 | 字段名称 | 字段类型 | 是否可以为 NULL | 描述 | | --- | --- | --- | --- | | TABLE_ID | bigint(20) | YES | 表 ID | | TABLET_ID | bigint(20) | YES | 分区 ID | | TASK_ID | bigint(20) | YES | 任务 ID | | CREATE_TIME | timestamp(6) | YES | 任务创建时间 #### 说明 该字段从 V4.6.0 BP1 版本开始支持。 | | MODIFY_TIME | timestamp(6) | YES | 任务更新时间。每次更新表中该行记录时自动刷新 #### 说明 该字段从 V4.6.0 BP1 版本开始含义由任务结束时间变为任务更新时间。 | | TRIGGER_TYPE | varchar(16) | NO | 任务触发类型： - `AUTO`：系统自动发现并触发的任务 - `MANUAL`：用户手动触发的任务 #### 说明 从 V4.6.0 BP1 版本开始，该字段由数值改为字符串枚举展示。 | | STATUS | varchar(16) | NO | 任务状态： - `PREPARE`：任务等待执行 - `RUNNING`：任务执行中 - `PENDING`：任务暂停 - `FINISHED`：任务已结束 - `EXCHANGE`：新旧索引交换中（此状态为自动分区重建任务的特有状态） - `CLEAN`：资源清理中（此状态为自动分区重建任务的特有状态） - `STANDBY`：手动触发的任务等待节点认领并执行 - `QUEUE`：任务在多优先级队列中排队 - `CANCEL`：任务已被取消 #### 说明 从 V4.6.0 BP1 版本开始，该字段由数值改为字符串枚举展示，并新增 `EXCHANGE`、`CLEAN`、`STANDBY`、`QUEUE`、`CANCEL` 状态。 | | TASK_TYPE | varchar(64) | NO | 任务类型： - `PARTITION_REBUILD`：分区重建任务 - `IVF_CACHE_LOAD`：IVF 聚类中心加载任务 - `IVF_CACHE_CLEAN`：IVF 聚类中心清理任务 - `SEMANTIC_INDEX_REFRESH`：语义索引刷新任务 - `INCREMENTAL_INDEX_FREEZE`：Segment 转储任务 - `INCREMENTAL_INDEX_MERGE`：Segment 合并任务 - `MEM_SYNC`：内存同步任务（含 Leader、Follower） #### 说明 从 V4.6.0 BP1 版本开始，该字段由数值改为字符串枚举展示，并新增 `IVF_CACHE_LOAD`、`IVF_CACHE_CLEAN`、`SEMANTIC_INDEX_REFRESH`、`MEM_SYNC` 任务类型。 | | TASK_SCN | bigint(20) | NO | 任务版本号 | | RET_CODE | bigint(20) | NO | 任务结束时候的状态： - `0`：成功 - `非 0`：失败 | | TRACE_ID | varchar(512) | NO | 任务执行追踪 ID | | TASK_INFO | longtext | NO | 任务的详细进度信息。以 JSON 格式展示，内容包括对合并数据段（Segment）任务的中各个 Segment 的详细信息，如 SCN、Key 范围、索引及内存占用信息等；对于分区级索引重建、增量 Segment 合并等内存消耗较大的任务，还可能包含 `mem_limit_info` 段，记录内存限流相关信息（内存限流从 V4.6.0 BP1 版本开始支持）。便于全面了解任务执行过程。 | | EXEC_ADDR | varchar(52) | YES | 执行该任务的节点（格式为 ip:port），用于标识任务实际运行的服务器地址，默认为空。 #### 说明 该字段从 V4.6.0 BP1 版本开始支持。 | | PRIORITY | int | NO | 任务优先级，数值越小优先级越高，依次递减。默认值为 0。 #### 说明 该字段从 V4.6.0 BP1 版本开始支持。 | | START_TIME | timestamp(6) | YES | 任务开始执行时间，默认为空。 | | END_TIME | timestamp(6) | YES | 任务执行结束时间，默认为空。 #### 说明 该字段从 V4.6.0 BP1 版本开始支持。 | | ERR_MSG | varchar(1024) | YES | 任务失败时的错误信息，默认为空。 #### 说明 该字段从 V4.6.0 BP1 版本开始支持。 | ## 查询示例 ### 完整示例 系统租户下，查看所有租户的向量索引性能优化任务历史信息。 ```sql SELECT * FROM oceanbase.DBA_OB_VECTOR_INDEX_TASK_HISTORY ORDER BY MODIFY_TIME DESC\G; ``` 查询结果如下： ```shell *************************** 1. row *************************** TABLE_ID: 500180 TABLET_ID: 1152921504606847128 TASK_ID: 10091 CREATE_TIME: 2026-03-25 23:20:31.475323 MODIFY_TIME: 2026-03-25 23:20:32.484323 TRIGGER_TYPE: AUTO STATUS: FINISHED TASK_TYPE: INCREMENTAL_INDEX_MERGE TASK_SCN: 1774452031481903000 RET_CODE: 0 TRACE_ID: Y2C277F000001-00064DDA40B0F2AE-0-1 TASK_INFO: {"merge_segments_cnt":2,"merge_segments":[{"scn":1774451941331810002,"start_key":"1152921504606847129_1774451941331810002_hnsw_data_part00000","end_key":"1152921504606847129_1774451941331810002_hnsw_data_part00000","index_type":"HNSW","vector_cnt":"1005","mem_used":"252512","mem_hold":"252512","min_vid":"11","max_vid":"10005"},{"scn":1774452021463248000,"start_key":"1152921504606847129_1774452021463248000_hgraph_data_part00000","end_key":"1152921504606847129_1774452021463248000_hgraph_data_part00002","index_type":"HGRAPH","vector_cnt":"1000","mem_used":"8484032","mem_hold":"8484032","min_vid":"1011","max_vid":"2010"}],"result_segments":[{"scn":1774452031481903000,"start_key":"1152921504606847129_1774452031481903000_hnsw_data_part00000","end_key":"1152921504606847129_1774452031481903000_hnsw_data_part00000","index_type":"HNSW","vector_cnt":"2005","mem_used":"803354","mem_hold":"0","min_vid":"11","max_vid":"10005"}]} EXEC_ADDR: 11.xxx.xx.xx:30510 PRIORITY: 0 START_TIME: 2026-03-25 23:20:31.476100 END_TIME: 2026-03-25 23:20:32.484323 ERR_MSG: NULL 1 row in set ``` TASK_INFO 字段 JSON 字符串说明： | 字段名 | JSON 字段类型 | 含义 | | --- | --- | --- | | merge_segments_cnt | string | 需要被合并的 Segment 数量 | | merge_segments | array | 合并前的 Segment 信息，数量和 merge_segments_cnt 相等 | | result_segments | array | 合并后的 Segment 结果信息 | | scn | string | 内部时间戳 | | start_key | string | Segment 存储范围的上界 | | end_key | string | Segment 存储范围的下界 | | index_type | string | Segment 处理向量的索引类型，包含值有： - HNSW - HNSW_SQ - HNSW_BQ - HGRAPH - SINDI | | mem_used | string | Segment 使用的内存 | | mem_limit_info | object | 内存限流相关信息，包含 `task_memory_limited`、`vector_mem_hold`、`vector_mem_limit`、`task_estimate_memory`、`tasks_total_reserved_memory` 等字段。仅在分区级索引重建、增量 Segment 合并等内存消耗较大的任务中可能出现。 | | min_vid | string | Segment 最小的向量 ID | | max_vid | string | Segment 最大的向量 ID | ### 查看内存限流信息 #### 说明 本功能从 V4.6.0 BP1 版本开始支持。 对于分区级索引重建、增量 Segment 合并等内存消耗较大的任务，任务完成后 `TASK_INFO` 字段中会包含 `mem_limit_info` 段，记录内存限流相关信息。可通过以下 SQL 查询内存预估与限流信息： ```sql SELECT TABLET_ID, TASK_TYPE, JSON_EXTRACT(TASK_INFO, '$.mem_limit_info.task_estimate_memory') AS estimate_mem, JSON_EXTRACT(TASK_INFO, '$.mem_limit_info.vector_mem_hold') AS mem_hold, JSON_EXTRACT(TASK_INFO, '$.mem_limit_info.vector_mem_limit') AS mem_limit, JSON_EXTRACT(TASK_INFO, '$.mem_limit_info.task_memory_limited') AS was_throttled FROM OCEANBASE.DBA_OB_VECTOR_INDEX_TASK_HISTORY WHERE TASK_TYPE = 'PARTITION_REBUILD'; ``` `mem_limit_info` 字段的子字段详细说明如下： | 子字段 | 单位 | 说明 | | --- | --- | --- | | `task_memory_limited` | | 是否触发过内存限流（true/false） | | `vector_mem_hold` | 字节 | 任务调度时租户向量内存已使用量 | | `vector_mem_limit` | 字节 | 租户向量内存总限额 | | `task_estimate_memory` | 字节 | 当前任务的预估内存需求 | | `tasks_total_reserved_memory` | 字节 | 其他运行中任务的总预留内存 | ## 相关视图或文档 - [CDB_OB_VECTOR_INDEX_TASK_HISTORY](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005684214) - HNSW 向量索引转储、合并与任务类型的关系，请参见 [向量索引原理](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005699342) - 运维与手动触发说明，请参见 [索引监控与维护](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005682087) 上一篇 下一篇 ![有帮助](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) 咨询热线