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

本部分介绍如何配置 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 替换为要停用向量嵌入支持的实例的名称。

后续步骤