Tabel virtual INFORMATION_SCHEMA.INSIGHTS

Untuk meminta masukan atau dukungan terkait fitur ini, kirim email ke bq-recommendations+feedback@google.com.

Tabel virtual INFORMATION_SCHEMA.INSIGHTS berisi insight tentang semua rekomendasi BigQuery dalam project saat ini. BigQuery mengambil insight untuk semua jenis insight BigQuery dari Active Assist dan menampilkannya di tabel virtual ini. Insight BigQuery selalu dikaitkan dengan rekomendasi.

Tabel virtual INFORMATION_SCHEMA.INSIGHTS mendukung rekomendasi berikut:

Izin yang diperlukan

Untuk melihat insight dengan tabel virtual INFORMATION_SCHEMA.INSIGHTS, Anda harus memiliki izin yang diperlukan untuk recommender yang sesuai. Tabel virtual INFORMATION_SCHEMA.INSIGHTS hanya menampilkan insight dari rekomendasi yang izinnya Anda miliki.

Minta administrator Anda untuk memberikan akses untuk melihat insight. Untuk melihat izin yang diperlukan untuk setiap recommender, lihat hal berikut:

Skema

Tampilan INFORMATION_SCHEMA.INSIGHTS memiliki skema berikut:

Nama kolom Jenis data Nilai
insight_id STRING ID berenkode Base64 yang berisi jenis insight dan ID insight
insight_type STRING Jenis Insight. Misalnya, google.bigquery.materializedview.Insight.
subtype STRING Subjenis insight.
project_id STRING ID project.
project_number STRING Nomor project.
description STRING Deskripsi tentang rekomendasi.
last_updated_time TIMESTAMP Kolom ini menunjukkan waktu saat insight terakhir dimuat ulang.
category STRING Kategori pengoptimalan dampak.
target_resources STRING Nama resource yang memenuhi syarat sepenuhnya yang ditargetkan oleh insight ini.
state STRING Status insight. Untuk mengetahui daftar kemungkinan nilai, lihat Nilai.
severity STRING Tingkat keparahan Insight. Untuk mengetahui daftar kemungkinan nilai, lihat Tingkat Keparahan.
associated_recommendation_ids STRING Nama rekomendasi lengkap yang terkait dengan insight ini. Nama rekomendasi adalah representasi berenkode Base64 dari jenis recommender dan ID rekomendasi.
additional_details RECORD Detail tambahan tentang insight.
  • content: Konten insight dalam format JSON.
  • state_metadata: Metadata tentang status Insight. Berisi pasangan nilai kunci.
  • observation_period_seconds: Periode Observasi untuk membuat insight.

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

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

Contoh

Untuk menjalankan kueri terhadap project selain project default Anda, tambahkan project ID dalam format berikut: 

`PROJECT_ID`.`region-REGION_NAME`.INFORMATION_SCHEMA.INSIGHTS
 Ganti kode berikut:

  • PROJECT_ID: ID project.
  • REGION_NAME: region untuk project Anda.

Misalnya, `myproject`.`region-us`.INFORMATION_SCHEMA.INSIGHTS.

Melihat insight aktif dengan penghematan biaya

Contoh berikut menggabungkan tabel virtual insight dengan tabel virtual rekomendasi untuk menampilkan 3 rekomendasi untuk insight yang AKTIF dalam kategori BIAYA:

WITH
 insights as (SELECT * FROM `region-us`.INFORMATION_SCHEMA.INSIGHTS),
 recs as (SELECT recommender, recommendation_id, additional_details FROM `region-us`.INFORMATION_SCHEMA.RECOMMENDATIONS)

SELECT
   recommender,
   target_resources,
   LAX_INT64(recs.additional_details.overview.bytesSavedMonthly) / POW(1024, 3) as est_gb_saved_monthly,
   LAX_INT64(recs.additional_details.overview.slotMsSavedMonthly) / (1000 * 3600) as slot_hours_saved_monthly,
   insights.additional_details.observation_period_seconds / 86400 as observation_period_days,
   last_updated_time
FROM
  insights
JOIN recs
ON
  recommendation_id in UNNEST(associated_recommendation_ids)
WHERE
  state = 'ACTIVE'
AND
  category = 'COST'
LIMIT 3;

Hasilnya mirip dengan berikut ini:

+---------------------------------------------------+---------------------+--------------------+--------------------------+-------------------------+---------------------+
|                    recommender                    |   target_resource   |  gb_saved_monthly  | slot_hours_saved_monthly | observation_period_days |  last_updated_time  |
+---------------------------------------------------+---------------------+--------------------+--------------------------+-------------------------+---------------------+
| google.bigquery.table.PartitionClusterRecommender | ["table_resource1"] |   3934.07264107652 |       10.499466666666667 |                    30.0 | 2024-07-01 16:41:25 |
| google.bigquery.table.PartitionClusterRecommender | ["table_resource2"] | 4393.7416711859405 |        56.61476777777777 |                    30.0 | 2024-07-01 16:41:25 |
| google.bigquery.materializedview.Recommender      | ["project_resource"]| 140805.38289248943 |        9613.139166666666 |                     2.0 | 2024-07-01 13:00:31 |
+---------------------------------------------------+---------------------+--------------------+--------------------------+-------------------------+---------------------+