啟用及停用向量搜尋

本節說明如何設定 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 替換為要停用向量嵌入支援的執行個體名稱。

後續步驟