Tabel virtual RESERVATION_CHANGES

Tabel virtual INFORMATION_SCHEMA.RESERVATION_CHANGES berisi daftar semua perubahan pada reservasi dalam project administrasi yang hampir real-time. Setiap baris menunjukkan perubahan pada satu reservasi. Untuk mengetahui informasi selengkapnya, lihat Pengantar reservasi.

Izin yang diperlukan

Untuk membuat kueri tabel virtual INFORMATION_SCHEMA.RESERVATION_CHANGES, Anda memerlukan izin Identity and Access Management (IAM) bigquery.reservations.list pada project. Setiap peran IAM yang telah ditetapkan berikut menyertakan izin yang diperlukan:

  • Admin Resource BigQuery (roles/bigquery.resourceAdmin)
  • Editor Resource BigQuery (roles/bigquery.resourceEditor)
  • Viewer Resource BigQuery (roles/bigquery.resourceViewer)
  • Pengguna BigQuery (roles/bigquery.user)
  • Admin BigQuery (roles/bigquery.admin)

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

Skema

Tabel virtual INFORMATION_SCHEMA.RESERVATION_CHANGES memiliki skema berikut:

Nama kolom Jenis data Nilai
change_timestamp TIMESTAMP Waktu saat perubahan terjadi.
project_id STRING ID project administrasi.
project_number INTEGER Jumlah project administrasi.
reservation_name STRING Nama reservasi yang diberikan pengguna.
ignore_idle_slots BOOL Jika salah, semua kueri yang menggunakan reservasi ini dapat menggunakan slot tidak ada aktivitas yang tidak digunakan dari komitmen kapasitas lainnya.
action STRING Jenis peristiwa yang terjadi pada reservasi. Dapat berupa CREATE, UPDATE, atau DELETE.
slot_capacity INTEGER Dasar pengukuran reservasi.
user_email STRING Alamat email pengguna atau subjek federasi identitas tenaga kerja yang melakukan perubahan. google untuk perubahan yang dibuat oleh Google. NULL jika alamat email tidak diketahui.
target_job_concurrency INTEGER Jumlah target kueri yang dapat dieksekusi secara bersamaan, yang dibatasi oleh resource yang tersedia. Jika nol, nilai ini akan otomatis dihitung berdasarkan resource yang tersedia.
autoscale STRUCT

Informasi tentang kapasitas penskalaan otomatis reservasi. Kolom mencakup:

  • current_slots: jumlah slot yang ditambahkan ke reservasi oleh penskalaan otomatis.
  • max_slots: jumlah maksimum slot yang dapat ditambahkan ke reservasi dengan penskalaan otomatis.
edition STRING Edisi yang terkait dengan reservasi ini. Untuk mengetahui informasi selengkapnya tentang edisi, lihat Pengantar edisi BigQuery.
primary_location STRING Lokasi utama replika utama reservasi saat ini. Kolom ini hanya ditetapkan untuk reservasi yang menggunakan fitur pemulihan dari bencana yang dikelola .
secondary_location STRING Lokasi utama replika sekunder reservasi saat ini. Kolom ini hanya ditetapkan untuk reservasi yang menggunakan fitur pemulihan dari bencana yang dikelola .
original_primary_location STRING Lokasi tempat reservasi awalnya dibuat.
labels RECORD Array label yang terkait dengan reservasi.
reservation_group_path ARRAY<STRING> Grup reservasi yang ditautkan ke reservasi. Misalnya, jika reservasi ditautkan ke grup my-group, bidang reservation_group_path berisi daftar seperti seperti: [my-group].
max_slots INTEGER Jumlah maksimum slot yang dapat digunakan oleh reservasi ini, yang mencakup slot dasar pengukuran (slot_capacity), slot tidak ada aktivitas (jika ignore_idle_slots salah), dan slot penskalaan otomatis. Kolom ini ditentukan oleh pengguna untuk menggunakan fitur prediktabilitas reservasi.
scaling_mode STRING Mode penskalaan untuk reservasi, yang menentukan cara reservasi diskalakan dari dasar pengukuran ke max_slots. Kolom ini ditentukan oleh pengguna untuk menggunakan fitur prediktabilitas reservasi.

Untuk menjaga stabilitas, sebaiknya Anda mencantumkan kolom secara eksplisit dalam kueri skema informasi, bukan menggunakan karakter pengganti (SELECT *). Mencantumkan kolom secara eksplisit mencegah kueri gagal jika skema yang mendasarinya berubah.

Retensi data

Tampilan ini berisi reservasi saat ini dan reservasi terhapus yang disimpan selama maksimum 41 hari setelah penghapusan dari tampilan.

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.RESERVATION_CHANGES[_BY_PROJECT] Level project REGION
Ganti kode berikut:
  • Opsional: PROJECT_ID: ID project Anda. Google Cloud Jika tidak ditentukan, project default akan digunakan.
  • REGION: nama region set data apa pun. Misalnya, `region-us`.

Contoh

Contoh berikut mendapatkan histori perubahan untuk reservasi tertentu. Gunakan informasi ini untuk melihat daftar perubahan yang dilakukan pada reservasi tertentu, seperti membuat atau menghapus reservasi.

SELECT
  *
FROM
  reservation-admin-project.`region-us`.
  INFORMATION_SCHEMA.RESERVATION_CHANGES
WHERE
  reservation_name = "my-reservation"
ORDER BY
  change_timestamp DESC;