文档中心

向量数据库VikingDB

请输入

任务创建

Collection 数据过滤删除任务

概述

按特定条件批量删除Collection中的数据

请求参数

参数名	类型	必须	说明	子字段	类型	必选	说明
task_type	string	是	任务类型，填入 filter_delete
task_params	map	是	任务参数	collection_name	string	是	Collection 名称，必填
				filter_conds	map	是	过滤条件，支持 must 、must_not、range、range_out 算子，使用参考标量过滤过滤删除 city 为 beijing 且 user_id (0, 4) 之间的数据 `JSON <br> [ <br> { <br> "op": "must", <br> "field": "city", <br> "conds": ["beijing"] <br> }, <br> { <br> "op": "range", <br> "field": "user_id", <br> "gt": 0, <br> "lt": 4 <br> }, <br> <br> ] <br>`
				need_confirm	bool	否	为false时可跳过人工确认环节，默认为true。为 true 时需要执行任务更新接口
				tos_path	string	否	在实际执行数据删除前，将数据备份到指定目录，参考数据导出功能。
				file_type	string	否	备份文件类型 json 或者 parquet，默认为 parquet

若要将数据备份至TOS，请先授权 VikingDB 跨服务访问 TOS 去授权

示例

运行示例前，请完成以下准备：
安装对应版本的 VikingDB Python SDK，将完整代码保存为 example.py 后执行 python3 example.py。
AK/SK 在火山引擎控制台“密钥管理”中创建；Host 和 Region 取自地域和访问域名。请按代码的参数或环境变量读取方式完成配置。
Collection、Index 名称从 VikingDB 控制台对应资源详情获取；Task ID 使用创建或查询任务接口返回的 ID。请将 <YOUR_...> 占位符替换为真实值。
若示例包含 TOS 路径，请从 TOS 控制台确认桶名和对象路径，并替换为真实的 <YOUR_BUCKET_NAME>/<YOUR_TOS_PATH>。

请求参数

from volcengine.viking_db import *

vikingdb_service = VikingDBService()
vikingdb_service.set_ak()
vikingdb_service.set_sk()
task_params = {
    "collection_name": "example", # collection 名称
    "filter_conds": [
        {
            "op": "must",
            "field": "city",
            "conds": ["beijing"]
        },
        {
            "op": "range",
            "field": "user_id",
            "gt": 0,
            "lt": 4
        },
    ]
}
task_id = vikingdb_service.create_task(TaskType.Filter_Delete, task_params)

返回值

属性	说明
task_id	uuid

后续处理

如果需要人工确认，可执行任务更新操作

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

这个页面对您有帮助吗？

有用

无用

向量数据库VikingDB

请求参数 #

返回值 #

后续处理 #

请求参数

返回值

后续处理