向量数据库
用户之声——提建议·赢好礼> HOT
文档中心 > 向量数据库 > SDK 参考 > HTTP API > DocumentSet > delete

delete

最近更新时间：2024-05-28 21:48:13

我的收藏

本页目录：

功能介绍

/ai/documentSet/delete 接口用于删除存储于 CollectionView 中的文件。
支持批量删除，文件 ID 或文件名数组元素数量最大为 20。
支持使用 Filter 表达式过滤所需删除的所有文件。

请求示例

注意：
如下示例可直接复制，在 CVM 运行之前，您需在文本编辑器将 api_key=A5VOgsMpGWJhUI0WmUbY******************** 与 10.0.X.X 依据实际情况进行替换。
根据文件名查找需删除的文件
根据文件 ID 查找需删除的文件
如下示例，删除指定文件名，且满足 Filter 表达式的文件。
curl -i -X POST \\
  -H 'Content-Type: application/json' \\
  -H 'Authorization: Bearer account=root&api_key=A5VOgsMpGWJhUI0WmUbY********************' \\
  http://10.0.X.X:80/ai/documentSet/delete \\
  -d '{
    "database": "db-test-ai",
    "collectionView": "coll-ai-files",
    "query": {
        "documentSetName": ["腾讯云向量数据库.md"],
        "filter": "author in (\\"Tencent\\",\\"tencent\\")"
    }
}'
如下示例，删除指定文件 ID，且满足 Filter 表达式的文件。
curl -i -X POST \\
  -H 'Content-Type: application/json' \\
  -H 'Authorization: Bearer account=root&api_key=A5VOgsMpGWJhUI0WmUbY********************' \\
  http://10.0.X.X:80/ai/documentSet/delete \\
  -d '{
    "database": "db-test-ai",
    "collectionView": "coll-ai-files",
    "query": {
        "documentSetId": ["1179017994589437952"],
        "filter": "author in (\\"Tencent\\",\\"tencent\\")"
    }
}'

请求参数

参数名称
参数含义
子参数
是否必选
配置方法及要求
database
指定需删除文档的Database 名称。
-
是
使用 /database/list 获取集群中的数据库列表，复制需删除数据的集合所属的数据库名。
collectionView
指定需删除文档的CollectionView 名称。
-
是
使用 /ai/collectionView/list 获取指定数据库名下的 CollectionView 列表，复制需删除数据的集合视图。
query
设置查询条件。
documentSetName
否
表示要删除的 DocumentSet 的文件名称，可以批量删除，数据元素最大值为20。
说明：
同时配置 documentSetName 与 filter 参数，删除数据将会取二者的并集。
documentSetId
否
表示要删除的 DocumentSet 的 ID，可以批量删除，数据元素最大值为20。
说明：
同时配置 documentSetId 与 filter 参数，删除数据将会取二者的并集。
filter
否
使用创建 CollectionView 指定的 Filter 索引的字段设置查询过滤表达式。
Filter 表达式格式为 <field_name><operator><value>，多个表达式之间支持 and（与）、or（或）、not（非）关系。具体信息，请参见 混合检索。其中：
<field_name>：表示要过滤的字段名。
<operator>：表示要使用的运算符。
string ：匹配单个字符串值（=）、排除单个字符串值（!=）、匹配任意一个字符串值（in）、排除所有字符串值（not in）。其对应的 Value 必须使用英文双引号括起来。
uint64：大于（>）、大于等于（>=）、等于（=）、小于（<）、小于等于（<=）。例如：expired_time > 1623388524。
array：数组类型，包含数组元素之一（include）、排除数组元素之一（exclude）、全包含数组元素（include all）。例如，name include (\\"Bob\\", \\"Jack\\")。
<value>：表示要匹配的值。
示例：Filter('author="jerry"').And('page>20')

响应消息

状态码

状态码
含义
响应消息
200
删除 DocumentSet 成功
{
    "code": 0,
    "msg": "operation success",
    "affectedCount": 2
}
400
删除 DocumentSet 失败
{
  "code": 400,
  "msg": "operation failed, reason...."
}

返回参数

参数名
参数含义
affectedCount
删除文档数量。

中国站