תצוגת VECTOR_INDEX_COLUMNS

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

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

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

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

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

סכימה

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

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

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

כדי לשמור על יציבות, מומלץ לציין במפורש את העמודות בשאילתות של סכימת המידע, במקום להשתמש בתו כל כללי (SELECT *). ציון מפורש של העמודות מונע את השבירה של השאילתות אם הסכימה הבסיסית משתנה.

היקף ותחביר

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

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

מחליפים את מה שכתוב בשדות הבאים:
  • אופציונלי: PROJECT_ID: מזהה הפרויקט ב- Google Cloud . אם לא מציינים פרויקט, המערכת משתמשת בפרויקט שמוגדר כברירת מחדל.
  • ‫DATASET_ID: המזהה של מערך הנתונים. מידע נוסף מופיע במאמר בנושא מאפיין מסנן של מערך נתונים.

דוגמה

-- Returns metadata for vector indexes in a single dataset.
SELECT * FROM myDataset.INFORMATION_SCHEMA.VECTOR_INDEX_COLUMNS;

דוגמאות

השאילתה הבאה שולפת מידע על עמודות עם אינדקסים של וקטורים:

SELECT table_name, index_name, index_column_name, index_field_path
FROM my_project.dataset.INFORMATION_SCHEMA.VECTOR_INDEX_COLUMNS;

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

+------------+------------+-------------------+------------------+
| table_name | index_name | index_column_name | index_field_path |
+------------+------------+-------------------+------------------+
| table1     | indexa     | embeddings        | embeddings       |
| table2     | indexb     | vectors           | vectors          |
| table3     | indexc     | vectors           | vectors          |
+------------+------------+-------------------+------------------+