TABLE_STORAGE_BY_ORGANIZATION 檢視畫面
INFORMATION_SCHEMA.TABLE_STORAGE_BY_ORGANIZATION
檢視畫面會為與目前專案相關聯的整個機構,提供每個資料表或具體化檢視表的一列資料。
這個表格中的資料不會即時更新,可能會有幾秒到幾分鐘的延遲。如果儲存空間變更是由於分割區或資料表到期,或是修改資料集時間旅行視窗所致,INFORMATION_SCHEMA.TABLE_STORAGE
檢視畫面最多可能需要一天才會反映變更。如果資料集包含超過 1,000 個資料表,且您刪除了該資料集,則在刪除資料集的時空旅行時間範圍結束前,這個檢視畫面不會反映變更。
透過表格儲存空間檢視畫面,您可以輕鬆觀察目前的儲存空間用量,並查看儲存空間是使用邏輯未壓縮位元組、實體壓縮位元組還是時空旅行位元組。這項資訊可協助您規劃未來的成長,並瞭解表格的更新模式。
*_BYTES
欄中包含的資料
表格儲存空間檢視畫面中的 *_BYTES
欄位包含儲存空間位元組用量資訊。系統會根據具體化檢視區塊的儲存空間用量,以及下列類型的資料表,判斷這項資訊:
- 透過「建立及使用資料表」一文所述的任何方法建立的永久資料表。
- 在工作階段中建立的臨時資料表。這些資料表會放入名稱類似「_c018003e063d09570001ef33ae401fad6ab92a6a」的資料集中。
- 在多重陳述式查詢 (「指令碼」) 中建立的臨時資料表。這些資料表會放入名稱類似「__script72280c173c88442c3a7200183a50eeeaa4073719」的資料集中。
儲存在查詢結果快取中的資料不會產生費用,因此不會計入 *_BYTES
資料欄值。
複製和快照會顯示 *_BYTES
資料欄值,就像是完整的表格,而不是顯示與基本表格所用儲存空間的差異,因此會高估。帳單會正確計算儲存空間用量差異。如要進一步瞭解複製和快照儲存及計費的差異位元組,請參閱TABLE_STORAGE_USAGE_TIMELINE
檢視畫面。
預測儲存空間費用
如要預測資料集的每月儲存空間費用,您可以使用這個檢視畫面中的 logical
或 physical *_BYTES
欄,具體取決於資料集使用的資料集儲存空間計費模式。請注意,這只是粗略的預測,實際帳單金額是根據 BigQuery 儲存空間帳單基礎架構的用量計算,並顯示在 Cloud Billing 中。
如果資料集使用邏輯帳單模型,您可以按照下列方式預估每月儲存空間費用:
((ACTIVE_LOGICAL_BYTES
值 / POW
(1024, 3)) * 使用中的邏輯位元組價格) +
((LONG_TERM_LOGICAL_BYTES
值 / POW
(1024, 3)) * 長期邏輯位元組價格)
資料表的 ACTIVE_LOGICAL_BYTES
值會反映該資料表目前使用的有效位元組。
如果資料集採用實體計費模式,您可以按照下列方式預測儲存空間費用:
((ACTIVE_PHYSICAL_BYTES + FAIL_SAFE_PHYSICAL_BYTES
值 / POW
(1024, 3)) * 作用中實體位元組價格) +
((LONG_TERM_PHYSICAL_BYTES
值 / POW
(1024, 3)) * 長期實體位元組價格)
資料表的 ACTIVE_PHYSICAL_BYTES
值反映該資料表目前使用的有效位元組,以及該資料表用於時間旅行的位元組。
如要查看資料表本身的有效位元組,請從 ACTIVE_PHYSICAL_BYTES
值減去 TIME_TRAVEL_PHYSICAL_BYTES
值。
詳情請參閱「儲存空間定價」。
所需權限
如要查詢 INFORMATION_SCHEMA.TABLE_STORAGE_BY_ORGANIZATION
檢視畫面,您必須具備機構的下列身分與存取權管理 (IAM) 權限:
bigquery.tables.get
bigquery.tables.list
下列每個預先定義的 IAM 角色都包含上述權限:
roles/bigquery.admin
roles/bigquery.dataViewer
roles/bigquery.dataEditor
roles/bigquery.metadataViewer
只有已定義Trusted Cloud by S3NS機構的使用者才能使用這個結構定義檢視畫面。
如要進一步瞭解 BigQuery 權限,請參閱「使用身分與存取權管理功能控管存取權」一文。
結構定義
INFORMATION_SCHEMA.TABLE_STORAGE_BY_ORGANIZATION
檢視表具有下列結構定義:
資料欄名稱 | 資料類型 | 值 |
---|---|---|
PROJECT_ID |
STRING |
資料集所屬專案的專案 ID。 |
PROJECT_NUMBER |
INT64 |
資料集所屬專案的專案編號。 |
TABLE_CATALOG |
STRING |
資料集所屬專案的專案 ID。 |
TABLE_SCHEMA |
STRING |
包含資料表或具體化檢視區塊的資料集名稱,又稱為 datasetId 。 |
TABLE_NAME |
STRING |
資料表或具體化檢視表的名稱,又稱為 tableId 。 |
CREATION_TIME |
TIMESTAMP |
資料表的建立時間。 |
TOTAL_ROWS |
INT64 |
資料表或具體化檢視區塊中的資料列總數。 |
TOTAL_PARTITIONS |
INT64 |
資料表或具體化檢視區塊中的分區數。 未分區資料表會傳回 0。 |
TOTAL_LOGICAL_BYTES |
INT64 |
資料表或具體化檢視區塊中的邏輯 (未壓縮) 位元組總數。 |
ACTIVE_LOGICAL_BYTES |
INT64 |
未滿 90 天的邏輯 (未壓縮) 位元組數。 |
LONG_TERM_LOGICAL_BYTES |
INT64 |
超過 90 天的邏輯 (未壓縮) 位元組數。 |
CURRENT_PHYSICAL_BYTES |
INT64 |
目前資料表在所有分區的實際位元組總數。 |
TOTAL_PHYSICAL_BYTES |
INT64 |
儲存空間使用的實體 (壓縮) 位元組總數,包括使用中、長期和時空旅行 (已刪除或變更的資料) 位元組。不包括安全機制 (在時間旅行視窗後保留的已刪除或變更資料) 位元組。 |
ACTIVE_PHYSICAL_BYTES |
INT64 |
90 天內實體 (壓縮) 位元組數,包括時間旅行 (已刪除或變更的資料) 位元組。 |
LONG_TERM_PHYSICAL_BYTES |
INT64 |
超過 90 天的實體 (壓縮) 位元組數。 |
TIME_TRAVEL_PHYSICAL_BYTES |
INT64 |
時空旅行儲存空間 (已刪除或變更的資料) 使用的實體 (壓縮) 位元組數。 |
STORAGE_LAST_MODIFIED_TIME |
TIMESTAMP |
資料最近一次寫入資料表的時間。 |
DELETED |
BOOLEAN |
指出資料表是否已刪除。 |
TABLE_TYPE |
STRING |
資料表類型。例如 BASE TABLE 。 |
FAIL_SAFE_PHYSICAL_BYTES |
INT64 |
安全儲存空間 (已刪除或變更的資料) 使用的實體 (壓縮) 位元組數。 |
LAST_METADATA_INDEX_REFRESH_TIME |
TIMESTAMP |
資料表的上次中繼資料索引重新整理時間。 |
TABLE_DELETION_REASON |
STRING |
如果 DELETED 欄位為 true,則為資料表刪除原因。可能的值如下:
|
TABLE_DELETION_TIME |
TIMESTAMP |
資料表的刪除時間。 |
範圍和語法
對這個檢視表執行的查詢必須包含區域限定詞。下表說明這個檢視畫面的區域範圍:
檢視表名稱 | 資源範圍 | 區域範圍 |
---|---|---|
[`PROJECT_ID`.]`region-REGION`.INFORMATION_SCHEMA.TABLE_STORAGE_BY_ORGANIZATION |
包含指定專案的機構 | REGION |
-
選用:
PROJECT_ID
:您的 Trusted Cloud 專案 ID。如未指定,系統會使用預設專案。 -
REGION
:任何資料集區域名稱。 例如:`region-us`
。
以下範例說明如何傳回機構中指定專案的資料表儲存空間資訊:
SELECT * FROM `myProject`.`region-REGION`.INFORMATION_SCHEMA.TABLE_STORAGE_BY_ORGANIZATION;
以下範例說明如何傳回機構中資料表的專案儲存空間資訊:
SELECT * FROM `region-REGION`.INFORMATION_SCHEMA.TABLE_STORAGE_BY_ORGANIZATION;
範例
以下範例顯示機構中目前使用最多儲存空間的專案。
SELECT project_id, SUM(total_logical_bytes) AS total_logical_bytes FROM `region-REGION`.INFORMATION_SCHEMA.TABLE_STORAGE_BY_ORGANIZATION GROUP BY project_id ORDER BY total_logical_bytes DESC;
結果會類似如下:
+---------------------+---------------------+ | project_id | total_logical_bytes | +---------------------+---------------------+ | projecta | 971329178274633 | +---------------------+---------------------+ | projectb | 834638211024843 | +---------------------+---------------------+ | projectc | 562910385625126 | +---------------------+---------------------+