このページは Cloud Translation API によって翻訳されました。

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 ビューにクエリを実行すると、クエリの結果は、現在のプロジェクトの親フォルダ（サブフォルダを含む）内のテーブルまたはマテリアライズドビューごとに、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_FOLDER ビューをクエリするには、プロジェクトの親フォルダに対する次の Identity and Access Management（IAM）権限が必要です。

bigquery.tables.get
bigquery.tables.list

次の各 IAM 事前定義ロールには、上の権限が含まれています。

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

BigQuery の権限の詳細については、BigQuery の IAM ロールと権限をご覧ください。

スキーマ

INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER ビューのスキーマは次のとおりです。

`USAGE_DATE`	`DATE`	表示されたバイト数に対する請求日（`America/Los_Angeles` タイムゾーンを使用）
`FOLDER_NUMBERS`	`REPEATED INTEGER`	プロジェクトを含むフォルダの番号 ID。プロジェクトを直接含むフォルダから始まり、子フォルダを含むフォルダというように続きます。たとえば、`FOLDER_NUMBERS` が `[1, 2, 3]` の場合、フォルダ `1` にはプロジェクトが直接含まれ、フォルダ `2` には `1` が含まれ、フォルダ `3` には `2` が含まれます。この列は、`TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER` にのみ入力されます。
`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_FOLDER	指定したプロジェクトを含むフォルダ	`REGION`

次のように置き換えます。

省略可: PROJECT_ID: Google Cloud プロジェクトの ID。指定しない場合は、デフォルトのプロジェクトが使用されます。
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                |
+--------------+------------+--------------+------------+------------------------------+-------------------------------+