文档中心

向量数据库VikingDB

请输入

数据(Data)

deleteData

概述

deleteData 用于在指定的 Collection 中删除数据。使用 ids 按主键删除时单次最多删除 100 条；使用 delete_all=True 时删除全部数据，不受 100 条限制。

请求参数

参数名	类型	必选	备注
collection_name	str	至少填写一个	Collection 名称；与 `resource_id` 至少传入一个，未传 `resource_id` 时必填。
resource_id	str	至少填写一个	Collection 对应的资源 ID；与 `collection_name` 同时传入时优先使用 `resource_id`。
ids	List[Any]	与 delete_all 至少填写一个	待删除的主键列表（int 或 str），最多 100 条。与 `delete_all=True` 至少满足一个；同时传入时按 `ids` 删除。非法请求会整体失败。
delete_all	Optional[bool]	与 ids 至少填写一个	对应 API 字段 `del_all`，为 True 时删除 Collection 内全部数据；与 `ids` 同时传入时按 `ids` 删除，逻辑库不支持 True。索引同步会有短暂延迟。

返回参数

本接口仅返回公共参数，result 恒为 null（详见下方“响应体公共参数介绍”）。

响应体公共参数介绍

参数名	类型	说明
request_id	string	请求 ID。
code	string	操作状态码。成功为`Success`，否则为错误码短语。
message	string	执行信息。成功则为 `The API call was executed successfully.`。
result	map	操作结果。本接口 `result` 恒为 `null`。

示例

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

请求参数

import os

from vikingdb import IAM
from vikingdb.vector import DeleteDataRequest, VikingVector

auth = IAM(
    ak=os.environ["VIKINGDB_AK"],
    sk=os.environ["VIKINGDB_SK"],
)
client = VikingVector(
    host=os.environ["VIKINGDB_HOST"],
    region=os.environ["VIKINGDB_REGION"],
    auth=auth,
    scheme="https",
)

collection_client = client.collection(collection_name=os.environ["VIKINGDB_COLLECTION"])
request = DeleteDataRequest(ids=[2532745373549703702])
response = collection_client.delete(request)
print(f"request_id={response.request_id}")

最近更新时间：2026.09.08 12:02:56

这个页面对您有帮助吗？

有用

无用

向量数据库VikingDB

响应体公共参数介绍 #

请求参数 #

响应体公共参数介绍

请求参数