KI-Indexe verwenden
Mit der Funktion AI.SEARCH können Sie Ihre Daten abfragen, während BigQuery automatisch die Spaltenauswahl, die Indexoptimierung und die laufende Wartung übernimmt.
In diesem Dokument wird beschrieben, wie Sie KI-Indexe erstellen, überwachen und löschen und wie Sie Ihre indexierten Daten abfragen.
Rollen und Berechtigungen
Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für das Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zur Verwendung von KI-Indizes benötigen:
-
KI-Index erstellen oder löschen:
BigQuery-Dateninhaber (
roles/bigquery.dataOwner) -
Tabelle abfragen:
- BigQuery Data Viewer (
roles/bigquery.dataViewer) - BigQuery Job User (
roles/bigquery.jobUser)
- BigQuery Data Viewer (
-
KI-Indexmetadaten ansehen:
BigQuery-Datenbetrachter (
roles/bigquery.dataViewer)
Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.
Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.
KI-Index erstellen
Sie können einen KI-Index für eine Standard-BigQuery-Tabelle mit der Datendefinitionssprache (DDL)-Anweisung CREATE AI INDEX erstellen. Sie können die zu indexierenden Spalten angeben oder BigQuery mit der Option AUTO COLUMNS automatisch Kandidatenspalten auswählen lassen.
Einschränkungen beim Erstellen von KI-Indexen
Beim Erstellen eines KI-Index gelten die folgenden Einschränkungen:
- Es werden nur nicht wiederholte STRING-Spalten der obersten Ebene unterstützt.
ARRAY<STRING>,STRUCT,JSON,ObjectRef, verschachtelte Felder, Spalten, die nicht vom TypSTRINGsind, und Pseudospalten werden nicht unterstützt. - Sie können bis zu 50 Spalten in einem einzelnen KI-Index indexieren.
- Sie können einen KI-Index nur für eine BigQuery-Standardtabelle erstellen. Ansichten, materialisierte Ansichten, externe Tabellen, BigLake-Tabellen, Apache Iceberg-Tabellen und Tabellen-Snapshots werden nicht unterstützt.
- Sie können keine KI-Indizes in Datasets erstellen, die regionenübergreifende Replikate haben.
- Wenn Sie
CREATE AI INDEXausführen, kann die Basistabelle bei On-Demand-Projekten maximal 1.000.000 Zeilen enthalten. Wenn das Projekt, das die Tabelle enthält, eineBACKGROUND-Reservierungszuweisung hat, kann die Basistabelle bis zu 100.000.000 Zeilen enthalten. AUTO COLUMNSwählt Spalten aus, wenn dieCREATE AI INDEX-Anweisung ausgeführt wird. Wenn Sie der Tabelle später Spalten hinzufügen, werden diese nicht automatisch indexiert. Wenn Sie neue Spalten hinzufügen möchten, löschen Sie den KI-Index und erstellen Sie ihn neu.- Jede Tabelle unterstützt höchstens einen KI-Index. Eine Tabelle mit einem KI-Index darf nicht auch einen Vektorindex oder eine automatisch generierte Einbettungsspalte enthalten.
Eine vollständige Liste der Einschränkungen finden Sie unter Einschränkungen für KI-Indexe.
KI-Index mit AUTO COLUMNS erstellen
Wenn Sie einen KI-Index mit AUTO COLUMNS erstellen, scannt BigQuery automatisch das Tabellenschema und wählt bis zu 50 geeignete Spalten aus.
Verwenden Sie die DDL-Anweisung CREATE AI INDEX, um einen KI-Index mit AUTO COLUMNS zu erstellen:
Rufen Sie in der Cloud de Confiance Console BigQuery Studio auf.
Führen Sie im Abfrageeditor folgende SQL-Anweisung aus:
CREATE AI INDEX INDEX_NAME ON DATASET_NAME.TABLE_NAME(AUTO COLUMNS);
Ersetzen Sie Folgendes:
INDEX_NAME: der Name des KI-Index, den Sie erstellen. Da der Index immer im selben Projekt und Dataset wie die Basistabelle erstellt wird, müssen Sie Projekt und Dataset nicht im Indexnamen angeben. Der Indexname muss unter allen Indexen in der Tabelle eindeutig sein.DATASET_NAME: der Name des Datasets, das die Tabelle enthält.TABLE_NAME: der Name der Standardtabelle, die indexiert werden soll.
Im folgenden Beispiel wird ein KI-Index mit AUTO COLUMNS für mydataset.products erstellt:
CREATE AI INDEX products_ai_index ON mydataset.products(AUTO COLUMNS);
KI-Index für bestimmte Spalten erstellen
Sie können einen KI-Index für eine einzelne Spalte oder eine bestimmte Teilmenge von Spalten erstellen. Beispielsweise, wenn Ihre Tabelle mehr als 50 zulässige Spalten enthält oder wenn Sie sensible oder stark verrauschte Spalten wie opake IDs, UUIDs, Hashes oder Rohlogs ausschließen möchten. Wenn Sie mehrere Spalten angeben, platzieren Sie die informativsten Spalten, z. B. eine Titel- oder Namensspalte, am Anfang der Spaltenliste.
Im folgenden Beispiel wird ein KI-Index nur für die Spalten name und description von mydataset.products erstellt:
CREATE AI INDEX products_ai_index ON mydataset.products(name, description);
Im folgenden Beispiel wird ein KI-Index nur für die Spalte description von mydataset.products erstellt:
CREATE AI INDEX products_ai_index ON mydataset.products(description);
Tabelle mit einem KI-Index durchsuchen
Sie können eine Tabelle mit einem KI-Index mithilfe der Funktion AI.SEARCH abfragen.
Wenn eine Tabelle einen KI-Index hat, sind nur zwei Argumente erforderlich: base_table oder base_table_query und query_value.
In allen indexierten Spalten suchen
Wenn Sie alle Spalten durchsuchen möchten, die vom KI-Index abgedeckt werden, lassen Sie das Argument column_to_search weg und übergeben Sie die Basistabelle und den Abfragestring.
Im folgenden Beispiel werden alle Spalten in mydataset.products durchsucht, die vom KI-Index abgedeckt werden:
SELECT base.id, base.name, base.description, distance FROM AI.SEARCH( TABLE mydataset.products, 'shoes that keep your feet dry in the rain', top_k => 5) ORDER BY distance;
Status von KI-Indizes überwachen
Sie können den Status, die Abdeckung und die indexierten Spalten Ihrer KI-Indizes überwachen, indem Sie die folgenden INFORMATION_SCHEMA-Ansichten abfragen:
INFORMATION_SCHEMA.AI_INDEXES: Enthält Metadaten zu jedem KI-Index in einem Dataset.INFORMATION_SCHEMA.AI_INDEX_COLUMNS: Listet die Spalten auf, die von jedem KI-Index in einem Dataset abgedeckt werden. So können Sie prüfen, welche Spalten bei der Verwendung vonAUTO COLUMNSausgewählt wurden.INFORMATION_SCHEMA.JOBS: Enthält Informationen zu Hintergrundjobs, einschließlich der Hintergrundjobs, die zum Erstellen und Verwalten von KI-Indexen verwendet werden.
Beispiel für einen KI-Index
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 |
+------------+-------------------+---------------------+---------------------+---------------------------+-----------------------+
Beispiel für KI-Indexspalten
Die folgende Abfrage listet die indexierten Spalten für KI-Indexe in my_project.my_dataset auf:
SELECT table_name, index_name, index_column_name FROM my_project.my_dataset.INFORMATION_SCHEMA.AI_INDEX_COLUMNS;
Das Ergebnis sieht etwa so aus:
+------------+-------------------+-------------------+
| table_name | index_name | index_column_name |
+------------+-------------------+-------------------+
| products | products_ai_index | name |
| products | products_ai_index | description |
| products | products_ai_index | category |
| products | products_ai_index | review |
+------------+-------------------+-------------------+
Beispiel für das Erfassen von Kosten für Hintergrundjobs
Wenn Sie die Werte total_slot_ms und total_bytes_billed für Hintergrund-KI-Index-Datenverarbeitungsjobs in einer Tabelle verfolgen möchten, fragen Sie die Ansicht INFORMATION_SCHEMA.JOBS nach Jobs mit dem job_id-Präfix gc_ ab:
SELECT job_id, creation_time, reservation_id, total_slot_ms, total_bytes_processed, total_bytes_billed FROM `region-REGION`.INFORMATION_SCHEMA.JOBS j WHERE EXISTS ( SELECT 1 FROM UNNEST(j.referenced_tables) t WHERE j.project_id = 'PROJECT_ID' AND t.dataset_id = 'DATASET_ID' AND t.table_id = 'TABLE' ) AND STARTS_WITH(job_id, 'gc_') ORDER BY j.creation_time DESC;
Ersetzen Sie Folgendes:
REGION: die Dataset-Region, die Ihre Tabelle enthält, z. B. us.PROJECT_ID: Die ID des Projekts, das Ihre Tabelle enthält.DATASET_ID: der Name des Datasets, das die Tabelle enthält.TABLE: der Name der Tabelle, die den KI-Index enthält.
KI-Index löschen
Wenn Sie eine indexierte Tabelle löschen, wird auch der zugehörige KI-Index gelöscht. Verwenden Sie die DDL-Anweisung DROP AI INDEX, um einen KI-Index zu löschen, ohne die Tabelle zu löschen:
DROP AI INDEX IF EXISTS INDEX_NAME ON DATASET_NAME.TABLE_NAME;
Ersetzen Sie Folgendes:
INDEX_NAME: der Name des KI-Index, den Sie löschen.DATASET_NAME: der Name des Datasets, das die Tabelle enthält.TABLE_NAME: der Name der Tabelle, die den KI-Index enthält.