Visualizzazione VECTOR_INDEXES

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 all'indirizzo [e-mail].

La vista INFORMATION_SCHEMA.VECTOR_INDEXES contiene una riga per ogni indice vettoriale in 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 ulteriori informazioni sulle autorizzazioni BigQuery, consulta Controllo dell'accesso con IAM.

Schema

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

La vista INFORMATION_SCHEMA.VECTOR_INDEXES 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.
table_name	STRING	Il nome della tabella in cui viene creato l'indice.
index_name	STRING	Il nome dell'indice vettoriale.
index_status	STRING	Lo stato dell'indice: ACTIVE, PENDING DISABLEMENT, TEMPORARILY DISABLED o PERMANENTLY DISABLED. ACTIVE significa che l'indice è utilizzabile o in fase di creazione. Consulta il coverage_percentage per verificare l'avanzamento della creazione dell'indice. PENDING DISABLEMENT significa che la dimensione totale delle tabelle indicizzate supera il limite della tua organizzazione; l'indice è in coda per l'eliminazione. In questo stato, l'indice può essere utilizzato nelle query di ricerca vettoriale e ti viene addebitata l'archiviazione dell'indice vettoriale. TEMPORARILY DISABLED significa che la dimensione totale delle tabelle indicizzate supera il limite della tua organizzazione o che la tabella indicizzata è inferiore a 10 MB. In questo stato, l'indice non viene utilizzato nelle query di ricerca vettoriale e non ti viene addebitato alcun costo per l'archiviazione dell'indice vettoriale. PERMANENTLY DISABLED indica che esiste una modifica allo schema incompatibile nella tabella indicizzata.
creation_time	TIMESTAMP	Ora in cui è stato creato l'indice.
last_modification_time	TIMESTAMP	L'ultima volta che la configurazione dell'indice è stata modificata. Ad esempio, l'eliminazione di una colonna indicizzata.
last_refresh_time	TIMESTAMP	L'ultima volta che i dati della tabella sono stati indicizzati. Un valore NULL significa che l'indice non è ancora disponibile.
disable_time	TIMESTAMP	L'ora in cui lo stato dell'indice è stato impostato su DISABLED. Il valore è NULL se lo stato dell'indice non è DISABLED.
disable_reason	STRING	Il motivo per cui l'indice è stato disabilitato. NULL se lo stato dell'indice non è DISABLED.
DDL	STRING	L'istruzione DDL (Data Definition Language) utilizzata per creare l'indice.
coverage_percentage	INTEGER	La percentuale approssimativa di dati della tabella che sono stati indicizzati. 0% indica che l'indice non è utilizzabile in una query VECTOR_SEARCH, anche se alcuni dati sono già stati indicizzati.
unindexed_row_count	INTEGER	Il numero di righe nella tabella che non sono state indicizzate.
total_logical_bytes	INTEGER	Il numero di byte logici fatturabili per l'indice.
total_storage_bytes	INTEGER	Il numero di byte di archiviazione fatturabili per l'indice.

Ambito e sintassi

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

Visualizza nome	Ambito risorsa	Ambito della regione
[PROJECT_ID.]DATASET_ID.INFORMATION_SCHEMA.VECTOR_INDEXES	Livello del 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 maggiori informazioni, consulta Qualificatore del set di dati.

Nota: devi utilizzare un qualificatore regione per eseguire query su INFORMATION_SCHEMA viste. 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_INDEXES;

Esempio

L'esempio seguente mostra tutti gli indici vettoriali attivi nelle tabelle nel set di dati my_dataset, situato nel progetto my_project. Include i nomi, le istruzioni DDL utilizzate per crearle e la percentuale di copertura. Se una tabella di base indicizzata è inferiore a 10 MB, il suo indice non viene compilato e in questo caso il valore di coverage_percentage è 0.

SELECT table_name, index_name, ddl, coverage_percentage
FROM my_project.my_dataset.INFORMATION_SCHEMA.VECTOR_INDEXES
WHERE index_status = 'ACTIVE';

Il risultato è simile al seguente:

+-------------+-------------+-----------------------------------------------------------------------------------------------+---------------------+
| table_name  | index_name  | ddl                                                                                           | coverage_percentage |
+-------------+-------------+-----------------------------------------------------------------------------------------------+---------------------+
| small_table | myindex1    | CREATE VECTOR INDEX `myindex1` ON `my_project.my_dataset.small_table`(embeddings)             | 100                 |
|             |             | OPTIONS (distance_type = 'EUCLIDEAN', index_type = 'IVF', ivf_options = '{"numLists": 3}')    |                     |
+-------------+-------------+-----------------------------------------------------------------------------------------------+---------------------+
| large_table | myindex2    | CREATE VECTOR INDEX `myindex2` ON `my_project.my_dataset.large_table`(vectors)                |  42                 |
|             |             | OPTIONS (distance_type = 'EUCLIDEAN', index_type = 'IVF', ivf_options = '{"numLists": 12}')   |                     |
+-------------+-------------+-----------------------------------------------------------------------------------------------+---------------------+