Habilita y deshabilita la búsqueda de vectores

En esta sección, se describe cómo configurar tu instancia de Cloud SQL para admitir el almacenamiento, la indexación y las consultas de embeddings de vectores.

Las instancias de Cloud SQL edición Enterprise y Cloud SQL edición Enterprise Plus admiten embeddings de vectores. Se admiten todas las versiones de MySQL 8.0.36 y posteriores.

Antes de comenzar

Asegúrate de tener los roles de administrador de Cloud SQL y visualizador de Compute en tu cuenta de usuario.

Para obtener más información, consulta Roles y permisos.

Habilitar la funcionalidad de búsqueda de vectores con la marca de base de datos

Para activar la compatibilidad con el almacenamiento de embeddings de vectores en tu base de datos en Cloud SQL para MySQL 8.4 y versiones anteriores, habilita la marca de base de datos de MySQL cloudsql_vector.

Si usas Cloud SQL para MySQL 9.7 o una versión posterior, habilita la marca de base de datos de MySQL cloudsql_vector para agregar compatibilidad con la creación de índices de vectores y la realización de búsquedas de ANN.

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

Reemplaza lo siguiente:

  • INSTANCE_NAME: Es el nombre de la instancia en la que deseas habilitar la funcionalidad de búsqueda de vectores.

  • FLAGS: Configura la siguiente marca de MySQL en tu instancia:

    • cloudsql_vector: Configura esta marca en on para habilitar la funcionalidad de Vector Search de Cloud SQL. Esta marca está desactivada de forma predeterminada. Cuando configuras la marca, el comando se ve similar al siguiente:

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

      La marca cloudsql_vector es estática. Después de actualizar la instancia con la marca (activándola o desactivándola), tu instancia se reinicia de forma automática para que se apliquen los cambios de configuración.

Si deseas obtener más información sobre cómo configurar marcas de base de datos para MySQL, consulta Configura marcas de base de datos.

Inhabilita los embeddings de vector

Antes de inhabilitar los embeddings de vectores en tu instancia, debes descartar de forma explícita todos los índices de vectores en la instancia. Para obtener información sobre cómo encontrar una lista de índices de vectores en la instancia, consulta Supervisa índices de vectores.

Inhabilitar la compatibilidad con embeddings de vectores te impide crear nuevas columnas de embeddings de vectores si usas MySQL 8.4 o una versión anterior. Si usas MySQL 9.7 o una versión posterior, no podrás crear índices de vectores. También te impide usar la función approx_distance para las búsquedas de vectores. Para desactivar la compatibilidad con los embeddings de vectores, configura la marca cloudsql_vector como off. Después de configurar esta marca estática, la instancia se reinicia de forma automática para que se aplique el cambio de configuración.

Para inhabilitar la compatibilidad con los embeddings de vectores, establece la marca cloudsql_vector en off.

Por ejemplo:

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

Reemplaza INSTANCE_NAME por el nombre de la instancia en la que desactivas la compatibilidad con el embedding de vectores.

¿Qué sigue?