התצוגה TABLE_STORAGE_USAGE_TIMELINE_BY_ORGANIZATION

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

  • טבלאות רגילות
  • תצוגות מהותיות
  • שיבוטים של טבלאות שיש בהם דלתא בבייטים מהטבלת הבסיס
  • תמונות מצב של טבלאות שיש בהן דלתא בבייטים מטבלת הבסיס

טבלאות שלא כוללות בייטים לחיוב לא נכללות בתצוגה INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_ORGANIZATION. הם כוללים את סוגי הטבלאות הבאים:

  • טבלאות חיצוניות
  • טבלאות אנונימיות
  • טבלאות ריקות
  • שיבוטים של טבלאות שלא כוללים דלתא בבייטים מהטבלה הבסיסית
  • תמונות מצב של טבלאות שלא כוללות דלתא בבייטים מטבלת הבסיס

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

הנתונים בטבלה הזו לא זמינים בזמן אמת. יעברו בערך 72 שעות עד שהנתונים מהטבלה יופיעו בתצוגה הזו.

הנתון של נפח אחסון נדרש מוחזר בשניות MiB. לדוגמה, אם בפרויקט נעשה שימוש ב-1,000,000 בייטים פיזיים למשך 86,400 שניות (24 שעות), סך השימוש הפיזי הוא 86,400,000,000 בייט-שניות, שמומר ל-82,397 מיביבייט-שניות, כמו שמוצג בדוגמה הבאה:

86,400,000,000 / 1,024 / 1,024 = 82,397

זהו הערך שיוחזר על ידי BILLABLE_TOTAL_PHYSICAL_USAGEהעמודה.

מידע נוסף זמין במאמר פרטי תמחור של אחסון.

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

כדי לשלוח שאילתה לתצוגה INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_ORGANIZATION, צריכות להיות לכם הרשאות ניהול זהויות והרשאות גישה (IAM) הבאות בארגון:

  • bigquery.tables.get
  • bigquery.tables.list

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

  • roles/bigquery.dataViewer
  • roles/bigquery.dataEditor
  • roles/bigquery.metadataViewer
  • roles/bigquery.admin

תצוגת הסכימה הזו זמינה רק למשתמשים עם Google Cloud ארגונים מוגדרים.

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

סכימה

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

שם העמודה סוג נתונים ערך
usage_date DATE תאריך החיוב של הבייטים שמוצגים, לפי אזור הזמן America/Los_Angeles
project_id STRING מזהה הפרויקט שמכיל את מערך הנתונים
table_catalog STRING מזהה הפרויקט שמכיל את מערך הנתונים
project_number INT64 מספר הפרויקט שמכיל את מערך הנתונים
table_schema STRING שם מערך הנתונים שמכיל את הטבלה או את התצוגה החומרית, שנקרא גם datasetId
table_name STRING השם של הטבלה או התצוגה החומרית, שנקראת גם tableId
billable_total_logical_usage INT64

השימוש הלוגי הכולל, ב-MiB לשנייה.

הפונקציה מחזירה 0 אם מערך הנתונים משתמש במודל החיוב של אחסון פיזי.
billable_active_logical_usage INT64

השימוש הלוגי מלפני פחות מ-90 יום, ב-MiB לשנייה.

הפונקציה מחזירה 0 אם מערך הנתונים משתמש במודל החיוב של אחסון פיזי.
billable_long_term_logical_usage INT64

השימוש הלוגי שגילו יותר מ-90 יום, ב-MiB שנייה.

הפונקציה מחזירה 0 אם מערך הנתונים משתמש במודל החיוב של אחסון פיזי.
billable_total_physical_usage INT64

סך השימוש ב-MiB לשנייה. זה כולל בייטים פיזיים שמשמשים לגיבוי ולשחזור בזמן.

הפונקציה מחזירה 0 אם מערך הנתונים משתמש במודל החיוב של אחסון לוגי.
billable_active_physical_usage INT64

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

הפונקציה מחזירה 0 אם מערך הנתונים משתמש במודל החיוב של אחסון לוגי.
billable_long_term_physical_usage INT64

השימוש הפיזי שבוצע לפני יותר מ-90 ימים, ביחידות של MiB לשנייה.

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

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

היקף ותחביר

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

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

בדוגמה הבאה מוצגות פקודות להחזרת פרטי אחסון של טבלאות בפרויקט ספציפי בארגון:

SELECT * FROM myProject.`region-REGION`.INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_ORGANIZATION;

בדוגמה הבאה מוצגות פקודות להחזרת פרטי אחסון לפי פרויקט לטבלאות בארגון:

SELECT * FROM `region-REGION`.INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_ORGANIZATION;

דוגמה

בדוגמה הבאה מוצג השימוש בכל הטבלאות בארגון בתאריך השימוש האחרון.

SELECT
  usage_date,
  project_id,
  table_schema,
  table_name,
  billable_total_logical_usage,
  billable_total_physical_usage
FROM
  (
    SELECT
      *,
      ROW_NUMBER()
        OVER (PARTITION BY project_id, table_schema, table_name ORDER BY usage_date DESC) AS rank
    FROM
      `region-REGION`.INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_ORGANIZATION
  )
WHERE rank = 1;

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

+--------------+------------+--------------+------------+------------------------------+-------------------------------+
| usage_date   | project_id | table_schema | table_name | billable_total_logical_usage | billable_total_physical_usage |
+--------------+------------+--------------+------------+------------------------------+-------------------------------+
|  2023-04-03  | project1   | dataset_A    | table_x    | 734893409201                 |           0                   |
+--------------+------------+--------------+------------+------------------------------+-------------------------------+
|  2023-04-03  | project1   | dataset_A    | table_z    | 110070445455                 |           0                   |
+--------------+------------+--------------+------------+------------------------------+-------------------------------+
|  2023-04-03  | project1   | dataset_B    | table_y    |            0                 | 52500873256                   |
+--------------+------------+--------------+------------+------------------------------+-------------------------------+
|  2023-04-03  | project1   | dataset_B    | table_t    |            0                 | 32513713981                   |
+--------------+------------+--------------+------------+------------------------------+-------------------------------+
|  2023-04-03  | project2   | dataset_C    | table_m    |   8894535352                 |           0                   |
+--------------+------------+--------------+------------+------------------------------+-------------------------------+
|  2023-04-03  | project2   | dataset_C    | table_n    |   4183337201                 |           0                   |
+--------------+------------+--------------+------------+------------------------------+-------------------------------+