התצוגה CAPACITY_COMMITMENT_CHANGES

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

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

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

  • roles/bigquery.resourceAdmin
  • roles/bigquery.resourceEditor
  • roles/bigquery.resourceViewer
  • roles/bigquery.user
  • roles/bigquery.admin

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

סכימה

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

שם העמודה סוג נתונים ערך
change_timestamp TIMESTAMP השעה שבה התרחש השינוי.
project_id STRING המזהה של פרויקט הניהול.
project_number INTEGER מספר פרויקט הניהול.
capacity_commitment_id STRING מזהה ייחודי של התחייבות לקיבולת.
commitment_plan STRING תוכנית ההתחייבות של מחויבות הקיבולת.
state STRING מציינים את מחויבות הקיבולת שבה אתם משתמשים. הערך יכול להיות PENDING או ACTIVE.
slot_count INTEGER מספר יחידות הקיבולת שמשויכות להתחייבות לקיבולת.
action STRING סוג האירוע שהתרחש עם ההתחייבות לקיבולת. יכול להיות CREATE, UPDATE או DELETE.
user_email STRING כתובת האימייל של המשתמש או הנושא של שירותי אימות הזהות של כוח העבודה שביצע את השינוי. google לשינויים שבוצעו על ידי Google. ‫NULL אם כתובת האימייל לא ידועה.
commitment_start_time TIMESTAMP תאריך ההתחלה של תקופת ההתחייבות הנוכחית. ההגדרה רלוונטית רק לACTIVE התחייבויות לקיבולת, אחרת הערך הוא NULL.
commitment_end_time TIMESTAMP סוף תקופת ההתחייבות הנוכחית. ההגדרה רלוונטית רק לACTIVE התחייבויות לקיבולת, אחרת הערך הוא NULL.
failure_status RECORD בתוכנית התחייבות FAILED, הערך הוא הסיבה לכישלון. אחרת, הערך הוא NULL. ‫RECORD מורכב מ-code ומ-message.
renewal_plan STRING המינוי שאליו תומר ההתחייבות הזו לקיבולת אחרי commitment_end_time. אחרי שינוי התוכנית, תקופת ההתחייבות מתארכת בהתאם לתוכנית ההתחייבות. ההנחה רלוונטית רק להתחייבויות לשימוש ב-ANNUAL וב-TRIAL, אחרת ההנחה היא NULL.
edition STRING המהדורה שמשויכת להזמנה הזו. מידע נוסף על מהדורות זמין במאמר מבוא למהדורות של BigQuery.
is_flat_rate BOOL אם ההתחייבות משויכת למודל הישן של קיבולת בתעריף קבוע או למהדורה. אם הערך הוא FALSE, ההתחייבות הנוכחית משויכת למהדורה. אם TRUE, ההתחייבות היא מודל קיבולת עם תעריף קבוע מדור קודם.

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

שמירת נתונים

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

היקף ותחביר

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

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

דוגמה

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

SELECT
  user_email,
  change_timestamp
FROM
  `region-us`.INFORMATION_SCHEMA.CAPACITY_COMMITMENT_CHANGES
WHERE
  change_timestamp BETWEEN '2021-09-30' AND '2021-10-01'
ORDER BY
  change_timestamp DESC
LIMIT 1;

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

+--------------------------------+-------------------------+
|           user_email           |     change_timestamp    |
+--------------------------------+-------------------------+
|     222larabrown@gmail.com     | 2021-09-30 09:30:00 UTC |
+--------------------------------+-------------------------+