Tampilan AI_INDEXES

Tampilan INFORMATION_SCHEMA.AI_INDEXES berisi satu baris untuk setiap indeks AI dalam set data.

Izin yang diperlukan

Untuk melihat metadata indeks AI, Anda memerlukan izin Identity and Access Management (IAM) bigquery.tables.get atau bigquery.tables.list pada tabel dengan indeks. Setiap peran IAM yang telah ditetapkan berikut menyertakan setidaknya salah satu izin ini:

  • roles/bigquery.admin
  • roles/bigquery.dataEditor
  • roles/bigquery.dataOwner
  • roles/bigquery.dataViewer
  • roles/bigquery.metadataViewer
  • roles/bigquery.user

Untuk mengetahui informasi selengkapnya tentang izin BigQuery, lihat Kontrol akses dengan IAM.

Skema

Saat Anda membuat kueri tampilan INFORMATION_SCHEMA.AI_INDEXES, hasil kueri akan berisi satu baris untuk setiap indeks AI dalam set data.

Tampilan INFORMATION_SCHEMA.AI_INDEXES memiliki skema berikut:

Nama kolom Jenis data Nilai
index_catalog STRING Nama project yang berisi set data.
index_schema STRING Nama set data yang berisi indeks AI.
table_name STRING Nama tabel tempat indeks AI dibuat.
index_name STRING Nama indeks AI.
index_status RECORD Status indeks AI, yang berisi index_state (STRING) dan message (STRING).
creation_time TIMESTAMP Waktu pembuatan indeks AI.
last_modification_time TIMESTAMP Terakhir kali konfigurasi indeks AI diubah.
disable_time TIMESTAMP Waktu saat indeks AI dinonaktifkan, atau NULL jika indeks tidak dinonaktifkan.
ddl STRING Pernyataan DDL yang digunakan untuk membuat indeks AI.
coverage_percentage INTEGER Perkiraan persentase baris tabel yang diindeks oleh indeks AI.
unindexed_row_count INTEGER Jumlah baris dalam tabel yang belum diindeks oleh indeks AI.
total_logical_bytes INTEGER Total byte logis yang dapat ditagih yang digunakan oleh indeks AI.

Cakupan dan sintaksis

Kueri terhadap tampilan ini harus memiliki penentu set data. Tabel berikut menjelaskan cakupan region untuk tabel virtual ini:

Nama Tampilan Cakupan resource Cakupan region
[PROJECT_ID.]DATASET_ID.INFORMATION_SCHEMA.AI_INDEXES Level set data Lokasi set data

Ganti kode berikut:

  • PROJECT_ID: ID project Google Cloud Anda.
  • DATASET_ID: ID set data Anda.

Contoh

Kueri berikut menunjukkan cakupan dan ukuran penyimpanan semua indeks AI di 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;

Hasilnya mirip dengan berikut ini:

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