התצוגה TABLE_SNAPSHOTS

בתצוגה INFORMATION_SCHEMA.TABLE_SNAPSHOTS מופיעים מטא-נתונים על תמונות המצב של הטבלה. מידע נוסף זמין במאמר מבוא לצילומי מצב של טבלאות.

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

כדי לשלוח שאילתה לתצוגה INFORMATION_SCHEMA.TABLE_SNAPSHOTS, אתם צריכים את ההרשאה bigquery.tables.list לניהול זהויות והרשאות גישה (IAM) למערך הנתונים. התפקיד המוגדר מראש roles/bigquery.metadataViewer כולל את ההרשאה הנדרשת.

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

סכימה

כשמריצים שאילתה בטבלה INFORMATION_SCHEMA.TABLE_SNAPSHOTS, התוצאות כוללות שורה אחת לכל תמונת מצב של טבלה בקבוצת הנתונים או באזור שצוינו.

הסכימה של הטבלה INFORMATION_SCHEMA.TABLE_SNAPSHOTS היא כפי שמוצג בהמשך. הטבלה הרגילה שממנה צולם צילום המסך של הטבלה נקראת טבלת הבסיס.

שם העמודה	סוג נתונים	ערך
table_catalog	STRING	שם הפרויקט שמכיל את תמונת המצב של הטבלה
table_schema	STRING	שם קבוצת הנתונים שמכילה את תמונת המצב של הטבלה
table_name	STRING	שם ה-Snapshot של הטבלה
base_table_catalog	STRING	שם הפרויקט שמכיל את טבלת הבסיס
base_table_schema	STRING	השם של מערך הנתונים שמכיל את טבלת הבסיס
base_table_name	STRING	השם של טבלת הבסיס
snapshot_time	TIMESTAMP	השעה שבה נוצר צילום המסך של הטבלה

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

היקף ותחביר

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

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

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

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

דוגמה

-- Returns metadata for the table snapshots in the specified dataset.
SELECT * FROM myDataset.INFORMATION_SCHEMA.TABLE_SNAPSHOTS;

-- Returns metadata for the table snapshots in the specified region.
SELECT * FROM `region-us`.INFORMATION_SCHEMA.TABLE_SNAPSHOTS;

דוגמה

השאילתה הבאה מאחזרת מטא-נתונים של תמונות מצב של טבלאות במערך הנתונים mydataset. בדוגמה הזו, מוצגת תמונת המצב של הטבלה myproject.mydataset.mytablesnapshot, שנלקחה מהטבלה הבסיסית myproject.mydataset.mytable ב-14 במאי 2021 בשעה 12:00 UTC.

SELECT *
FROM
  `myproject`.mydataset.INFORMATION_SCHEMA.TABLE_SNAPSHOTS;

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

+----------------+---------------+-----------------+--------------------+-------------------+-----------------+-----------------------------+
| table_catalog  | table_schema  | table_name      | base_table_catalog | base_table_schema | base_table_name | snapshot_time               |
+----------------+---------------+-----------------+----------------------------------------------------------------------------------------+
| myproject      | mydataset     | mytablesnapshot | myProject          | mydataset         | mytable         | 2021-05-14 12:00:00.000 UTC |
+----------------+---------------+-----------------+--------------------+-------------------+-----------------+-----------------------------+