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.adminroles/bigquery.dataEditorroles/bigquery.dataOwnerroles/bigquery.dataViewerroles/bigquery.metadataViewerroles/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 |
+------------+-------------------+---------------------+---------------------+---------------------------+-----------------------+