Tampilan TABLE_STORAGE_BY_FOLDER

Tampilan INFORMATION_SCHEMA.TABLE_STORAGE_BY_FOLDER berisi satu baris untuk setiap tabel atau tampilan terwujud di folder induk project saat ini, termasuk subfoldernya.

Tabel ini tidak menyimpan data real-time dan mungkin tertunda beberapa detik hingga beberapa menit. Perubahan penyimpanan yang dihasilkan dari masa berlaku partisi atau tabel saja, atau dari modifikasi pada periode perjalanan waktu set data, mungkin memerlukan waktu hingga satu hari untuk muncul di tampilan INFORMATION_SCHEMA.TABLE_STORAGE. Jika set data yang berisi lebih dari 1.000 tabel dihapus, tampilan ini tidak akan mencerminkan perubahan tersebut hingga periode perjalanan waktu untuk set data yang dihapus telah berlalu.

Tampilan penyimpanan tabel memberikan cara mudah untuk mengamati konsumsi penyimpanan saat ini. Selain itu, tampilan ini memberikan detail tentang apakah penyimpanan Anda menggunakan byte logis yang tidak terkompresi, byte fisik terkompresi, atau byte perjalanan waktu. Informasi ini dapat membantu Anda menangani tugas-tugas seperti merencanakan pertumbuhan pada masa mendatang dan memahami pola pembaruan untuk tabel.

Data yang disertakan dalam kolom *_BYTES

Kolom *_BYTES dalam tampilan penyimpanan tabel menyertakan informasi tentang penggunaan byte penyimpanan. Informasi ini ditentukan dengan melihat penggunaan penyimpanan untuk tampilan terwujud dan jenis tabel berikut:

  • Tabel permanen yang dibuat melalui salah satu metode yang dijelaskan dalam Membuat dan menggunakan tabel.
  • Tabel sementara yang dibuat dalam beberapa sesi. Tabel ini ditempatkan ke dalam set data dengan nama yang dihasilkan seperti "_c018003e063d09570001ef33ae401fad6ab92a6a".
  • Tabel sementara yang dibuat di kueri multi-pernyataan ("skrip"). Tabel ini ditempatkan ke dalam set data dengan nama yang dihasilkan seperti "_script72280c173c88442c3a7200183a50eeeaa4073719".

Data yang disimpan di cache hasil kueri tidak ditagihkan kepada Anda, sehingga tidak disertakan dalam nilai kolom *_BYTES.

Clone dan snapshot menampilkan nilai kolom *_BYTES seolah-olah merupakan tabel lengkap, bukan menampilkan delta dari penyimpanan yang digunakan oleh tabel dasar, sehingga clone dan snapshot tersebut merupakan estimasi yang berlebihan. Tagihan Anda memperhitungkan penggunaan penyimpanan delta ini secara tepat. Untuk mengetahui informasi selengkapnya tentang byte delta yang disimpan dan ditagih oleh clone dan snapshot, lihat tampilan TABLE_STORAGE_USAGE_TIMELINE.

Memperkirakan penagihan penyimpanan

Untuk memperkirakan penagihan penyimpanan bulanan untuk set data, Anda dapat menggunakan kolom logical atau physical *_BYTES dalam tampilan ini, bergantung pada model penagihan penyimpanan set data yang digunakan oleh set data. Perlu diperhatikan bahwa ini hanya perkiraan kasar, dan jumlah penagihan yang tepat dihitung berdasarkan penggunaan oleh infrastruktur penagihan penyimpanan BigQuery serta terlihat di Penagihan Cloud.

Untuk set data yang menggunakan model penagihan logis, Anda dapat memperkirakan biaya penyimpanan bulanan sebagai berikut:

((nilai ACTIVE_LOGICAL_BYTES/POW(1024, 3)) * harga byte logis aktif) + ((nilai LONG_TERM_LOGICAL_BYTES/POW(1024, 3)) * harga byte logis jangka panjang)

Nilai ACTIVE_LOGICAL_BYTES untuk tabel mencerminkan byte aktif yang saat ini digunakan oleh tabel tersebut.

Untuk set data yang menggunakan model penagihan fisik, Anda dapat memperkirakan biaya penyimpanan sebagai berikut:

((nilai ACTIVE_PHYSICAL_BYTES + FAIL_SAFE_PHYSICAL_BYTES/POW(1024, 3)) * harga byte fisik aktif) + ((nilai LONG_TERM_PHYSICAL_BYTES/POW(1024, 3)) * harga byte fisik jangka panjang)

Nilai ACTIVE_PHYSICAL_BYTES untuk tabel mencerminkan byte aktif yang saat ini digunakan oleh tabel tersebut, plus byte yang digunakan dalam perjalanan waktu untuk tabel tersebut.

