文档中心

向量数据库VikingDB

请输入

数据(Data)

delete_data

概述

delete_data 用于在指定的 Collection 删除数据，根据主键删除单条或多条数据，单次最多允许删除100条数据。
异步调用使用async_delete_data接口，参数不变。

请求参数

参数	类型	是否必选	参数说明
id	string、int64、 list、 list	是	主键或主键构成的列表。

示例

运行示例前，请完成以下准备：
安装 VikingDB Python SDK，将完整代码保存为 example.py 后执行 python3 example.py。
将 <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> 或文档要求的路径格式。

请求参数

请在火山引擎控制台的密钥管理页面获取 AK 和 SK，并将示例中的 <YOUR_AK>、<YOUR_SK> 等占位符替换为真实配置。

# 获取指定数据集，程序初始化时调用即可，无需重复调用
from volcengine.viking_db.CollectionClient import CollectionClient

collection_client = CollectionClient("<YOUR_COLLECTION_NAME>", "api-vikingdb.volces.com", "cn-beijing", "<YOUR_AK>", "<YOUR_SK>", "http")

collection_client.delete_data("11")

# 异步调用
async def del_data():
    collection_client = CollectionClient("<YOUR_COLLECTION_NAME>", "api-vikingdb.volces.com", "cn-beijing", "<YOUR_AK>", "<YOUR_SK>", "http")
    res = await collection_client.async_delete_data("111")
asyncio.run(del_data())

返回值

Python 调用执行上面的任务，执行成功无返回信息。

使用说明修正

DeleteData 支持两种互斥模式：传主键列表删除指定数据，单次最多 100 个主键；或设置 DeleteAll=true 删除当前目标范围内的全部数据。使用 DeleteAll 时不要同时传主键列表，并在生产环境谨慎确认作用范围。

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

这个页面对您有帮助吗？

有用

无用

向量数据库VikingDB

请求参数 #

返回值 #

使用说明修正 #

请求参数

返回值

使用说明修正