全部產品
Search

搜尋本產品

    AnalyticDB：CreateVectorIndex - 建立向量索引

    文件中心

    AnalyticDB：CreateVectorIndex - 建立向量索引

    更新時間：Apr 02, 2026

    建立向量集的索引。

    調試

    您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

    調試

    授權資訊

    下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

    • 操作：是指具體的許可權點。

    • 存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。

    • 資源類型：是指操作中支援授權的資源類型。具體說明如下：

      • 對於必選的資源類型，用前面加 * 表示。

      • 對於不支援資源級授權的操作，用全部資源表示。

    • 條件關鍵字：是指雲產品自身定義的條件關鍵字。

    • 關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    gpdb:CreateVectorIndex

    create

    *Collection

    acs:gpdb:{#regionId}:{#accountId}:collection/{#DBInstanceId}

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    DBInstanceId

    string

    是

    執行個體 ID。

    說明

    您可以調用 DescribeDBInstances 介面查看目標地區下所有的 AnalyticDB PostgreSQL 執行個體的詳情，包括執行個體 ID。

    gp-xxxxxxxxx
    Collection

    string

    是

    集合名。

    說明

    您可以 ListCollections 介面查看列表。

    document
    Dimension

    integer

    否

    向量維度。

    說明

    • 稠密向量必傳該參數。

    • 此值需和上傳向量 UpsertCollectionData 介面的向量資料 Rows. Vector 長度一致。

    1024
    ManagerAccount

    string

    是

    具有 rds_superuser 許可權的管理賬戶名稱。

    說明

    您可以通過控制台->帳號管理來建立帳號，或者通過 CreateAccount 介面建立。

    testaccount
    ManagerAccountPassword

    string

    是

    管理賬戶密碼。

    testpassword
    Metrics

    string

    否

    向量構建索引時的方法。取值說明：

    • l2：歐氏距離。

    • ip：點積（內積）距離。

    • cosine：餘弦相似性。

    說明

    稀疏向量只支援 ip。

    cosine
    Namespace

    string

    否

    命名空間，預設為 public。

    說明

    您可以通過 ListNamespaces 介面查看列表。

    mynamespace
    RegionId

    string

    是

    執行個體所在的地區 ID。

    cn-hangzhou
    PqEnable

    integer

    否

    索引是否開啟 PQ（Product quantization）演算法加速，資料量大於 50w 時建議開啟。取值說明：

    • 0：關閉。

    • 1：開啟（預設）。

    1
    HnswM

    integer

    否

    HNSW 演算法中的最大鄰居數。介面會根據向量維度自動化佈建此值，一般不需要手動設定。

    說明

    取值範圍：

    • AnalyticDB PostgreSQL 6.0 版執行個體：1～1000。

    • AnalyticDB PostgreSQL 7.0 版執行個體：2～100，預設值 16。

    說明

    建議根據向量維度來設定：

    • 小於等於 384：16

    • 大於 384 小於等於 768：32

    • 大於 768 小於等於 1024：64

    • 大於 1024：128

    64
    HnswEfConstruction

    integer

    否

    HNSW 演算法構建索引時的候選集大小。取值範圍：4～1000，預設值 64。

    說明

    僅 AnalyticDB PostgreSQL 7.0 版執行個體需要傳該值，且取值需要>= 2*HNSW_M。

    128
    ExternalStorage

    integer

    否

    是否使用 mmap 構建 HNSW 索引，預設為 0。如果資料不需要刪除，且對上傳資料的速度效能有要求時，建議設定為 1。

    取值說明：

    • 0：預設採用段頁式儲存構建索引，這種模式可以使用 PostgreSQL 中的 shared_buffer 做緩衝，支援刪除和更新等操作。

    • 1：該索引會採用 mmap 構建索引，該模式不支援刪除更新等操作。

    重要 僅 6.0 版本支援參數 ExternalStorage。7.0 版本暫不支援。

    0
    Type

    string

    否

    向量類型。取值說明：

    • Dense（預設值）：稠密向量。

    • Sparse：稀疏向量。

    Dense
    Algorithm

    string

    否

    Nlist

    integer

    否

    RabitqBits

    integer

    否

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    RequestId

    string

    請求 ID。

    ABB39CC3-4488-4857-905D-2E4A051D0521
    Message

    string

    介面返回詳細資料。

    Successful
    Status

    string

    API 執行狀態，取值說明：

    • success：執行成功。

    • fail：執行失敗。

    success

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "ABB39CC3-4488-4857-905D-2E4A051D0521",
  "Message": "Successful",
  "Status": "success"
}

    錯誤碼

    訪問錯誤中心查看更多錯誤碼。

    變更歷史

    更多資訊，參考變更詳情。