Untuk melihat byte aktif tabel saja, kurangi nilai TIME_TRAVEL_PHYSICAL_BYTES dari nilai ACTIVE_PHYSICAL_BYTES.

Untuk mengetahui informasi selengkapnya, lihat Harga penyimpanan.

Izin yang diperlukan

Untuk membuat kueri tampilan INFORMATION_SCHEMA.TABLE_STORAGE_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.admin
  • roles/bigquery.dataViewer
  • roles/bigquery.dataEditor
  • roles/bigquery.metadataViewer

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

Skema

Tampilan INFORMATION_SCHEMA.TABLE_STORAGE_BY_FOLDER memiliki skema berikut:

Nama kolom Jenis data Nilai
FOLDER_NUMBERS REPEATED INTEGER Jumlah 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_BY_FOLDER.
PROJECT_ID STRING ID project dari project yang berisi set data.
PROJECT_NUMBER INT64 Nomor project dari project yang berisi set data.
TABLE_CATALOG STRING ID 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.
CREATION_TIME TIMESTAMP Waktu pembuatan tabel.
TOTAL_ROWS INT64 Jumlah total baris dalam tabel atau tampilan terwujud.
TOTAL_PARTITIONS INT64 Jumlah partisi yang ada dalam tabel atau tampilan terwujud. Tabel yang tidak dipartisi menampilkan 0.
TOTAL_LOGICAL_BYTES INT64 Jumlah total byte logis (tidak terkompresi) dalam tabel atau tampilan terwujud.
ACTIVE_LOGICAL_BYTES INT64 Jumlah byte logis (tidak terkompresi) dengan usia kurang dari 90 hari.
LONG_TERM_LOGICAL_BYTES INT64 Jumlah byte logis (tidak terkompresi) yang sudah lebih dari 90 hari.
CURRENT_PHYSICAL_BYTES INT64 Jumlah total byte fisik untuk penyimpanan tabel saat ini di semua partisi.
TOTAL_PHYSICAL_BYTES INT64 Jumlah total byte fisik (terkompresi) yang digunakan untuk penyimpanan, termasuk byte aktif, jangka panjang, dan perjalanan waktu (data yang dihapus atau diubah). Byte fail-safe (data yang dihapus atau diubah yang disimpan setelah periode perjalanan waktu) tidak disertakan.
ACTIVE_PHYSICAL_BYTES INT64 Jumlah byte fisik (terkompresi) yang lebih muda dari 90 hari, termasuk byte perjalanan waktu (data yang dihapus atau diubah).
LONG_TERM_PHYSICAL_BYTES INT64 Jumlah byte fisik (terkompresi) yang sudah lebih dari 90 hari.
TIME_TRAVEL_PHYSICAL_BYTES INT64 Jumlah byte fisik (terkompresi) yang digunakan oleh penyimpanan perjalanan waktu (data yang dihapus atau diubah).
STORAGE_LAST_MODIFIED_TIME TIMESTAMP Waktu terakhir kali data ditulis ke tabel.
DELETED BOOLEAN Menunjukkan apakah tabel dihapus atau tidak.
TABLE_TYPE STRING Jenis tabel. Misalnya, BASE TABLE.
FAIL_SAFE_PHYSICAL_BYTES INT64 Jumlah byte fisik (terkompresi) yang digunakan oleh penyimpanan gagal aman (data yang dihapus atau diubah).
LAST_METADATA_INDEX_REFRESH_TIME TIMESTAMP Waktu pembaruan indeks metadata terakhir dari tabel.

Cakupan dan sintaksis

Kueri terhadap tabel virtual ini harus menyertakan penentu region. Tabel berikut menjelaskan cakupan wilayah untuk tampilan ini:

Nama tampilan Cakupan resource Cakupan region
[`PROJECT_ID`.]`region-REGION`.INFORMATION_SCHEMA.TABLE_STORAGE_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`.

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

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

Contoh

Kueri berikut menunjukkan project mana dalam folder yang menggunakan penyimpanan paling banyak:

SELECT
  project_id,
  SUM(total_logical_bytes) AS total_logical_bytes
FROM
  `region-REGION`.INFORMATION_SCHEMA.TABLE_STORAGE_BY_FOLDER
GROUP BY
  project_id
ORDER BY
  total_logical_bytes DESC;

Hasilnya mirip dengan berikut ini:

+---------------------+---------------------+
|     project_id      | total_logical_bytes |
+---------------------+---------------------+
| projecta            |     971329178274633 |
+---------------------+---------------------+
| projectb            |     834638211024843 |
+---------------------+---------------------+
| projectc            |     562910385625126 |
+---------------------+---------------------+