美团是最早做团购的网站么,梅州站扩建,安徽六安有什么特产,wordpress去掉顶部空白本文介绍如何通过HTTP API向Collection中插入或更新Doc。 说明 若调用本接口时Doc Id已存在#xff0c;则等同于更新Doc#xff1b;Doc Id不存在#xff0c;则等同于插入Doc。 若调用本接口时不指定Doc Id#xff0c;则等同于插入Doc#xff0c;DashVector会自动生成Doc …本文介绍如何通过HTTP API向Collection中插入或更新Doc。 说明 若调用本接口时Doc Id已存在则等同于更新DocDoc Id不存在则等同于插入Doc。 若调用本接口时不指定Doc Id则等同于插入DocDashVector会自动生成Doc Id并在返回结果中携带id信息。
前提条件 已创建Cluster创建Cluster。 已获得API-KEYAPI-KEY管理。 Method与URL
HTTP
POST https://{Endpoint}/v1/collections/{CollectionName}/docs/upsert 使用示例
说明 需要使用您的api-key替换示例中的YOUR_API_KEY、您的Cluster Endpoint替换示例中的YOUR_CLUSTER_ENDPOINT代码才能正常运行。 本示例需要参考新建Collection-使用示例提前创建好名称为quickstart的Collection 插入或更新Doc
Shell
curl -XPOST \-H dashvector-auth-token: YOUR_API_KEY \-H Content-Type: application/json \-d {docs: [{id: 1, vector: [0.1, 0.2, 0.3, 0.4]}]} https://YOUR_CLUSTER_ENDPOINT/v1/collections/quickstart/docs/upsert# example output:
# {request_id:1b8b4ada-1148-49ce-82e3-f7f521bb6f3b,code:0,message:Success,output:[{doc_op:insert,id:1,code:0,message:}]} 插入或更新不带有Id的Doc
Shell
curl -XPOST \-H dashvector-auth-token: YOUR_API_KEY \-H Content-Type: application/json \-d {docs: [{vector: [0.1, 0.2, 0.3, 0.4]}]} https://YOUR_CLUSTER_ENDPOINT/v1/collections/quickstart/docs/upsert# example output:
# {request_id:9c3f2441-c47b-43a0-bb84-127ff6a88711,code:0,message:Success,output:[{doc_op:insert,id:6176745980928,code:0,message:}]} 插入或更新带有Fields的Doc
Shell
curl -XPOST \-H dashvector-auth-token: YOUR_API_KEY \-H Content-Type: application/json \-d {docs: [{id: 2, vector: [0.2, 0.3, 0.4, 0.5], fields: {age: 70, name: zhangshan,anykey1: str-value,anykey2: 1,anykey3: true,anykey4: 3.1415926}}]} https://YOUR_CLUSTER_ENDPOINT/v1/collections/quickstart/docs/upsert# example output:
# {request_id:e1467d91-f4fd-4944-9ec0-1634de426db1,code:0,message:Success,output:[{doc_op:insert,id:2,code:0,message:}]} 批量插入或更新Doc
Shell
curl -XPOST \-H dashvector-auth-token: YOUR_API_KEY \-H Content-Type: application/json \-d { docs: [ {id: 3, vector: [0.3, 0.4, 0.5, 0.6]},{id: 4, vector: [0.4, 0.5, 0.6, 0.7], fields: {age: 20, name: zhangsan}},{id: 5, vector: [0.5, 0.6, 0.7, 0.8], fields: {anykey: anyvalue}}]} https://YOUR_CLUSTER_ENDPOINT/v1/collections/quickstart/docs/upsert# example output:
# {request_id:113d221b-ec79-4fde-b546-58db5154e49d,code:0,message:Success,output:[{doc_op:insert,id:3,code:0,message:},{doc_op:insert,id:4,code:0,message:},{doc_op:insert,id:5,code:0,message:}]} 插入或更新带有Sparse Vector的Doc
Shell
curl -XPOST \-H dashvector-auth-token: YOUR_API_KEY \-H Content-Type: application/json \-d {docs: [{id: 6, vector: [0.1, 0.2, 0.3, 0.4], sparse_vector:{1:0.4, 10000:0.6, 222222:0.8}}]} https://YOUR_CLUSTER_ENDPOINT/v1/collections/quickstart/docs/upsert# example output:
# {request_id:c401e51d-430e-4c49-9d07-c944ec94de7b,code:0,message:Success,output:[{doc_op:insert,id:6,code:0,message:}]} 入参描述 参数 Location 类型 必填 说明 {Endpoint} path str 是 Cluster的Endpoint可在控制台Cluster详情中查看 {CollectionName} path str 是 Collection名称 dashvector-auth-token header str 是 api-key docs body array 是 待更新或插入的Doc列表 partition body str 否 Partition名称 出参描述 字段 类型 描述 示例 code int 返回值参考返回状态码说明 0 message str 返回消息 success request_id str 请求唯一id 19215409-ea66-4db9-8764-26ce2eb5bb99 output array 返回插入或更新Doc的结果DocOpResult列表 usage map 对Serverless实例按量付费集合的Doc插入或更新请求成功后返回实际消耗的写请求单元数 {Usage: {write_units: 4}
}
