Tabel virtual INFORMATION_SCHEMA.BI_CAPACITIES

Tabel virtual INFORMATION_SCHEMA.BI_CAPACITIES berisi metadata tentang status kapasitas BI Engine saat ini. Jika Anda ingin melihat histori perubahan pada pemesanan BI Engine, lihat tabel virtual INFORMATION_SCHEMA.BI_CAPACITY_CHANGES.

Izin yang diperlukan

Untuk membuat kueri tabel virtual INFORMATION_SCHEMA.BI_CAPACITIES, Anda memerlukan izin Identity and Access Management (IAM) bigquery.bireservations.get untuk reservasi BI Engine.

Untuk mengetahui informasi selengkapnya tentang izin BigQuery, lihat Kontrol akses dengan IAM.

Skema

Saat Anda membuat kueri tabel virtual INFORMATION_SCHEMA.BI_CAPACITIES, hasil kueri akan berisi satu baris dengan status kapasitas BI Engine saat ini.

Tabel virtual INFORMATION_SCHEMA.BI_CAPACITIES memiliki skema berikut:

Nama kolom	Jenis data	Nilai
project_id	STRING	ID project yang berisi kapasitas BI Engine.
project_number	INTEGER	Nomor project dari project yang berisi kapasitas BI Engine.
bi_capacity_name	STRING	Nama objek. Saat ini, hanya boleh ada satu kapasitas per project, sehingga namanya selalu ditetapkan ke default.
size	INTEGER	RAM BI Engine dalam byte
preferred_tables	REPEATED STRING	Kumpulan tabel pilihan kapasitas BI Engine ini harus digunakan. Jika ditetapkan ke null, kapasitas BI Engine akan digunakan untuk semua kueri dalam project saat ini

Cakupan dan sintaksis

Kueri terhadap tabel virtual ini harus menyertakan penentu region. ID project bersifat opsional. Jika project ID tidak ditentukan, project tempat kueri dijalankan akan digunakan.

Nama tabel virtual	Cakupan resource	Cakupan region
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.BI_CAPACITIES	Level project	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 menentukan lokasi untuk membuat kueri tabel virtual INFORMATION_SCHEMA dan lokasi eksekusi kueri harus cocok dengan region tabel virtual INFORMATION_SCHEMA.

Contoh

-- Returns current state of BI Engine capacity.
SELECT * FROM myproject.`region-us`.INFORMATION_SCHEMA.BI_CAPACITIES;

Contoh

Contoh berikut mengambil perubahan kapasitas BI Engine saat ini dari tabel virtual INFORMATION_SCHEMA.BI_CAPACITIES.

Untuk menjalankan kueri terhadap project selain project tempat kueri berjalan, tambahkan project ID ke region dalam format berikut: `project_id`.`region_id`.INFORMATION_SCHEMA.BI_CAPACITIES.

Contoh berikut menunjukkan status BI Engine saat ini dalam project dengan ID 'my-project-id':

SELECT *
FROM `my-project-id.region-us`.INFORMATION_SCHEMA.BI_CAPACITIES

Hasilnya terlihat mirip seperti berikut:

  +---------------+----------------+------------------+--------------+-----------------------------------------------------------------------------------------------+
  |  project_id   | project_number | bi_capacity_name |     size     |                                               preferred_tables                                |
  +---------------+----------------+------------------+--------------+-----------------------------------------------------------------------------------------------+
  | my-project-id |   123456789000 | default          | 268435456000 | "my-company-project-id.dataset1.table1","bigquery-public-data.chicago_taxi_trips.taxi_trips"] |
  +---------------+----------------+------------------+--------------+-----------------------------------------------------------------------------------------------+
  

Contoh berikut menampilkan ukuran kapasitas BI Engine dalam gigabyte untuk project kueri:

SELECT
  project_id,
  size/1024.0/1024.0/1024.0 AS size_gb
FROM `region-us`.INFORMATION_SCHEMA.BI_CAPACITIES

Hasilnya terlihat mirip seperti berikut:

  +---------------+---------+
  |  project_id   | size_gb |
  +---------------+---------+
  | my-project-id |  250.0  |
  +---------------+---------+