Ansicht AI_INDEXES
Die Ansicht INFORMATION_SCHEMA.AI_INDEXES enthält eine Zeile für jeden KI-Index in einem Dataset.
Erforderliche Berechtigungen
Zum Aufrufen der Metadaten des KI-Index benötigen Sie die IAM-Berechtigung (Identity and Access Management) bigquery.tables.get oder bigquery.tables.list für die Tabelle mit dem Index. Jede der folgenden vordefinierten IAM-Rollen enthält mindestens eine der folgenden Berechtigungen:
roles/bigquery.adminroles/bigquery.dataEditorroles/bigquery.dataOwnerroles/bigquery.dataViewerroles/bigquery.metadataViewerroles/bigquery.user
Weitere Informationen zu BigQuery-Berechtigungen finden Sie unter Zugriffssteuerung mit IAM.
Schema
Wenn Sie die Ansicht INFORMATION_SCHEMA.AI_INDEXES abfragen, wird im Ergebnis jeder KI-Index in einem Dataset in einer eigenen Zeile dargestellt.
Die Ansicht INFORMATION_SCHEMA.AI_INDEXES hat das folgende Schema:
| Spaltenname | Datentyp | Wert |
|---|---|---|
index_catalog |
STRING |
Der Name des Projekts, zu dem das Dataset gehört. |
index_schema |
STRING |
Der Name des Datasets, das den KI-Index enthält. |
table_name |
STRING |
Der Name der Tabelle, für die der KI-Index erstellt wird. |
index_name |
STRING |
Der Name des KI-Index. |
index_status |
RECORD |
Der Status des KI-Index, der index_state (STRING) und message (STRING) enthält. |
creation_time |
TIMESTAMP |
Der Zeitpunkt, zu dem der KI-Index erstellt wurde. |
last_modification_time |
TIMESTAMP |
Der Zeitpunkt der letzten Änderung der KI-Indexkonfiguration. |
disable_time |
TIMESTAMP |
Der Zeitpunkt, zu dem der KI-Index deaktiviert wurde, oder NULL, wenn der Index nicht deaktiviert ist. |
ddl |
STRING |
Die DDL-Anweisung, die zum Erstellen des KI-Index verwendet wird. |
coverage_percentage |
INTEGER |
Der ungefähre Prozentsatz der Tabellenzeilen, die vom KI-Index indexiert werden. |
unindexed_row_count |
INTEGER |
Die Anzahl der Zeilen in der Tabelle, die noch nicht vom KI-Index indexiert wurden. |
total_logical_bytes |
INTEGER |
Die Gesamtzahl der abrechenbaren logischen Byte, die vom KI-Index verwendet werden. |
Bereich und Syntax
Für Abfragen dieser Ansicht muss ein Dataset-Qualifizierer verwendet werden. In der folgenden Tabelle wird der Regionsbereich für diese Ansicht erläutert:
| Ansichtsname | Ressourcenbereich | Regionsbereich |
|---|---|---|
[PROJECT_ID.]DATASET_ID.INFORMATION_SCHEMA.AI_INDEXES |
Dataset-Ebene | Dataset-Standort |
Ersetzen Sie Folgendes:
PROJECT_ID: die ID Ihres Projekts in Google Cloud .DATASET_ID: die ID Ihres Datasets.
Beispiel
Die folgende Abfrage zeigt die Abdeckung und Speichergröße aller KI-Indizes in my_project.my_dataset:
SELECT table_name, index_name, creation_time, coverage_percentage, unindexed_row_count, total_logical_bytes FROM my_project.my_dataset.INFORMATION_SCHEMA.AI_INDEXES;
Das Ergebnis sieht etwa so aus:
+------------+-------------------+---------------------+---------------------+---------------------------+-----------------------+
| table_name | index_name | creation_time | coverage_percentage | unindexed_row_count | total_logical_bytes |
+------------+-------------------+---------------------+---------------------+---------------------------+-----------------------+
| products | products_ai_index | 2026-10-01 18:02:11 | 100 | 0 | 25344 |
+------------+-------------------+---------------------+---------------------+---------------------------+-----------------------+