基于湖库一体架构，统一管理结构化、半结构化与非结构化等多模态数据，一个系统承载事务处理、实时分析与 AI 工作负载。
oceanbase.DBA_OB_AI_BATCH_TASK_HISTORY
更新时间：2026-08-12 15:21:43
编辑
分享
说明
该视图从 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}。 |
查询示例
用户租户查询本租户内已结束的任务历史：
obclient [oceanbase]> SELECT * FROM oceanbase.DBA_OB_AI_BATCH_TASK_HISTORY;
返回示例：
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
