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

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

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

事前準備

請確認使用者帳戶具備 Cloud SQL 管理員和 Compute 檢視者角色。

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

啟用向量嵌入的資料庫標記

如要啟用向量嵌入支援功能，必須啟用 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 替換為要停用向量嵌入支援的執行個體名稱。

後續步驟