啟用及停用向量搜尋

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

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

事前準備

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

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

使用資料庫旗標啟用向量搜尋功能

如要在 MySQL 適用的 Cloud SQL 8.4 和更早版本中，啟用資料庫的向量嵌入儲存支援功能，請啟用 cloudsql_vector MySQL 資料庫旗標。

如果您使用 MySQL 適用的 Cloud SQL 9.7 以上版本，請啟用 cloudsql_vector MySQL 資料庫旗標，新增建立向量索引和執行 ANN 搜尋的支援功能

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

更改下列內容：

  • INSTANCE_NAME：要啟用向量搜尋功能的執行個體名稱。

  • FLAGS：在執行個體上設定下列 MySQL 旗標：

    • cloudsql_vector：將這個旗標設為 on，即可啟用 Cloud SQL 向量搜尋功能。這項標記預設為關閉。設定標記後，指令會類似下列內容：

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

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

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

停用向量嵌入

如要為執行個體停用向量嵌入，必須先明確捨棄執行個體上的所有向量索引。如要瞭解如何尋找執行個體上的向量索引清單，請參閱「監控向量索引」。

如果您使用 MySQL 8.4 或更早版本，停用向量嵌入支援功能後，就無法建立新的向量嵌入資料欄。如果您使用 MySQL 9.7 以上版本，就無法建立向量索引。您也無法使用 approx_distance 函式進行向量搜尋。 如要關閉向量嵌入支援功能，請將 cloudsql_vector 標記設為 off。 設定這個靜態標記後，執行個體會自動重新啟動，設定變更才會生效。

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

例如：

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

將 INSTANCE_NAME 替換為要停用向量嵌入支援的執行個體名稱。

後續步驟