Attivare e disattivare gli incorporamenti vettoriali nell'istanza

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

Le istanze di Cloud SQL Enterprise e 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 Compute sul tuo account utente.

Per ulteriori informazioni, consulta Ruoli e autorizzazioni.

Abilita il flag del database per gli embedding vettoriali

Per attivare il supporto degli incorporamenti vettoriali, devi abilitare i flag di 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 per gli incorporamenti vettoriali.

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

    • cloudsql_vector: imposta questo flag su on per abilitare l'archiviazione dell'incorporamento vettoriale e il supporto della ricerca di somiglianze vettoriali. Questo flag è disattivato per impostazione predefinita. Quando configuri il flag, il comando è 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 saperne di più su come configurare i flag di database per MySQL, consulta la pagina Configurare i flag di database.

Disattivare gli incorporamenti vettoriali

Prima di disabilitare gli incorporamenti vettoriali sull'istanza, devi eliminare esplicitamente tutti gli indici vettoriali sull'istanza. Per scoprire come trovare un elenco di indici vettoriali sull'istanza, consulta Monitorare gli indici vettoriali.

La disattivazione del supporto degli incorporamenti vettoriali impedisce la creazione di nuove colonne di incorporamento vettoriale e nuovi indici vettoriali. Inoltre, impedisce l'utilizzo della funzione approx_distance per le ricerche vettoriali. Per disattivare il supporto degli incorporamenti vettoriali, imposta il flag cloudsql_vector su off. Dopo aver configurato questo flag statico, l'istanza viene riavviata automaticamente affinché la modifica alla configurazione venga applicata.

Per disattivare il supporto degli embedding vettoriali, 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'incorporamento vettoriale.

Passaggi successivi