Visualizzazione VECTOR_INDEX_OPTIONS

Anteprima

Questo prodotto o funzionalità è soggetto ai "Termini delle Offerte pre-GA" nella sezione Termini generali del servizio dei Termini specifici del servizio. I prodotti e le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per saperne di più, consulta le descrizioni della fase di lancio.

Per fornire feedback o richiedere assistenza per questa funzionalità, invia un'email a [e-mail].

La vista INFORMATION_SCHEMA.VECTOR_INDEX_OPTIONS contiene una riga per ogni colonna indicizzata su vettori su ogni tabella di un set di dati.

Autorizzazioni obbligatorie

Per visualizzare i metadati dell'indice vettoriale, devi disporre dell'autorizzazione bigquery.tables.get o bigquery.tables.list Identity and Access Management (IAM) nella tabella con l'indice. Ciascuno dei seguenti ruoli IAM predefiniti include almeno una di queste autorizzazioni:

• roles/bigquery.admin
• roles/bigquery.dataEditor
• roles/bigquery.dataOwner
• roles/bigquery.dataViewer
• roles/bigquery.metadataViewer
• roles/bigquery.user

Per maggiori informazioni sulle autorizzazioni BigQuery, consulta Controllo dell'accesso con IAM.

Schema

Quando esegui una query sulla vista INFORMATION_SCHEMA.VECTOR_INDEX_OPTIONS, i risultati della query contengono una riga per ogni indice su ogni tabella in un set di dati.

La vista INFORMATION_SCHEMA.VECTOR_INDEX_OPTIONS ha il seguente schema:

Nome colonna	Tipo di dati	Valore
index_catalog	STRING	Il nome del progetto che contiene il set di dati.
index_schema	STRING	Il nome del set di dati che contiene l'indice vettoriale.
table_name	STRING	Il nome della tabella in cui viene creato l'indice vettoriale.
index_name	STRING	Il nome dell'indice vettoriale.
option_name	STRING	Il nome dell'opzione utilizzata nell'istruzione Data Definition Language (DDL) per creare l'indice vettoriale.
option_type	STRING	Il tipo di dati dell'opzione.
option_value	STRING	Il valore dell'opzione.

Ambito e sintassi

Le query in questa vista devono avere un qualificatore del set di dati. La tabella seguente spiega l'ambito della regione per questa visualizzazione:

Visualizza nome	Ambito risorsa	Ambito regione
[PROJECT_ID.]DATASET_ID.INFORMATION_SCHEMA.VECTOR_INDEX_OPTIONS	Livello set di dati	Posizione del set di dati

Sostituisci quanto segue:

• (Facoltativo) PROJECT_ID: l'ID del tuo progetto Google Cloud. Se non specificato, viene utilizzato il progetto predefinito.
• DATASET_ID: l'ID del set di dati. Per ulteriori informazioni, consulta la sezione Qualificatore del set di dati.

Nota: devi utilizzare un qualificatore regione per eseguire query sulle viste INFORMATION_SCHEMA. La località dell'esecuzione della query deve corrispondere alla regione della vista INFORMATION_SCHEMA.

Esempio

-- Returns metadata for vector indexes in a single dataset.
SELECT * FROM myDataset.INFORMATION_SCHEMA.VECTOR_INDEX_OPTIONS;

Esempi

La seguente query estrae informazioni sulle opzioni degli indici vettoriali:

SELECT table_name, index_name, option_name, option_type, option_value
FROM my_project.dataset.INFORMATION_SCHEMA.VECTOR_INDEX_OPTIONS;

Il risultato è simile al seguente:

+------------+------------+------------------+------------------+--------------------+
| table_name | index_name | option_name      | option_type      | option_value       |
+------------+------------+------------------+------------------+--------------------+
| table1     | indexa     | distance_type    | STRING           | EUCLIDEAN          |
| table1     | indexa     | index_type       | STRING           | IVF                |
| table2     | indexb     | ivf_options      | STRING           | {"num_lists": 100} |
| table2     | indexb     | index_type       | STRING           | IVF                |
+------------+------------+------------------+------------------+--------------------+