Ansicht AI_INDEX_COLUMNS

Die Ansicht INFORMATION_SCHEMA.AI_INDEX_COLUMNS enthält eine Zeile für jede KI-indexierte Spalte in jeder Tabelle 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_INDEX_COLUMNS abfragen, enthalten die Ergebnisse eine Zeile für jede indexierte Spalte in jeder Tabelle eines Datasets.

Die Ansicht INFORMATION_SCHEMA.AI_INDEX_COLUMNS 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_column_name STRING Der Name einer KI-indexierten Spalte. Bei KI-Indizes, die mit AUTO COLUMNS erstellt wurden, werden in dieser Ansicht alle ausgewählten Spalten aufgeführt.

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_INDEX_COLUMNS Dataset-Ebene Dataset-Standort

Ersetzen Sie Folgendes:

  • PROJECT_ID: die ID Ihres Projekts in Cloud de Confiance by S3NS .
  • DATASET_ID: die ID Ihres Datasets.

Beispiel

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            |
+------------+-------------------+-------------------+