在執行個體上啟用及停用向量嵌入

本節說明如何設定 Cloud SQL 執行個體,以支援向量嵌入的儲存、索引和查詢。

Cloud SQL Enterprise 和 Cloud SQL Enterprise Plus 版本的執行個體都支援向量嵌入項目。支援所有 MySQL 8.0.36 以上版本。

事前準備

請確認您的使用者帳戶具有 Cloud SQL 管理員和雲端運算檢視者角色。

詳情請參閱「角色和權限」。

為向量嵌入功能啟用資料庫標記

如要啟用向量嵌入功能,您必須啟用 MySQL 資料庫旗標。

gcloud sql instances patch INSTANCE_NAME \
 --database-flags=FLAGS

更改下列內容:

  • INSTANCE_NAME:您要啟用向量嵌入支援的執行個體名稱。
  • FLAGS:在執行個體上設定下列 MySQL 標記:

    • cloudsql_vector:將這個標記設為 on,即可啟用向量嵌入儲存空間和向量相似度搜尋支援功能。這個標記預設為關閉。設定標記後,指令會類似以下內容:

      gcloud sql instances patch my-instance \
      --database-flags=cloudsql_vector=on
      

      cloudsql_vector 是靜態標記。使用標記更新執行個體 (開啟或關閉) 後,執行個體會自動重新啟動,以便設定變更生效。

如要進一步瞭解如何設定 MySQL 的資料庫標記,請參閱「設定資料庫標記」。

停用向量嵌入

在執行個體上停用向量嵌入功能前,您必須明確捨棄執行個體上的所有向量索引。如要瞭解如何在執行個體上查看向量索引清單,請參閱「監控向量索引」。

停用向量嵌入支援功能後,您就無法建立新的向量嵌入資料欄和向量索引。也無法使用 approx_distance 函式進行向量搜尋。如要關閉向量嵌入支援功能,請將 cloudsql_vector 標記設為 off。設定此靜態標記後,執行個體會自動重新啟動,讓設定變更生效。

如要停用向量嵌入支援功能,請將 cloudsql_vector 標記設為 off

例如:

gcloud sql instances patch INSTANCE_NAME \
 --database-flags=cloudsql_vector=off

INSTANCE_NAME 替換為您要關閉向量嵌入支援的執行個體名稱。

後續步驟