התצוגה RESERVATION_CHANGES

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

הערה: השמות של התצוגות המפורטות INFORMATION_SCHEMA.RESERVATION_CHANGES ו-INFORMATION_SCHEMA.RESERVATION_CHANGES_BY_PROJECT הם שמות נרדפים ואפשר להשתמש בהם לסירוגין.

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

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

• אדמין של משאבי BigQuery ‏ (roles/bigquery.resourceAdmin)
• עורך משאבי BigQuery‏ (roles/bigquery.resourceEditor)
• BigQuery Resource Viewer (צפייה במשאבי BigQuery) (roles/bigquery.resourceViewer)
• משתמש BigQuery‏ (roles/bigquery.user)
• אדמין של BigQuery‏ (roles/bigquery.admin)

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

סכימה

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

שם העמודה	סוג נתונים	ערך
change_timestamp	TIMESTAMP	השעה שבה התרחש השינוי.
project_id	STRING	המזהה של פרויקט הניהול.
project_number	INTEGER	מספר פרויקט הניהול.
reservation_name	STRING	השם של ההזמנה שסופק על ידי המשתמש.
ignore_idle_slots	BOOL	אם הערך הוא false, כל שאילתה שמשתמשת בהזמנה הזו יכולה להשתמש במשבצות פנויות לא פעילות שלא נעשה בהן שימוש מתוך התחייבויות אחרות לקיבולת.
action	STRING	סוג האירוע שהתרחש בהזמנה. יכול להיות CREATE, UPDATE או DELETE.
slot_capacity	INTEGER	הערך הבסיסי של ההזמנה.
user_email	STRING	כתובת האימייל של המשתמש או הנושא של שירותי אימות הזהות של כוח העבודה שביצע את השינוי. google לשינויים שבוצעו על ידי Google. ‫NULL אם כתובת האימייל לא ידועה.
target_job_concurrency	INTEGER	מספר היעד של השאילתות שאפשר להריץ בו-זמנית, שמוגבל על ידי המשאבים הזמינים. אם הערך הוא אפס, הוא מחושב באופן אוטומטי על סמך המשאבים הזמינים.
autoscale	STRUCT	מידע על הקיבולת של ההזמנה שניתנת לשינוי אוטומטי. השדות כוללים את הפרטים הבאים: ‫current_slots: מספר המשבצות שנוספו להזמנה באמצעות התאמה אוטומטית לעומס. הערה: אחרי שהמשתמשים מקטינים את max_slots, יכול לעבור זמן עד שהשינוי יתעדכן, לכן יכול להיות ש-current_slots יישאר בערך המקורי ויהיה גדול מ-max_slots למשך תקופה קצרה (פחות מדקה). ‫max_slots: המספר המקסימלי של משבצות שאפשר להוסיף להזמנה באמצעות התאמה אוטומטית לעומס.
edition	STRING	המהדורה שמשויכת להזמנה הזו. מידע נוסף על מהדורות זמין במאמר מבוא למהדורות של BigQuery.
primary_location	STRING	המיקום הנוכחי של הרפליקה הראשית של ההזמנה. השדה הזה מוגדר רק להזמנות שנעשות באמצעות התכונה לניהול תוכנית התאוששות מאסון (DR).
secondary_location	STRING	המיקום הנוכחי של הרפליקה המשנית של ההזמנה. השדה הזה מוגדר רק להזמנות שנעשות באמצעות התכונה לניהול תוכנית התאוששות מאסון (DR).
original_primary_location	STRING	המיקום שבו נוצרה ההזמנה במקור.
labels	RECORD	מערך של תוויות שמשויכות להזמנה.
reservation_group_path	STRING	מבנה הקבוצה ההיררכי שאליו משויכת ההזמנה. לדוגמה, אם מבנה הקבוצה כולל קבוצת הורה וקבוצת צאצא, השדה reservation_group_path מכיל רשימה כמו: [parent group, child group]. השדה הזה נמצא בגרסת טרום-השקה.
max_slots	INTEGER	המספר המקסימלי של משבצות שההזמנה הזו יכולה להשתמש בהן, כולל משבצות בסיסיות (slot_capacity), משבצות בלי פעילות (אם ignore_idle_slots הוא FALSE) ומשבצות של התאמה אוטומטית לעומס. המשתמשים מציינים את השדה הזה כדי להשתמש בתכונה לחיזוי הזמנות.
scaling_mode	STRING	מצב ההרחבה של ההזמנה, שקובע איך ההזמנה מתרחבת מבסיס ל-max_slots. המשתמשים מציינים את השדה הזה כדי להשתמש בתכונה לחיזוי הזמנות.

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

שמירת נתונים

התצוגה הזו כוללת הזמנות נוכחיות והזמנות שנמחקו, שנשמרות למשך 41 ימים לכל היותר ואז מוסרות מהתצוגה.

היקף ותחביר

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

שם התצוגה	היקף המשאבים	היקף האזור
[PROJECT_ID].`region-REGION`.INFORMATION_SCHEMA.RESERVATION_CHANGES[_BY_PROJECT]	ברמת הפרויקט	REGION

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

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

דוגמה

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

SELECT
  *
FROM
  reservation-admin-project.`region-us`.
  INFORMATION_SCHEMA.RESERVATION_CHANGES
WHERE
  reservation_name = "my-reservation"
ORDER BY
  change_timestamp DESC;