Habilita y deshabilita la búsqueda de vectores

MySQL   |  PostgreSQL   |  SQL Server

Nota: Para usar la versión de disponibilidad general (GA) de la búsqueda de vectores de MySQL, la versión de mantenimiento de tu instancia debe ser la versión MYSQL_8_0_36.R20241208.01_00 o posterior. Para obtener información sobre cómo actualizar tu instancia a una versión más reciente que admita los embeddings de vector de DG, consulta Realiza el mantenimiento de autoservicio.

Para obtener información sobre la sintaxis y el comportamiento de los embeddings de vector para la versión preliminar de esta función, consulta Trabaja con embeddings de vector (versión preliminar).

Si ya usas la versión de DG de la búsqueda de vectores en Cloud SQL para MySQL 8.0 o 8.4 y deseas actualizar a Cloud SQL para MySQL 9.7, entonces revisa las diferencias en la compatibilidad con vectores de MySQL en Cloud SQL para MySQL 9.7 antes de realizar la actualización de versión principal a Cloud SQL para MySQL 9.7.

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 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 versiones posteriores, habilita la cloudsql_vector marca de base de datos de MySQL 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: Establece esta marca en on para habilitar la funcionalidad de búsqueda de vectores de Cloud SQL. Esta marca está desactivada de forma predeterminada. Cuando configures la marca, tu comando se verá 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 quitar de forma explícita todos los índices de vectores de 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 los embeddings de vectores, no podrás crear columnas de embeddings de vectores nuevas si usas MySQL 8.4 o versiones anteriores. Si usas MySQL 9.7 o versiones posteriores, no podrás crear índices de vectores. Tampoco podrás 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, 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?

• Lee la descripción general sobre la búsqueda de vectores en Cloud SQL.
• Obtén información para generar embeddings de vectores.
• Obtén información para crear índices de vectores.
• Obtén información para realizar búsquedas en embeddings de vectores.