删除指定文件

最近更新时间:2024-07-03 15:28:31

我的收藏

功能介绍

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

请求示例

根据文件名过滤需删除的文件
根据文件 ID 过滤需删除的文件
根据 Filter 表达式过滤需删除的文件
如下示例,删除文件名为 tcvdb.md的文件。
var (
ctx = context.Background()
aiDatabase = "go-sdk-test-ai-db"
collectionViewName = "go-sdk-test-ai-coll"
)

col := client.AIDatabase(aiDatabase).CollectionView(collectionViewName)
result, _ := col.Delete(ctx, tcvectordb.DeleteAIDocumentSetParams{
DocumentSetNames: []string{"tcvdb.md"},
})
log.Printf("delete affect count: %d", result.AffectedCount)

如下示例,删除指定文件 ID 的文件。
var (
ctx = context.Background()
aiDatabase = "go-sdk-test-ai-db"
collectionViewName = "go-sdk-test-ai-coll"
)

col := client.AIDatabase(aiDatabase).CollectionView(collectionViewName)
result, _ := col.Delete(ctx, tcvectordb.DeleteAIDocumentSetParams{
DocumentSetIds: []string{"001"},
})
log.Printf("delete affect count: %d", result.AffectedCount)
如下示例,删除满足 author_name 字段 Filter 条件表达式的文件。
var (
ctx = context.Background()
aiDatabase = "go-sdk-test-ai-db"
collectionViewName = "go-sdk-test-ai-coll"
)

col := client.AIDatabase(aiDatabase).CollectionView(collectionViewName)
result, _ := col.Delete(ctx, tcvectordb.DeleteAIDocumentSetParams{
Filter: tcvectordb.NewFilter(`author_name="sam"`),
})
log.Printf("delete affect count: %d", result.AffectedCount)

请求参数

参数名称
参数含义
是否必选
配置方法及要求
DocumentSetNames
指定需删除的文件名。
支持批量删除,数据元素最大值为20。
说明:
同时配置 DocumentSetName filter 参数,删除数据将会取二者交集。
DocumentSetIds
指定需删除的文件 ID。
支持批量删除,数据元素最大值为20。
说明:
同时配置 DocumentSetId filter 参数,删除数据将会取二者的交集。
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')