התצוגה INFORMATION_SCHEMA.BI_CAPACITIES

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

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

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

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

סכימה

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

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

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

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

היקף ותחביר

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

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

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

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

דוגמה

-- Returns current state of BI Engine capacity.
SELECT * FROM myproject.`region-us`.INFORMATION_SCHEMA.BI_CAPACITIES;

דוגמאות

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

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

בדוגמה הבאה מוצג המצב הנוכחי של BI Engine בפרויקט עם המזהה my-project-id:

SELECT *
FROM `my-project-id.region-us`.INFORMATION_SCHEMA.BI_CAPACITIES

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

  +---------------+----------------+------------------+--------------+-----------------------------------------------------------------------------------------------+
  |  project_id   | project_number | bi_capacity_name |     size     |                                               preferred_tables                                |
  +---------------+----------------+------------------+--------------+-----------------------------------------------------------------------------------------------+
  | my-project-id |   123456789000 | default          | 268435456000 | "my-company-project-id.dataset1.table1","bigquery-public-data.chicago_taxi_trips.taxi_trips"] |
  +---------------+----------------+------------------+--------------+-----------------------------------------------------------------------------------------------+
  

בדוגמה הבאה מוחזר גודל הקיבולת של BI Engine בגיגה-בייט עבור פרויקט השאילתה:

SELECT
  project_id,
  size/1024.0/1024.0/1024.0 AS size_gb
FROM `region-us`.INFORMATION_SCHEMA.BI_CAPACITIES

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

  +---------------+---------+
  |  project_id   | size_gb |
  +---------------+---------+
  | my-project-id |  250.0  |
  +---------------+---------+