Habilita e inhabilita las incorporaciones de vectores en tu instancia

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 Enterprise y Cloud SQL 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 las funciones de administrador de Cloud SQL y visualizador de Compute en tu cuenta de usuario.

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

Habilita la marca de base de datos para las incorporaciones de vectores

Para activar la compatibilidad con los embeddings de vectores, debes habilitar las marcas de la base de datos de MySQL.

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 compatibilidad con las incorporaciones de vectores.

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

    • cloudsql_vector: Configura esta marca en on para habilitar el almacenamiento de embeddings de vectores y la compatibilidad de búsqueda de similitud de vectores. Esta marca está desactivada de forma predeterminada. Cuando configuras la marca, tu 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), la instancia se reinicia automáticamente 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.

Cómo inhabilitar los embeddings de vectores

Antes de inhabilitar las incorporaciones de vectores en tu instancia, debes dejar caer explícitamente 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 los índices de vectores.

Si inhabilitas la compatibilidad con embeddings de vectores, no podrás crear nuevos índices de vectores ni columnas de embeddings de vectores. También te impide usar la función approx_distance para 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, configura la marca cloudsql_vector como 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?