向量数据库更新文件

功能介绍
update() 接口用于对通过主键（DocumentSet ID）与 Filter 表达式过滤检索 DocumentSet ，对 DocumentSet 的部分字段进行更新。同时，支持新增字段。
public AffectRes update(CollectionViewConditionParam param, Map<String, Object> updateFieldValues)
使用示例
说明：
支持通过主键（DocumentSet ID）或文件名，搭配 Filter 表达式过滤需更新的文件。
支持新增字段，支持更改部分字段。新增字段，在创建 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("腾讯云向量数据库.pdf"))
        .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，说明更新无效。

更新文件

本页目录：

功能介绍

使用示例

入参描述

出参描述