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.admin
  • roles/bigquery.dataEditor
  • roles/bigquery.dataOwner
  • roles/bigquery.dataViewer
  • roles/bigquery.metadataViewer
  • roles/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                 |
+------------+-------------------+---------------------+---------------------+---------------------------+-----------------------+