基于湖库一体架构，统一管理结构化、半结构化与非结构化等多模态数据，一个系统承载事务处理、实时分析与 AI 工作负载。
oceanbase.DBA_OB_AI_BATCH_TASKS
更新时间：2026-08-25 16:56:53
编辑
分享
说明
该视图从 V4.6.0 BP1 版本开始引入。
功能描述
展示本租户当前进行中的 AI Batch 任务信息，常用于监控 Batch File 模式建索引时的批量嵌入进度。
视图中将内部数值状态转换为字符串，并按已处理请求数与总请求数计算进度百分比。已完成或失败的任务会在约 10 分钟后归档至 DBA_OB_AI_BATCH_TASK_HISTORY，并从本视图中清理。如需长期追溯，请及时查询历史视图 DBA_OB_AI_BATCH_TASK_HISTORY。
字段说明
| 字段 | 类型 | 是否为 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 字符串。示例：{"ob_error_code":0,"model_http_code":429,"message":"Rate limit exceeded for requests"}。任务成功时通常为空或 ob_error_code 为 0。 |
查询示例
用户租户查询本租户内指定模型的 Batch 任务进度：
obclient [oceanbase]> SELECT * FROM oceanbase.DBA_OB_AI_BATCH_TASKS;
返回示例：
+-------------------------------------+-------------+-------------------+--------------+---------+------------------+----------------+------------------+----------------------------+----------------------------+------------------------+--------------------------------------------------+-----------------------------------------------------------+
| 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 |
+-------------------------------------+-------------+-------------------+--------------+---------+------------------+----------------+------------------+----------------------------+----------------------------+------------------------+--------------------------------------------------+-----------------------------------------------------------+
| ai_1002_1780641797310516_1543562579 | 106 | ob_embed_endpoint | EMBED | RUNNING | 0 | 1 | 0.00 | 2026-06-05 14:43:17.310525 | 2026-06-05 14:43:19.262477 | batch_38268a491ed64a90 | {"input_file_id": "file-batch-292094790baf42d8"} | {"message": "", "ob_error_code": 0, "model_http_code": 0} |
| ai_1002_1780641797312074_150571907 | 106 | ob_embed_endpoint | EMBED | RUNNING | 0 | 1 | 0.00 | 2026-06-05 14:43:17.312081 | 2026-06-05 14:43:17.361702 | batch_2291cf5289bf412d | {"input_file_id": "file-batch-651f39b2c3314897"} | {"message": "", "ob_error_code": 0, "model_http_code": 0} |
+-------------------------------------+-------------+-------------------+--------------+---------+------------------+----------------+------------------+----------------------------+----------------------------+------------------------+--------------------------------------------------+-----------------------------------------------------------+
2 rows in set
