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
ビューにクエリを実行すると、クエリの結果には現在のプロジェクトに関連付けられた組織全体のテーブルまたはマテリアライズド・ビューごとに、1 日ごとに 1 行が表示されます。
この表のデータはリアルタイムでは使用できません。テーブルデータがこのビューに反映されるまでに約 72 時間かかります。
ストレージ使用量は MB 秒で返されます。たとえば、プロジェクトが 1,000,000 物理バイトを 86,400 秒(24 時間)使用している場合、物理使用量の合計は 86,400,000,000 バイト秒となり、次の例のように 82,397 MB 秒に変換されます。
86,400,000,000 / 1,024 / 1,024 = 82,397
この値が BILLABLE_TOTAL_PHYSICAL_USAGE
列から返されます。
詳細については、ストレージの料金をご覧ください。
必要な権限
INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_ORGANIZATION
ビューをクエリするには、組織に対する次の Identity and Access Management(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 |
データセットを含むプロジェクトのプロジェクト ID |
TABLE_CATALOG |
STRING |
データセットを含むプロジェクトのプロジェクト ID |
PROJECT_NUMBER |
INT64 |
データセットを含むプロジェクトのプロジェクト番号 |
TABLE_SCHEMA |
STRING |
テーブルやマテリアライズド ビューを含むデータセットの名前(datasetId とも呼ばれる) |
TABLE_NAME |
STRING |
テーブルまたはマテリアライズド ビューの名前(tableId とも呼ばれる) |
BILLABLE_TOTAL_LOGICAL_USAGE |
INT64 |
論理使用量の合計(MB 秒)。 データセットが物理ストレージの課金モデルを使用している場合は 0 を返します。 |
BILLABLE_ACTIVE_LOGICAL_USAGE |
INT64 |
90 日を経過していない論理使用量(MB 秒単位)。 データセットが物理ストレージの課金モデルを使用している場合は 0 を返します。 |
BILLABLE_LONG_TERM_LOGICAL_USAGE |
INT64 |
90 日以上経過した論理使用量(MB 秒単位)。 データセットが物理ストレージの課金モデルを使用している場合は 0 を返します。 |
BILLABLE_TOTAL_PHYSICAL_USAGE |
INT64 |
合計使用量(MB 秒)。これには、フェイルセーフとタイムトラベル ストレージに使用される物理バイトが含まれます。 データセットが論理ストレージの課金モデルを使用している場合は 0 を返します。 |
BILLABLE_ACTIVE_PHYSICAL_USAGE |
INT64 |
90 日を経過していない物理使用量(MB 秒単位)。これには、フェイルセーフとタイムトラベル ストレージに使用される物理バイトが含まれます。 データセットが論理ストレージの課金モデルを使用している場合は 0 を返します。 |
BILLABLE_LONG_TERM_PHYSICAL_USAGE |
INT64 |
90 日以上経過した物理使用量(MB 秒)。 データセットが論理ストレージの課金モデルを使用している場合は 0 を返します。 |
スコープと構文
このビューに対するクエリでは、リージョン修飾子を指定する必要があります。リージョン修飾子を指定しない場合、メタデータはすべてのリージョンから取得されます。次の表に、このビューのリージョン スコープを示します。
ビュー名 | リソース スコープ | リージョン スコープ |
---|---|---|
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_ORGANIZATION |
指定されたプロジェクトを含む組織 | REGION |
- 省略可:
PROJECT_ID
: Google Cloud プロジェクトの ID。指定しない場合は、デフォルトのプロジェクトが使用されます。
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 | +--------------+------------+--------------+------------+------------------------------+-------------------------------+