Attivare e disattivare la ricerca vettoriale

MySQL   |  PostgreSQL   |  SQL Server

Nota: per utilizzare la versione di disponibilità generale (GA) della ricerca vettoriale di MySQL, la versione di manutenzione dell'istanza deve essere la versione MYSQL_8_0_36.R20241208.01_00 o successive. Per informazioni su come eseguire l'upgrade dell'istanza a una versione successiva che supporta i vector embedding di GA, consulta Esegui la manutenzione self-service.

Per informazioni sulla sintassi e sul comportamento dei vector embedding per la versione di anteprima di questa funzionalità, consulta Utilizzare i vector embedding (anteprima).

Se stai già utilizzando la versione di GA della ricerca vettoriale in Cloud SQL per MySQL 8.0 o 8.4 e vuoi eseguire l'upgrade a Cloud SQL per MySQL 9.7, allora esamina le differenze nel supporto vettoriale di MySQL in Cloud SQL per MySQL 9.7 prima di eseguire l'upgrade della versione principale a Cloud SQL per MySQL 9.7.

Questa sezione descrive come configurare l'istanza Cloud SQL per supportare l'archiviazione, l'indicizzazione e l'esecuzione di query sui vector embedding.

Le istanze di Cloud SQL Enterprise e Cloud SQL Enterprise Plus supportano i vector embedding. Sono supportate tutte le versioni di MySQL 8.0.36+.

Prima di iniziare

Assicurati di avere i ruoli Amministratore Cloud SQL e Visualizzatore Compute sul tuo account utente.

Per saperne di più, consulta Ruoli e autorizzazioni.

Abilitare la funzionalità di ricerca vettoriale utilizzando il flag di database

Per attivare il supporto per l'archiviazione dei vector embedding nel database in Cloud SQL per MySQL 8.4 e versioni precedenti, abilita il flag di database MySQL cloudsql_vector.

Se utilizzi Cloud SQL per MySQL 9.7 o versioni successive, abilita il cloudsql_vector flag di database MySQL per aggiungere il supporto per la creazione di indici vettoriali e per l'esecuzione della ricerca ANN

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

Sostituisci quanto segue:

• INSTANCE_NAME: il nome dell'istanza in cui vuoi abilitare la funzionalità di ricerca vettoriale.

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

  • cloudsql_vector: imposta questo flag su on per abilitare la funzionalità di ricerca vettoriale di Cloud SQL. 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 viene riavviata automaticamente affinché le modifiche alla configurazione vengano applicate.

Per saperne di più su come configurare i flag di database per MySQL, consulta Configurare i flag di database.

Disabilitare i vector embedding

Prima di disabilitare i vector embedding 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 disabilitazione del supporto per i vector embedding impedisce la creazione di nuove colonne di vector embedding se utilizzi MySQL 8.4 o versioni precedenti. Se utilizzi MySQL 9.7 o versioni successive, non puoi creare indici vettoriali. Inoltre, non puoi utilizzare la funzione approx_distance per le ricerche vettoriali. Per disattivare il supporto per i vector embedding, 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 disabilitare il supporto per i vector embedding, 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 stai disattivando il supporto per i vector embedding.

Passaggi successivi

• Leggi la panoramica sulla ricerca vettoriale su Cloud SQL.
• Scopri come generare vector embedding.
• Scopri come creare indici vettoriali.
• Scopri come eseguire ricerche sui vector embedding.