Attivare e disattivare gli incorporamenti vettoriali nell'istanza

Questa sezione descrive come configurare l'istanza Cloud SQL per supportare lo stoccaggio, l'indicizzazione e le query degli incorporamenti vettoriali.

Sia le istanze Cloud SQL Enterprise sia quelle Cloud SQL Enterprise Plus supportano gli incorporamenti vettoriali. Sono supportate tutte le versioni di MySQL 8.0.36 e successive.

Prima di iniziare

Assicurati di disporre dei ruoli Amministratore Cloud SQL e Visualizzatore di Compute sul tuo account utente.

Per ulteriori informazioni, consulta Ruoli e autorizzazioni.

Attivare il flag del database per gli embedding vettoriali

Per attivare il supporto degli embedding vettoriali, devi attivare i flag del database MySQL.

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

Sostituisci quanto segue:

  • INSTANCE_NAME: il nome dell'istanza su cui vuoi attivare il supporto dell'embedding vettoriale.

  • FLAGS: configura il seguente flag MySQL nell'istanza:

    • cloudsql_vector: imposta questo flag su on per attivare lo stoccaggio degli incorporamenti vettoriali e il supporto della ricerca di similarità vettoriale. Questo flag è disattivato per impostazione predefinita. Quando configuri il flag, il comando sarà simile al seguente:

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

      Il flag cloudsql_vector è statico. Dopo aver aggiornato l'istanza con il flag (attivandolo o disattivandolo), l'istanza si riavvia automaticamente affinché le modifiche alla configurazione vengano applicate.

Per ulteriori informazioni su come configurare i flag di database per MySQL, consulta Configurare i flag di database.

Disattivare gli incorporamenti vettoriali

Prima di disattivare gli embedding di vettori nell'istanza, devi eliminare esplicitamente tutti gli indici di vettori nell'istanza. Per scoprire come trovare un elenco di indici vettoriali nell'istanza, consulta Monitorare gli indici vettoriali.

La disattivazione del supporto degli embedding di vettori ti impedisce di creare nuovi indici e colonne di embedding di vettori. Inoltre, impedisce di utilizzare la funzioneapprox_distance per le ricerche di vettori. Per disattivare il supporto per gli embedding vettoriali, imposta il flag cloudsql_vector su off. Dopo aver configurato questo flag statico, l'istanza si riavvia automaticamente affinché la modifica della configurazione possa essere applicata.

Per disattivare il supporto degli embedding di vettori, imposta il flag cloudsql_vector su off.

Ad esempio:

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

Sostituisci INSTANCE_NAME con il nome dell'istanza su cui disattivi il supporto dell'embedding di vettori.

Passaggi successivi