文档中心

向量数据库VikingDB

请输入

离线任务(Task)

任务查询

概述

查询指定 task 的详情信息和执行进度

请求参数

字段名	类型	必须	说明
taskId	string	是	任务ID，在创建任务时返回

示例

运行示例前，请完成以下准备：
在 Java 项目中引入 VikingDB SDK，并将示例放入可执行的 main 方法后编译运行。
将 <YOUR_HOST>、<YOUR_REGION> 和 <YOUR_SCHEME> 替换为地域和访问域名中与实例一致的服务地址、地域和协议。
将 <YOUR_AK>、<YOUR_SK> 替换为火山引擎控制台“密钥管理”中创建的 Access Key ID 和 Secret Access Key；请勿把真实凭证提交到代码仓库。
将 Collection、Index、Task 等资源占位符替换为控制台中对应资源的名称或接口返回的 ID。若示例包含 TOS 路径，请从 TOS 控制台确认桶名和对象路径，并使用 tos://<YOUR_BUCKET_NAME>/<YOUR_OBJECT_KEY> 或文档要求的路径格式。

请求参数

import java.util.ArrayList;
import java.util.HashMap;
import java.util.IdentityHashMap;
import java.util.List;
import java.util.Random;

import org.apache.http.HttpHost;

import java.util.Map;
import com.volcengine.service.vikingDB.Collection;
import com.volcengine.service.vikingDB.Index;
import com.volcengine.service.vikingDB.VikingDBService;
import com.volcengine.service.vikingDB.common.*;

public class test {
    public static void main(String[] args) throws Exception {
        VikingDBService vikingDBService = new VikingDBService("<YOUR_HOST>", "<YOUR_REGION>", "<YOUR_AK>", "<YOUR_SK>", "<YOUR_SCHEME>");
        
        Task task = vikingDBService.getTask("<YOUR_TASK_ID>");
    }
}

返回值

属性	类型	说明
task_id	string	任务ID
task_type	string	任务类型
task_status	string	任务状态
update_person	string	任务更新人
update_time	string	任务信息更新时间
create_time	string	任务信息创建时间
process_info	map	任务处理信息，例如进度等
task_params	map	任务配置信息，用户填入

task_type 类型包括

data_import	数据导入任务
data_export	数据导出任务
filter_update	数据过滤更新任务
filter_delete	数据过滤删除任务

task_status 任务状态包括

init	queued	confirm	confirmed	running	done	fail
初始化中	排队中	需要人工确认	已确认	执行中	完成	失败

process_info 任务信息包括

字段	类型	说明
task_progress	string	任务进度例如50%
err_msg	string	任务错误信息
sampled_data	list	采样5条数据用于展示
sampled_timestamp	int64	采样的时间戳，后写入的数据不会被处理
scan_data_count	int64	当前扫描数据量
total_data_count	int64	collection 数据总条数(预估）
total_filter_count	int64	已经过滤出的数据

返回说明补充

create_time 与 update_time 为字符串，格式为 YYYY-MM-DD HH:mm:ss，时区为 Asia/Shanghai（UTC+8）。解析时不要按本地系统时区二次偏移。

返回说明补充

sampled_timestamp 类型为 int64，单位为毫秒，是 Unix Epoch 时间戳；晚于该采样点写入的数据不会被本次任务处理。

错误处理补充

返回结构补充

字段	类型	含义
`code`	int	业务状态码；成功时为 0。
`message`	string	状态说明或错误信息。
`request_id`	string	请求唯一标识，用于问题排查。
`data`	object / array	接口业务数据；没有业务数据时可为空。

错误码

本接口的业务错误码、触发条件和处理建议统一参见向量库 V1 错误码。排查时请保留响应中的 request_id。

最近更新时间：2026.09.08 15:30:59

这个页面对您有帮助吗？

有用

无用

向量数据库VikingDB

请求参数 #

返回说明补充 #

返回说明补充 #

错误处理补充 #

返回结构补充 #

错误码 #

请求参数

返回说明补充

返回说明补充

错误处理补充

返回结构补充

错误码