התצוגה INFORMATION_SCHEMA.BI_CAPACITY_CHANGES

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

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

כדי לשלוח שאילתה לתצוגה INFORMATION_SCHEMA.BI_CAPACITY_CHANGES, אתם צריכים את ההרשאה bigquery.bireservations.get לניהול זהויות והרשאות גישה (IAM) להזמנות של BI Engine.

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

סכימה

כשמריצים שאילתה בתצוגה INFORMATION_SCHEMA.BI_CAPACITY_CHANGES, התוצאות שלה כוללות שורה אחת לכל עדכון של הקיבולת של BI Engine, כולל המצב הנוכחי.

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

שם העמודה	סוג נתונים	ערך
`change_timestamp`	`TIMESTAMP`	חותמת זמן של מועד העדכון הנוכחי של הקיבולת של BI Engine.
`project_id`	`STRING`	מזהה הפרויקט שמכיל את הקיבולת של BI Engine.
`project_number`	`INTEGER`	מספר הפרויקט שמכיל את הקיבולת של BI Engine.
`bi_capacity_name`	`STRING`	שם האובייקט. יכולה להיות רק קיבולת אחת לכל פרויקט, ולכן השם תמיד יהיה `default`.
`size`	`INTEGER`	זיכרון ה-RAM של BI Engine בבייטים.
`user_email`	`STRING`	כתובת האימייל של המשתמש או הנושא של שירותי אימות הזהות של כוח העבודה שביצע את השינוי. `google` לשינויים שבוצעו על ידי Google. ‫`NULL` אם כתובת האימייל לא ידועה.
`preferred_tables`	`REPEATED STRING`	קבוצת הטבלאות המועדפות שבהן צריך להשתמש בקיבולת של BI Engine. אם הערך הוא `null`, הקיבולת של BI Engine משמשת לכל השאילתות בפרויקט הנוכחי.

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

תחביר

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

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

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

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

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

-- Returns the history of BI Engine capacity.
SELECT * FROM myproject.`region-us`.INFORMATION_SCHEMA.BI_CAPACITY_CHANGES;

דוגמאות

בדוגמה הבאה מאחזרים את השינויים בקיבולת הנוכחית של BI Engine מהתצוגה INFORMATION_SCHEMA.BI_CAPACITY_CHANGES.

כדי להריץ את השאילתה על פרויקט אחר ולא על הפרויקט שבו השאילתה מורצת, מוסיפים את מזהה הפרויקט לאזור בפורמט הבא: `project_id`.`region_id`.INFORMATION_SCHEMA.BI_CAPACITY_CHANGES.

בדוגמה הבאה מוצגים כל השינויים שמשתמש עם כתובת האימייל email@mycompanymail.com ביצע בקיבולת של BI Engine:

SELECT *
FROM `my-project-id.region-us`.INFORMATION_SCHEMA.BI_CAPACITY_CHANGES
WHERE user_email = "email@mycompanymail.com"

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

  +---------------------+---------------+----------------+------------------+--------------+---------------------+----------------------------------------------------------------------------------------+
  |  change_timestamp   |  project_id   | project_number | bi_capacity_name |     size     |     user_email      |                                               preferred_tables                         |
  +---------------------+---------------+----------------+------------------+--------------+---------------------+----------------------------------------------------------------------------------------+
  | 2022-06-14 02:22:18 | my-project-id |   123456789000 | default          | 268435456000 | email@mycompany.com | ["my-project-id.dataset1.table1","bigquery-public-data.chicago_taxi_trips.taxi_trips"] |
  | 2022-06-08 20:25:51 | my-project-id |   123456789000 | default          | 268435456000 | email@mycompany.com | ["bigquery-public-data.chicago_taxi_trips.taxi_trips"]                                 |
  | 2022-04-01 21:06:49 | my-project-id |   123456789000 | default          | 161061273600 | email@mycompany.com | [""]                                                                                   |
  +---------------------+---------------+----------------+------------------+--------------+---------------------+----------------------------------------------------------------------------------------+

בדוגמה הבאה מוצגים שינויים בקיבולת של BI Engine ב-7 הימים האחרונים:

SELECT
  change_timestamp,
  size,
  user_email,
  preferred_tables
FROM `my-project-id.region-us`.INFORMATION_SCHEMA.BI_CAPACITY_CHANGES
WHERE change_timestamp > TIMESTAMP_SUB(CURRENT_DATE(), INTERVAL 7 DAY)

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

  +---------------------+--------------+----------------------+-------------------+
  |  change_timestamp   |     size     |     user_email       |  preferred_tables |                                                                                    |
  +---------------------+--------------+----------------------+-------------------+
  | 2023-07-08 18:25:09 | 268435456000 | sundar@mycompany.com | [""]              |
  | 2023-07-09 17:47:26 | 161061273600 | pichai@mycompany.com | ["pr.dataset.t1"] |
  +---------------------+--------------+----------------------+-------------------+