התצוגה AI_INDEXES
התצוגה INFORMATION_SCHEMA.AI_INDEXES מכילה שורה אחת לכל אינדקס AI בקבוצת נתונים.
ההרשאות הנדרשות
כדי לראות את המטא-נתונים של אינדקס ה-AI, צריך את ההרשאה bigquery.tables.get או bigquery.tables.list לניהול זהויות והרשאות גישה (IAM) בטבלה עם האינדקס. כל אחד מהתפקידים הבאים שמוגדרים מראש ב-IAM כולל לפחות אחת מההרשאות האלה:
roles/bigquery.adminroles/bigquery.dataEditorroles/bigquery.dataOwnerroles/bigquery.dataViewerroles/bigquery.metadataViewerroles/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: מזהה הפרויקט ב- Cloud de Confiance by S3NS . -
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 |
+------------+-------------------+---------------------+---------------------+---------------------------+-----------------------+