--- title: "oceanbase.DBA_OB_AI_BATCH_TASK_HISTORY - OceanBase 数据库 V4.6.0 | OceanBase 文档中心" description: oceanbase.DBA_OB_AI_BATCH_TASK_HISTORY 说明 该视图从 V4.6.0 BP1 版本开始引入。 功能描述 展示本租户已结束的 AI Batch 任务历史信息，常用于追溯 Batch File 模式建索引任务的结果、token 消耗及服务商侧各阶段耗时。 任务完成或失败后约 10 分… 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_AI_BATCH_TASK_HISTORY 更新时间：2026-08-12 15:21:43 [编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.6.0/zh-CN/700.reference/700.system-views/400.system-view-of-mysql-mode/200.dictionary-view-of-mysql-mode/5704.o-dba_ob_ai_batch_task_history-of-mysql-mode.md) #### 说明 该视图从 V4.6.0 BP1 版本开始引入。 ## 功能描述 展示本租户已结束的 AI Batch 任务历史信息，常用于追溯 Batch File 模式建索引任务的结果、token 消耗及服务商侧各阶段耗时。 任务完成或失败后约 10 分钟会从该视图归档至本历史视图。视图中将内部数值状态转换为字符串，并按已处理请求数与总请求数计算进度百分比。 与任务视图相比，本视图额外提供 token 用量统计（`TOKEN_USAGE`）及 AI 服务商侧 Batch 任务各阶段时间戳（`PROVIDER_TIMELINE`）。 ## 字段说明 | 字段 | 类型 | 是否为 NULL | 描述 | | --- | --- | --- | --- | | TASK_ID | varchar(256) | NO | AI Batch 任务唯一标识。 | | DDL_TASK_ID | bigint(20) | YES | 关联的 DDL 任务 ID。Batch File 建索引时，对应 `CREATE VECTOR INDEX` 触发的 DDL 任务。 | | MODEL_NAME | varchar(256) | NO | 使用的 AI 模型名称，对应 `DBMS_AI_SERVICE` 中注册的模型名。 | | COMMAND_TYPE | varchar(256) | NO | AI 调用类型，例如 `EMBED`。 | | STATUS | varchar(256) | NO | 任务终态，取值为 `INVALID`、`PENDING`、`RUNNING`、`FINISHED`、`FAILED`、`CANCELLED`、`UNKNOWN`。 | | REQUESTS_HANDLED | bigint(20) | NO | 已处理请求数。 | | TOTAL_REQUESTS | bigint(20) | NO | 总请求数。 | | PROGRESS_PERCENT | decimal | YES | 任务进度百分比，按 `REQUESTS_HANDLED / TOTAL_REQUESTS` 计算。 | | TASK_CREATE_TIME | timestamp | NO | 任务创建时间。 | | TASK_UPDATE_TIME | timestamp | NO | 任务最近状态更新时间。 | | BATCH_ID | varchar(256) | YES | AI 服务商侧 Batch 任务 ID。 | | REMOTE_FILE_IDS | varchar(2048) | YES | AI 服务商侧文件 ID，JSON 字符串。OpenAI 风格示例：`{"input_file_id":"file-in-xxx","output_file_id":"file-out-xxx","error_file_id":"file-err-xxx"}`；Anthropic 风格示例：`{"output_file_id":"msgbatch_yyy_result"}`。 | | ERROR_DETAIL | varchar(4096) | YES | OceanBase 及模型侧错误信息，JSON 字符串。示例：`{"message": "", "ob_error_code": 0, "model_http_code": 0}`。 | | TOKEN_USAGE | varchar(1024) | YES | Batch 任务在 AI 服务商侧实际消耗了多少 token，以 JSON 字符串返回。示例：`{"completion_tokens":1,"prompt_tokens":1,"total_tokens":2}`。 | | PROVIDER_TIMELINE | varchar(1024) | YES | AI 服务商侧 Batch 任务各阶段时间戳，JSON 字符串，单位为 Unix 秒。字段包括 `created_at`、`in_progress_at`、`finalizing_at`、`completed_at`、`failed_at`、`expired_at`、`expires_at`、`cancelling_at`、`cancelled_at`，均可为空。示例：`{"created_at":1746000000,"in_progress_at":1746000060,"completed_at":1746003700}`。 | ## 查询示例 用户租户查询本租户内已结束的任务历史： ```shell obclient [oceanbase]> SELECT * FROM oceanbase.DBA_OB_AI_BATCH_TASK_HISTORY; ``` 返回示例： ```shell obclient [oceanbase]> SELECT * FROM oceanbase.DBA_OB_AI_BATCH_TASK_HISTORY; +----------------------------------------------+-------------+-------------------+--------------+-----------+------------------+----------------+------------------+----------------------------+----------------------------+------------------------+----------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------+------------------------------------------------------------+---------------------------------+ | TASK_ID | DDL_TASK_ID | MODEL_NAME | COMMAND_TYPE | STATUS | REQUESTS_HANDLED | TOTAL_REQUESTS | PROGRESS_PERCENT | TASK_CREATE_TIME | TASK_UPDATE_TIME | BATCH_ID | REMOTE_FILE_IDS | ERROR_DETAIL | TOKEN_USAGE | PROVIDER_TIMELINE | +----------------------------------------------+-------------+-------------------+--------------+-----------+------------------+----------------+------------------+----------------------------+----------------------------+------------------------+----------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------+------------------------------------------------------------+---------------------------------+ | ai_1002_1780641797310516_1543562579 | 106 | ob_embed_endpoint | EMBED | FINISHED | 1 | 1 | 100.00 | 2026-06-05 14:43:17.310525 | 2026-06-05 14:44:20.458616 | batch_38268a491ed64a90 | {"input_file_id": "file-batch-292094790baf42d8", "output_file_id": "file-batch_output-5488cbb816f347e6"} | {"message": "", "ob_error_code": 0, "model_http_code": 0} | {"completion_tokens":0,"prompt_tokens":6,"total_tokens":6} | {"model_wait_time_us":61193090} | +----------------------------------------------+-------------+-------------------+--------------+-----------+------------------+----------------+------------------+----------------------------+----------------------------+------------------------+----------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------+------------------------------------------------------------+---------------------------------+ 1 row in set ``` ## 相关文档 - [AI 模型交互（Batch File）](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000006768679) - [DBA_OB_AI_BATCH_TASKS](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000006768685) 上一篇 下一篇 ![有帮助](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) 咨询热线