התצוגה AI_INDEXES

התצוגה INFORMATION_SCHEMA.AI_INDEXES מכילה שורה אחת לכל אינדקס AI בקבוצת נתונים.

ההרשאות הנדרשות

כדי לראות את המטא-נתונים של אינדקס ה-AI, צריך את ההרשאה bigquery.tables.get או bigquery.tables.list לניהול זהויות והרשאות גישה (IAM) בטבלה עם האינדקס. כל אחד מהתפקידים הבאים שמוגדרים מראש ב-IAM כולל לפחות אחת מההרשאות האלה:

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

במאמר בקרת גישה באמצעות IAM יש מידע נוסף על ההרשאות ב-BigQuery.

סכימה

כששולחים שאילתה לתצוגה INFORMATION_SCHEMA.AI_INDEXES, תוצאות השאילתה מכילות שורה אחת לכל אינדקס AI במערך נתונים.

הסכימה של התצוגה INFORMATION_SCHEMA.AI_INDEXES היא:

שם העמודה סוג נתונים ערך
index_catalog STRING שם הפרויקט שמכיל את מערך הנתונים.
index_schema STRING שם מערך הנתונים שמכיל את אינדקס ה-AI.
table_name STRING שם הטבלה שבה נוצר אינדקס ה-AI.
index_name STRING שם אינדקס ה-AI.
index_status RECORD הסטטוס של אינדקס ה-AI, שמכיל את index_state (STRING) ואת message (STRING).
creation_time TIMESTAMP השעה שבה נוצר אינדקס ה-AI.
last_modification_time TIMESTAMP הפעם האחרונה שבה בוצע שינוי בהגדרות של אינדקס ה-AI.
disable_time TIMESTAMP השעה שבה אינדקס ה-AI הושבת, או NULL אם האינדקס לא מושבת.
ddl STRING הצהרת ה-DDL שמשמשת ליצירת אינדקס ה-AI.
coverage_percentage INTEGER האחוז המשוער של שורות הטבלה שנוספו לאינדקס על ידי אינדקס ה-AI.
unindexed_row_count INTEGER מספר השורות בטבלה שעדיין לא נוספו לאינדקס ה-AI.
total_logical_bytes INTEGER הבייטים הלוגיים הכוללים לחיוב שבהם משתמש אינדקס ה-AI.

היקף ותחביר

שאילתות בתצוגה הזו חייבות לכלול מזהה של מערך נתונים. בטבלה הבאה מוסבר היקף האזור בתצוגה הזו:

שם התצוגה המפורטת היקף המשאבים היקף האזור
[PROJECT_ID.]DATASET_ID.INFORMATION_SCHEMA.AI_INDEXES רמת מערך הנתונים המיקום של קבוצת הנתונים

מחליפים את מה שכתוב בשדות הבאים:

  • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
  • ‫DATASET_ID: המזהה של מערך הנתונים.

דוגמה

השאילתה הבאה מציגה את הכיסוי ואת גודל האחסון של כל אינדקסי ה-AI ב-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;

התוצאה אמורה להיראות כך:

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