התצוגה CAPACITY_COMMITMENTS

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

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

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

כדי לשלוח שאילתה לתצוגה INFORMATION_SCHEMA.CAPACITY_COMMITMENTS, צריך את ההרשאה 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_COMMITMENTS יש את הסכימה הבאה:

שם העמודה	סוג נתונים	ערך
ddl	STRING	הצהרת ה-DDL ששימשה ליצירת התחייבות הקיבולת הזו.
project_id	STRING	המזהה של פרויקט הניהול.
project_number	INTEGER	מספר פרויקט הניהול.
capacity_commitment_id	STRING	מזהה ייחודי של התחייבות לקיבולת.
commitment_plan	STRING	תוכנית ההתחייבות של מחויבות הקיבולת.
state	STRING	מציינים את מחויבות הקיבולת שבה אתם משתמשים. הערך יכול להיות PENDING או ACTIVE.
slot_count	INTEGER	מספר יחידות הקיבולת שמשויכות להתחייבות לקיבולת.
edition	STRING	המהדורה שמשויכת להזמנה הזו. מידע נוסף על מהדורות זמין במאמר מבוא למהדורות של BigQuery.
is_flat_rate	BOOL	אם ההתחייבות משויכת למודל הישן של קיבולת בתעריף קבוע או למהדורה. אם הערך הוא FALSE, ההתחייבות הנוכחית משויכת למהדורה. אם TRUE, ההתחייבות היא מודל קיבולת עם תעריף קבוע מדור קודם.
renewal_plan	STRING	תוכנית התחייבות חדשה אחרי סיום תוכנית ההתחייבות הנוכחית. אפשר לשנות את תוכנית החידוש של התחייבות בכל שלב עד שהיא פוקעת.

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

היקף ותחביר

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

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

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

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

דוגמה

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

SELECT
  capacity_commitment_id,
  slot_count
FROM
  `region-us`.INFORMATION_SCHEMA.CAPACITY_COMMITMENTS
WHERE
  state = 'ACTIVE';

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

+------------------------+------------+
| capacity_commitment_id | slot_count |
+------------------------+------------+
|    my_commitment_05    |    1000    |
|    my_commitment_06    |    1000    |
|    my_commitment_07    |    1500    |
|    my_commitment_08    |    2000    |
+------------------------+------------+