התצוגה AI_INDEX_COLUMNS

התצוגה INFORMATION_SCHEMA.AI_INDEX_COLUMNS מכילה שורה אחת לכל עמודה שנוסף לה אינדקס על ידי 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_INDEX_COLUMNS, תוצאות השאילתה מכילות שורה אחת לכל עמודה שנוסף לה אינדקס בכל טבלה במערך הנתונים.

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

שם העמודה סוג נתונים ערך
index_catalog STRING שם הפרויקט שמכיל את מערך הנתונים.
index_schema STRING שם מערך הנתונים שמכיל את אינדקס ה-AI.
table_name STRING שם הטבלה שבה נוצר אינדקס ה-AI.
index_name STRING שם אינדקס ה-AI.
index_column_name STRING השם של עמודה שנוספה לאינדקס על ידי AI. באינדקסים של AI שנוצרו באמצעות AUTO COLUMNS, בתצוגה הזו מופיעה כל עמודה שנבחרה.

היקף ותחביר

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

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

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

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

דוגמה

השאילתה הבאה מציגה את העמודות שנוספו לאינדקסים של AI ב-my_project.my_dataset:

SELECT
  table_name,
  index_name,
  index_column_name
FROM
  my_project.my_dataset.INFORMATION_SCHEMA.AI_INDEX_COLUMNS;

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

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