Habilitar e inhabilitar las incrustaciones de vectores en una instancia

En esta sección se describe cómo configurar tu instancia de Cloud SQL para que admita el almacenamiento, la indexación y las consultas de inserciones vectoriales.

Tanto las instancias de la edición Enterprise de Cloud SQL como las de la edición Enterprise Plus admiten inserciones vectoriales. Se admiten todas las versiones de MySQL 8.0.36 y posteriores.

Antes de empezar

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

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

Habilitar la marca de la base de datos para las inserciones de vectores

Para activar la compatibilidad con las inserciones vectoriales, debes habilitar las marcas de la base de datos MySQL.

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

Haz los cambios siguientes:

  • INSTANCE_NAME: el nombre de la instancia en la que quieres habilitar la compatibilidad con la inserción de vectores.

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

    • cloudsql_vector: define esta marca en on para habilitar el almacenamiento de inserciones de vectores y la búsqueda de similitudes de vectores. Esta marca está desactivada de forma predeterminada. Cuando configures la marca, el comando tendrá un aspecto 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 reiniciará automáticamente para que los cambios de configuración surtan efecto.

Para obtener más información sobre cómo configurar marcas de bases de datos para MySQL, consulta el artículo Configurar marcas de bases de datos.

Inhabilitar incrustaciones de vectores

Antes de inhabilitar las inserciones vectoriales en tu instancia, debes eliminar explícitamente todos los índices vectoriales de la instancia. Para saber cómo encontrar una lista de índices vectoriales en la instancia, consulta Monitorizar índices vectoriales.

Si inhabilitas la compatibilidad con las inserciones vectoriales, no podrás crear columnas de inserciones vectoriales ni índices vectoriales. También te impide usar la función approx_distance para búsquedas vectoriales. Para desactivar la compatibilidad con las inserciones vectoriales, asigna el valor off a la marca cloudsql_vector. Después de configurar esta marca estática, la instancia se reiniciará automáticamente para que el cambio de configuración surta efecto.

Para inhabilitar la compatibilidad con las incrustaciones de vectores, asigna el valor off a la marca cloudsql_vector.

Por ejemplo:

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

Sustituye INSTANCE_NAME por el nombre de la instancia en la que vas a desactivar la compatibilidad con la inserción de vectores.

Siguientes pasos