向量数据库删除指定文件-SDK 参考-文档中心-腾讯云

功能介绍
delete() 接口用于删除存储于 CollectionView 文件。
def delete(
    document_set_id: str | List[str] = None,
    document_set_name: str | List[str] = None,
    filter: Filter = None,
    timeout: float = None
) -> Any
使用示例
说明：
支持批量删除，文件 ID 或文件名数组元素数量最大为20。
支持使用 Filter 表达式过滤所需删除的所有文件。
根据文件名过滤需删除的文件
根据文件 ID 过滤需删除的文件
根据 Filter 表达式过滤需删除的文件
如下示例，删除文件名为腾讯云向量数据库.md，并满足 Filter 表达式的文件，二者取并集。
import tcvectordb
from tcvectordb.model.document import Filter
from tcvectordb.model.enum import ReadConsistency
#create a database client object
client = tcvectordb.RPCVectorDBClient(url='http://10.0.X.X:80', username='root', key='eC4bLRy2va******************************', read_consistency=ReadConsistency.EVENTUAL_CONSISTENCY, timeout=30)
﻿
# 指定文件上传所属的文件
db = client.database('db-test-ai')
coll_view = db.collection_view('coll-ai-files')
﻿
res = coll_view.delete(
            document_set_name = ['腾讯云向量数据库.md'], 
            filter=Filter("author=\\"Tencent\\"")
        )
print(res)
如下示例，删除指定文件 ID，并满足 Filter 表达式的文件，二者取并集。
import tcvectordb
from tcvectordb.model.document import Filter
from tcvectordb.model.enum import ReadConsistency
#create a database client object
client = tcvectordb.RPCVectorDBClient(url='http://10.0.X.X', username='root', key='eC4bLRy2va******************************', read_consistency=ReadConsistency.EVENTUAL_CONSISTENCY, timeout=30)
﻿
# 指定文件上传所属的文件
db = client.database('db-test-ai')
coll_view = db.collection_view('coll-ai-files')
﻿
res = coll_view.delete(
            document_set_id=["11793516237********"], 
        )
print(res)
import tcvectordb
from tcvectordb.model.document import Filter
from tcvectordb.model.enum import ReadConsistency
#create a database client object
client = tcvectordb.RPCVectorDBClient(url='http://10.0.X.X', username='root', key='eC4bLRy2va******************************', read_consistency=ReadConsistency.EVENTUAL_CONSISTENCY, timeout=30)
﻿
# 指定文件上传所属的文件
db = client.database('db-test-ai')
coll_view = db.collection_view('coll-ai-files')
﻿
res = coll_view.delete(
            filter=Filter("author=\\"Tencent\\"")
        )
print(res)
入参描述
参数名称
参数含义
是否必选
配置方法及要求
document_set_name
指定需删除的文件名。
否
支持批量删除，数据元素最大值为20。
说明：
同时配置 document_set_name 与 filter 参数，删除数据将会取二者的交集。
document_set_id
指定需删除的文件 ID。
否
支持批量删除，数据元素最大值为20。
说明：
同时配置 document_set_id 与 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')
出参描述
{
    'code': 0, 
    'msg': 'Operation success', 
    'affectedCount': 1
 }
参数名
参数含义
affectedCount
删除的文档数量。

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

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

删除指定文件

本页目录：

功能介绍

使用示例

入参描述

出参描述