Attivare e disattivare gli incorporamenti vettoriali nell'istanza

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

Sia le istanze della versione Cloud SQL Enterprise sia quelle della versione 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 di vettori, 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 le rappresentazioni vettoriali nell'istanza, devi eliminare esplicitamente tutti gli indici vettoriali 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 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 viene riavviata automaticamente affinché la modifica della configurazione venga 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