--- title: "oceanbase.DBA_OB_AI_BATCH_TASKS - OceanBase 数据库 V4.6.0 | OceanBase 文档中心" description: oceanbase.DBA_OB_AI_BATCH_TASKS 说明 该视图从 V4.6.0 BP1 版本开始引入。 功能描述 展示本租户当前进行中的 AI Batch 任务信息，常用于监控 Batch File 模式建索引时的批量嵌入进度。 视图中将内部数值状态转换为字符串，并按已处理请求数与总请求数计算进度百分比… 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_TASKS 更新时间：2026-08-25 16:56:53 [编辑](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/5705.o-dba_ob_ai_batch_tasks-of-mysql-mode.md) #### 说明 该视图从 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 任务进度： ```shell obclient [oceanbase]> SELECT * FROM oceanbase.DBA_OB_AI_BATCH_TASKS; ``` 返回示例： ```shell +-------------------------------------+-------------+-------------------+--------------+---------+------------------+----------------+------------------+----------------------------+----------------------------+------------------------+--------------------------------------------------+-----------------------------------------------------------+ | 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 ``` ## 相关文档 - [AI 模型交互（Batch File）](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000006768679) - [DBA_OB_AI_BATCH_TASK_HISTORY](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000006768684) 上一篇 下一篇 ![有帮助](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) 咨询热线