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 時間かかります。

ストレージ使用量は MiB 秒で返されます。たとえば、プロジェクトが 1,000,000 物理バイトを 86,400 秒（24 時間）使用している場合、物理使用量の合計は 86,400,000,000 バイト秒となり、次の例のように 82,397 MiB 秒に変換されます。

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

論理使用量の合計（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 を返します。

スコープと構文

このビューに対するクエリでは、リージョン修飾子を指定する必要があります。リージョン修飾子を指定しない場合、メタデータはすべてのリージョンから取得されます。次の表に、このビューのリージョン スコープを示します。

ビュー名 リソース スコープ リージョン スコープ
[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                   |
+--------------+------------+--------------+------------+------------------------------+-------------------------------+