向量数据库更新文件-SDK 参考-文档中心-腾讯云

功能介绍
update() 接口用于对通过主键（DocumentSet ID）与 Filter 表达式过滤检索 DocumentSet ，对 DocumentSet 的部分字段进行更新。同时，支持新增字段。
支持通过主键（DocumentSet ID）或文件名，搭配 Filter 表达式过滤需更新的文件。
支持新增字段，支持更改部分字段。
注意：
不能变更系统分配的 DocumentSet ID 字段，不要求事务完整性。
不能变更已上传的文件内容。
说明：
新增字段，在创建 CollectionView 时没有为这些字段设置索引，那么新增这些字段时，系统不会自动为其创建索引。
请求示例
根据文件名过滤需更新的文件
根据文件 ID 过滤需更新的文件
根据 Filter 表达式过滤需更新的文件
如下示例，修改文件名为腾讯云向量数据库.md，并满足 author 字段 Filter 表达式的文件的字段 author 为 tencent，新增字段 tag。
// link database
AIDatabase db = client.aiDatabase("db-test-ai");
// link collectionView
CollectionView collection = db.describeCollectionView("coll-ai-files");
// 设置查询条件，以便查询需更新的文件
CollectionViewConditionParam updateParam = CollectionViewConditionParam
        .newBuilder()
        .withDocumentSetNames(Arrays.asList("腾讯云向量数据库.md"))
        .withFilter(new Filter("author=\\"tencent\\""))
        .build();
Map<String, Object> updateFieldValues = new HashMap<>();
// 配置更新字段
updateFieldValues.put("author", "tencent");
// 新增字段
updateFieldValues.put("array_test", Arrays.asList("1", "2","5"));
// 更新操作
AffectRes affectRes = collection.update(updateParam, updateFieldValues);
// 输出
System.out.println("\\tres: " + affectRes.toString());
如下示例，修改指定文件 ID，并满足 Filter 表达式的文件的标量字段 author 为 tencent。
// link database
AIDatabase db = client.aiDatabase("db-test-ai");
// link collectionView
CollectionView collection = db.describeCollectionView("coll-ai-files");
// 设置查询条件，以便查询需更新的文件
CollectionViewConditionParam updateParam = CollectionViewConditionParam
        .newBuilder()
        .withDocumentSetIds(Arrays.asList("11793516237********"))
        .withFilter(new Filter("author=\\"tencent\\""))
        .build();
Map<String, Object> updateFieldValues = new HashMap<>();
// 配置更新字段
updateFieldValues.put("author", "tencent");
// 新增字段
updateFieldValues.put("array_test", Arrays.asList("1", "2","5"));
// 更新操作
collection.update(updateParam, updateFieldValues);
﻿
System.out.println(collection.query(10).get(0).toString());
﻿
如下示例，修改满足 author 的 Filter 表达式的文件的字段 author 为 tencent，并新增字段 tag。
// link database
AIDatabase db = client.aiDatabase("db-test-ai");
// link collectionView
CollectionView collection = db.describeCollectionView("coll-ai-files");
// 设置查询条件，以便查询需更新的文件
CollectionViewConditionParam updateParam = CollectionViewConditionParam
        .newBuilder()
        .withFilter(new Filter("author=\\"tencent\\""))
        .build();
Map<String, Object> updateFieldValues = new HashMap<>();
// 配置更新字段
updateFieldValues.put("author", "tencent");
// 新增字段
updateFieldValues.put("array_test", Arrays.asList("1", "2","5"));
// 更新操作
collection.update(updateParam, updateFieldValues);
﻿
System.out.println(collection.query(10).get(0).toString());
﻿
请求参数
参数名称
参数含义
子参数
是否必选
配置方法及要求
DocumentSetNames
指定需更新的文件名。
-
否
支持批量更新，数据元素最大值为20。
说明：
同时配置 DocumentSetNames 与 filter 参数，更新数据将会取二者的交集。
DocumentSetIds
指定需更新的文件 ID。
-
否
支持批量更新，数据元素最大值为20。
说明：
同时配置 DocumentSetIds 与 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')
updateFieldValues
设置需更新的字段。
old_field
否
当前已存在的字段，更新字段对应的数据。
类型：string。
字符长度要求：[1,256]。
﻿
﻿
new_field
否
新增字段，并给新字段赋值。
类型：string。
字符长度要求：[1,256]。
返回信息
res: AffectRes{affectedCount=1, code=0, msg='Operation success'}
参数名
参数含义
affectedCount
更新的文档数量。如果该参数返回的值为 0，说明更新无效。

参数名称	参数含义	子参数	是否必选	配置方法及要求
DocumentSetNames	指定需更新的文件名。	-	否	支持批量更新，数据元素最大值为20。说明：同时配置 DocumentSetNames 与 filter 参数，更新数据将会取二者的交集。
DocumentSetIds	指定需更新的文件 ID。	-	否	支持批量更新，数据元素最大值为20。说明：同时配置 DocumentSetIds 与 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')`
updateFieldValues	设置需更新的字段。	old_field	否	当前已存在的字段，更新字段对应的数据。类型：string。字符长度要求：[1,256]。
updateFieldValues	设置需更新的字段。			new_field	否	新增字段，并给新字段赋值。类型：string。字符长度要求：[1,256]。

参数名	参数含义
affectedCount	更新的文档数量。如果该参数返回的值为 0，说明更新无效。

更新文件

本页目录：

功能介绍

请求示例

请求参数

返回信息