Halaman ini diterjemahkan oleh Cloud Translation API.

Tampilan TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER

Tampilan INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER memberikan total penggunaan penyimpanan harian selama 90 hari terakhir untuk jenis tabel berikut.

Tabel standar
Tampilan terwujud
Clone tabel yang memiliki delta dalam byte dari tabel dasar
Snapshot tabel yang memiliki delta dalam byte dari tabel dasar

Tampilan INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER mengecualikan tabel tanpa byte yang dapat ditagih. Jenis tabel berikut dikecualikan:

Tabel eksternal
Tabel anonim
Tabel kosong
Clone tabel yang tidak memiliki delta dalam byte dari tabel dasar
Snapshot tabel yang tidak memiliki delta dalam byte dari tabel dasar

Saat Anda membuat kueri tampilan INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER, hasil kueri akan berisi satu baris per hari untuk setiap tabel atau tampilan terwujud di folder induk project saat ini, termasuk subfoldernya.

Data tabel ini tidak tersedia secara real time. Data tabel memerlukan waktu sekitar 72 jam untuk muncul dalam tampilan ini.

Tampilan ini menampilkan penggunaan penyimpanan dalam hitungan detik MiB. Misalnya, jika project menggunakan 1.000.000 byte fisik selama 86.400 detik (24 jam), total penggunaan fisik adalah 86.400.000.000 byte detik, yang dikonversi menjadi 82.397 MiB detik, seperti yang ditunjukkan dalam contoh berikut:

86,400,000,000 / 1,024 / 1,024 = 82,397

Nilai penggunaan penyimpanan dapat ditemukan di kolom BILLABLE_TOTAL_PHYSICAL_USAGE. Untuk mengetahui informasi selengkapnya, lihat Detail harga penyimpanan.

Izin yang diperlukan

Untuk membuat kueri tampilan INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER, Anda memerlukan izin Identity and Access Management (IAM) berikut untuk folder induk project:

bigquery.tables.get
bigquery.tables.list

Setiap peran IAM yang telah ditetapkan berikut mencakup izin sebelumnya:

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

Untuk mengetahui informasi selengkapnya tentang izin BigQuery, lihat Peran dan izin IAM BigQuery.

Skema

Tabel virtual INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER memiliki skema berikut:

`USAGE_DATE`	`DATE`	Tanggal penagihan untuk byte yang ditampilkan, menggunakan zona waktu `America/Los_Angeles`
`FOLDER_NUMBERS`	`REPEATED INTEGER`	Nomor ID folder yang berisi project, dimulai dengan folder yang langsung berisi project, diikuti dengan folder yang berisi folder turunan, dan sebagainya. Misalnya, jika `FOLDER_NUMBERS` adalah `[1, 2, 3]`, maka folder `1` langsung berisi project, folder `2` berisi `1`, dan folder `3` berisi `2`. Kolom ini hanya diisi di `TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER`.
`PROJECT_ID`	`STRING`	ID project dari project yang berisi set data
`TABLE_CATALOG`	`STRING`	ID project dari project yang berisi set data
`PROJECT_NUMBER`	`INT64`	Nomor project dari project yang berisi set data
`TABLE_SCHEMA`	`STRING`	Nama set data yang berisi tabel atau tampilan terwujud, juga disebut sebagai `datasetId`
`TABLE_NAME`	`STRING`	Nama tabel atau tampilan terwujud, juga disebut sebagai `tableId`
`BILLABLE_TOTAL_LOGICAL_USAGE`	`INT64`	Total penggunaan logis, dalam detik MiB. Menampilkan 0 jika set data menggunakan model penagihan penyimpanan fisik.
`BILLABLE_ACTIVE_LOGICAL_USAGE`	`INT64`	Penggunaan logis yang berusia kurang dari 90 hari, dalam satuan MiB detik. Menampilkan 0 jika set data menggunakan model penagihan penyimpanan fisik.
`BILLABLE_LONG_TERM_LOGICAL_USAGE`	`INT64`	Penggunaan logis yang sudah lebih dari 90 hari, dalam satuan MiB detik. Menampilkan 0 jika set data menggunakan model penagihan penyimpanan fisik.
`BILLABLE_TOTAL_PHYSICAL_USAGE`	`INT64`	Total penggunaan dalam MiB detik. Hal ini mencakup byte fisik yang digunakan untuk penyimpanan perjalanan waktu dan fail-safe. Menampilkan 0 jika set data menggunakan model penagihan penyimpanan logis.
`BILLABLE_ACTIVE_PHYSICAL_USAGE`	`INT64`	Penggunaan fisik yang berusia kurang dari 90 hari, dalam hitungan detik MiB. Hal ini mencakup byte fisik yang digunakan untuk penyimpanan fail-safe dan perjalanan waktu. Menampilkan 0 jika set data menggunakan model penagihan penyimpanan logis.
`BILLABLE_LONG_TERM_PHYSICAL_USAGE`	`INT64`	Penggunaan fisik yang sudah lebih dari 90 hari, dalam hitungan detik MiB. Menampilkan 0 jika set data menggunakan model penagihan penyimpanan logis.

Cakupan dan sintaksis

Kueri terhadap tabel virtual ini harus menyertakan penentu region. Jika Anda tidak menentukan penentu regional, metadata akan diambil dari semua region. Tabel berikut menjelaskan cakupan region untuk tabel virtual ini:

Nama tabel virtual	Cakupan resource	Cakupan region
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER	Folder yang berisi project yang ditentukan	`REGION`

Ganti kode berikut:

Opsional: PROJECT_ID: ID project Google Cloud Anda. Jika tidak ditentukan, project default akan digunakan.
REGION: nama region set data apa pun. Misalnya, `region-us`.

Catatan: Anda harus menggunakan penentu region untuk membuat kueri tabel virtual INFORMATION_SCHEMA. Lokasi eksekusi kueri harus cocok dengan region tampilan INFORMATION_SCHEMA.

Untuk mengambil informasi penyimpanan tabel di folder induk project yang ditentukan, jalankan kueri berikut:

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

Contoh

Kueri berikut menunjukkan penggunaan untuk semua tabel dalam folder pada tanggal terbaru:

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;

Hasilnya mirip dengan berikut ini:

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