התצוגה TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER

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

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

התצוגה INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER לא כוללת טבלאות ללא בייטים לחיוב. סוגי הטבלאות הבאים מוחרגים:

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

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

הנתונים בטבלה הזו לא זמינים בזמן אמת. הנתונים בטבלה יופיעו בתצוגה הזו תוך 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_FOLDER, צריך את ההרשאות הבאות לניהול זהויות והרשאות גישה (IAM) בתיקיית האב של הפרויקט:

bigquery.tables.get
bigquery.tables.list

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

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

במאמר תפקידים והרשאות של IAM ב-BigQuery יש מידע נוסף על הרשאות ב-BigQuery.

סכימה

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

שם העמודה	סוג נתונים	ערך
`usage_date`	`DATE`	תאריך החיוב של הבייטים שמוצגים, לפי אזור הזמן `America/Los_Angeles`
`folder_numbers`	`REPEATED INTEGER`	מזהי המספרים של התיקיות שמכילות את הפרויקט, החל מהתיקייה שמכילה ישירות את הפרויקט, ואחריה התיקייה שמכילה את תיקיית הבן וכן הלאה. לדוגמה, אם `FOLDER_NUMBERS` הוא `[1, 2, 3]`, אז התיקייה `1` מכילה מיד את הפרויקט, התיקייה `2` מכילה את `1` והתיקייה `3` מכילה את `2`. העמודה הזו מאוכלסת רק ב-`TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER`.
`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_FOLDER	התיקייה שמכילה את הפרויקט שצוין	`REGION`

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

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

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

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

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

דוגמה

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

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_FOLDER
  )
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                |
+--------------+------------+--------------+------------+------------------------------+-------------------------------+