接口定义
update()
接口用于对通过主键(DocumentSet ID)与 Filter 表达式过滤检索 DocumentSet ,对 DocumentSet 的部分字段进行更新。同时,支持新增字段。Update(ctx context.Context, updateFields map[string]interface{}, param tcvectordb.UpdateAIDocumentSetParams) (*tcvectordb.UpdateAIDocumentSetResult, error)
使用示例
注意:
不能变更系统分配的 DocumentSet ID 字段,不要求事务完整性。
不能变更已上传的文件内容。
说明:
新增字段,在创建 CollectionView 时没有为这些字段设置索引,那么新增这些字段时,系统不会自动为其创建索引。
支持通过主键(DocumentSet ID)或文件名,搭配 Filter 表达式过滤需更新的文件。
支持新增字段,支持更改部分字段。
如下示例, 更新文件名为
tcvdb.md
的数据,修改其字段 author_name 为 jack。var (ctx = context.Background()aiDatabase = "go-sdk-test-ai-db"collectionViewName = "go-sdk-test-ai-coll")col := client.AIDatabase(aiDatabase).CollectionView(collectionViewName)result, _ := col.Update(ctx, map[string]interface{}{"author_name": "jack",}, tcvectordb.UpdateAIDocumentSetParams{DocumentSetName: []string{"腾讯云向量数据库.pdf"},})log.Printf("update affect count: %d", result.AffectedCount)
如下示例,修改指定文件 ID的数据,修改其字段 author_name 为 jack。
var (ctx = context.Background()aiDatabase = "go-sdk-test-ai-db"collectionViewName = "go-sdk-test-ai-coll")col := client.AIDatabase(aiDatabase).CollectionView(collectionViewName)result, _ := col.Update(ctx, map[string]interface{}{"author_name": "jack",}, tcvectordb.UpdateAIDocumentSetParams{DocumentSetId: []string{"001"},})log.Printf("update affect count: %d", result.AffectedCount)
如下示例,修改满足 author_name Filter 表达式的数据,修改其字段 author_name 为 jack。
var (ctx = context.Background()aiDatabase = "go-sdk-test-ai-db"collectionViewName = "go-sdk-test-ai-coll")col := client.AIDatabase(aiDatabase).CollectionView(collectionViewName)result, _ := col.Update(ctx, map[string]interface{}{"author_name": "jack",}, tcvectordb.UpdateAIDocumentSetParams{Filter: tcvectordb.NewFilter(`author_name="sam"`),})log.Printf("update affect count: %d", result.AffectedCount)
入参描述
参数 | 子参数 | 参数含义 | 是否必选 | 配置方法及要求 |
UpdateAIDocumentSetParams
| DocumentSetName | 指定需更新的文件名。 | 否 | 支持批量更新,数据元素最大值为20。 说明: 同时配置 DocumentSetName 与 Filter 参数,更新数据将会取二者交集。 |
| DocumentSetId | 指定需更新的文件 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') |
updateFields |
-
| 设置需更新的字段 | 否 | 当前已存在的字段,更新字段对应的数据。 类型:string。 字符长度要求:[1,256]。 |
| | | 否 | 新增字段,并给新字段赋值。 类型:string。 字符长度要求:[1,256]。 |