功能介绍
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 表达式过滤所需删除的所有文件。
如下示例,删除文件名为
腾讯云向量数据库.md
,并满足 Filter 表达式的文件,二者取并集。import tcvectordbfrom tcvectordb.model.document import Filterfrom tcvectordb.model.enum import ReadConsistency#create a database client objectclient = 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 tcvectordbfrom tcvectordb.model.document import Filterfrom tcvectordb.model.enum import ReadConsistency#create a database client objectclient = 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 tcvectordbfrom tcvectordb.model.document import Filterfrom tcvectordb.model.enum import ReadConsistency#create a database client objectclient = 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 | 删除的文档数量。 |