在实例上启用和停用向量嵌入

本部分介绍如何配置 Cloud SQL 实例以支持向量嵌入的存储、索引和查询。

Cloud SQL 企业版和 Cloud SQL 企业 Plus 版实例都支持向量嵌入。支持所有版本的 MySQL 8.0.36 及更高版本。

准备工作

确保您的用户账号具有 Cloud SQL Admin 和 Compute Viewer 角色。

如需了解详情,请参阅角色和权限

为向量嵌入启用数据库标志

如需启用对向量嵌入的支持,您必须启用 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 替换为要停用向量嵌入支持的实例的名称。

后续步骤