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:

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 Typ STRING sind, 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 INDEX ausführen, kann die Basistabelle bei On-Demand-Projekten maximal 1.000.000 Zeilen enthalten. Wenn das Projekt, das die Tabelle enthält, eine BACKGROUND-Reservierungszuweisung hat, kann die Basistabelle bis zu 100.000.000 Zeilen enthalten.
  • AUTO COLUMNS wählt Spalten aus, wenn die CREATE 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:

  1. Rufen Sie in der Google Cloud Console BigQuery Studio auf.

    Zu BigQuery Studio

  2. 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 von AUTO COLUMNS ausgewä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.

Nächste Schritte