文档中心

向量数据库VikingDB

请输入

数据（Data）

deleteData

概述

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

请求参数

参数名	类型	必选	备注
ResourceId	string	至少填写一个	资源 ID；与 `collectionName` 至少传入一个，同时传入时优先使用 `ResourceId`。
collectionName	string	至少填写一个	Collection 名称；未传 `ResourceId` 时必填。
IDs	[]interface{}	与 DelAll 至少填写一个	删除数据的主键列表（主键为 int64 或 string），最多 100 条。与 `DelAll=true` 至少满足一个；同时传入时按 `IDs` 删除。注意：若为请求参数非法（4xx 类型），则会全部失败。

DelAll	bool	与 IDs 至少填写一个	为 true 时删除所有数据，默认为 false。与 `IDs` 同时传入时按 `IDs` 删除；逻辑库不支持 `DelAll=true`。此接口删除所有数据，并不能立刻同步到索引，因此，在一段时间内（约 5 分钟），索引内仍可检索到数据。

返回参数

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

响应体公共参数介绍

参数名	类型	说明
RequestID	string	请求 ID。
Code	string	操作状态码。成功为`Success`，否则为错误码短语。
Message	string	执行信息。成功则为 `The API call was executed successfully.`。
Result	map[string]interface{}	操作结果。若无需返回数据，则 `result = null`。

示例

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

请求参数

package main

import (
    "context"
    "fmt"
    "github.com/volcengine/vikingdb-go-sdk/vector"
    "github.com/volcengine/vikingdb-go-sdk/vector/model"
    "os"
    "time"
)

func main() {
    var (
       accessKey = os.Getenv("VIKINGDB_AK")
       secretKey = os.Getenv("VIKINGDB_SK")
       endpoint  = "https://api-vikingdb.vikingdb.cn-beijing.volces.com"
       region    = "cn-beijing"
    )

    client, err := vector.New(
       vector.AuthIAM(accessKey, secretKey), // IAM auth
       vector.WithEndpoint(endpoint),
       vector.WithRegion(region),
       vector.WithTimeout(time.Second*30),
       vector.WithMaxRetries(3),
    )
    if err != nil {
       fmt.Println("New client failed, err: ", err)
       panic(err)
    }
    ctx := context.Background()

    resp, err := client.Collection(model.CollectionLocator{
       CollectionName: "<YOUR_COLLECTION_NAME>",
    }).Delete(ctx, model.DeleteDataRequest{
       IDs: []interface{}{1},
    })
    if err != nil {
       fmt.Println("Delete failed, err: ", err)
       panic(err)
    }

    fmt.Println(resp.Message)
}

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

这个页面对您有帮助吗？

有用

无用

向量数据库VikingDB

响应体公共参数介绍 #

请求参数 #

响应体公共参数介绍

请求参数