使用本地文件或公網(wǎng)可免密訪問的文件鏈接異步上傳向量數(shù)據(jù),最大支持200MB。
接口說明
此接口為UpsertCollectionData
對應(yīng)的異步接口。UpsertCollectionData
接口的請求最大只支持 10MB,此接口最大支持 200MB。
說明
相關(guān)接口
通過 GetUpsertCollectionDataJob 接口查看上傳進(jìn)度和結(jié)果。
通過 CancelUpsertCollectionDataJob 接口取消上傳任務(wù)。
注意 對于同一個(gè) Collection 目前只允許串行上傳數(shù)據(jù)任務(wù),不允許并發(fā)上傳。
調(diào)試
您可以在OpenAPI Explorer中直接運(yùn)行該接口,免去您計(jì)算簽名的困擾。運(yùn)行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
授權(quán)信息
下表是API對應(yīng)的授權(quán)信息,可以在RAM權(quán)限策略語句的Action
元素中使用,用來給RAM用戶或RAM角色授予調(diào)用此API的權(quán)限。具體說明如下:
- 操作:是指具體的權(quán)限點(diǎn)。
- 訪問級別:是指每個(gè)操作的訪問級別,取值為寫入(Write)、讀取(Read)或列出(List)。
- 資源類型:是指操作中支持授權(quán)的資源類型。具體說明如下:
- 對于必選的資源類型,用背景高亮的方式表示。
- 對于不支持資源級授權(quán)的操作,用
全部資源
表示。
- 條件關(guān)鍵字:是指云產(chǎn)品自身定義的條件關(guān)鍵字。
- 關(guān)聯(lián)操作:是指成功執(zhí)行操作所需要的其他權(quán)限。操作者必須同時(shí)具備關(guān)聯(lián)操作的權(quán)限,操作才能成功。
操作 | 訪問級別 | 資源類型 | 條件關(guān)鍵字 | 關(guān)聯(lián)操作 |
---|---|---|---|---|
gpdb:UpsertCollectionDataAsync | create |
|
| 無 |
請求參數(shù)
名稱 | 類型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
RegionId | string | 是 | 實(shí)例所在 Region ID。 | cn-hangzhou |
DBInstanceId | string | 否 | 實(shí)例 ID。 說明
您可以調(diào)用 DescribeDBInstances 接口查看目標(biāo)地域下所有的 AnalyticDB PostgreSQL 實(shí)例的詳情,包括實(shí)例 ID。
| gp-xxxxxxxxx |
Namespace | string | 否 | 命名空間,默認(rèn)為 public。 說明
您可以通過 CreateNamespace 接口創(chuàng)建,通過 ListNamespaces 接口查看列表。
| mynamespace |
Collection | string | 是 | 集合名。 說明
您可以通過 ListCollections 接口查看列表。
| document |
NamespacePassword | string | 是 | 命名空間對應(yīng)的密碼。 說明
本值為 CreateNamespace 接口指定。
| testpassword |
FileUrl | string | 是 | 公網(wǎng)可訪問的向量數(shù)據(jù)文件 URL 地址。 說明
{String Id; Map<String, Object> Metadata; List<Double> Vector} , 如{"Id":"myid", "Metadata": {"my_meta_key": "my_meta_value"}, "Vector": [1.234, -0.123]} 。 | https://xx/vectors.jsonl |
WorkspaceId | string | 否 | 多數(shù)據(jù)庫實(shí)例組成的 Workspace 的 Id。此參數(shù)和 DBInstanceId 參數(shù)不能同時(shí)為空,當(dāng)和 DBInstanceId 同時(shí)指定時(shí)以此參數(shù)為準(zhǔn)。 | gp-ws-***** |
返回參數(shù)
示例
正常返回示例
JSON
格式
{
"RequestId": "ABB39CC3-4488-4857-905D-2E4A051D0521",
"Message": "success",
"Status": "success",
"JobId": "231460f8-75dc-405e-a669-0c5204887e91"
}
錯(cuò)誤碼
訪問錯(cuò)誤中心查看更多錯(cuò)誤碼。
變更歷史
變更時(shí)間 | 變更內(nèi)容概要 | 操作 |
---|---|---|
2024-08-04 | OpenAPI 入?yún)l(fā)生變更 | 查看變更詳情 |