Tampilan INFORMATION_SCHEMA.RECOMMENDATIONS

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

Tampilan INFORMATION_SCHEMA.RECOMMENDATIONS berisi data tentang semua rekomendasi BigQuery dalam project saat ini. BigQuery mengambil rekomendasi untuk semua perekomendasikan BigQuery dari Recommendation Hub dan menampilkannya dalam tampilan ini.

Tampilan INFORMATION_SCHEMA.RECOMMENDATIONS mendukung rekomendasi berikut:

Tampilan INFORMATION_SCHEMA.RECOMMENDATIONS hanya menampilkan rekomendasi terkait BigQuery. Anda dapat melihat rekomendasi Google Cloud di Hub Rekomendasi.

Izin yang diperlukan

Untuk melihat rekomendasi dengan tampilan INFORMATION_SCHEMA.RECOMMENDATIONS, Anda harus memiliki izin yang diperlukan untuk perekomendasikan yang sesuai. Tampilan INFORMATION_SCHEMA.RECOMMENDATIONS hanya menampilkan rekomendasi yang Anda miliki izin untuk melihatnya.

Minta administrator untuk memberikan akses guna melihat rekomendasi. Untuk melihat izin yang diperlukan untuk setiap perekomendasikan, lihat hal berikut:

Skema

Tampilan INFORMATION_SCHEMA.RECOMMENDATIONS memiliki skema berikut:

Nama kolom Jenis data Nilai
recommendation_id STRING ID yang dienkode Base64 yang berisi RecommendationID dan perekomendasikan.
recommender STRING Jenis rekomendasi. Misalnya, google.bigquery.table.PartitionClusterRecommender untuk rekomendasi partisi dan cluster.
subtype STRING Subjenis rekomendasi.
project_id STRING ID project.
project_number STRING Nomor project.
description STRING Deskripsi tentang rekomendasi.
last_updated_time TIMESTAMP Kolom ini menunjukkan waktu saat rekomendasi terakhir kali dibuat.
target_resources STRING Nama resource yang sepenuhnya memenuhi syarat yang ditargetkan oleh rekomendasi ini.
state STRING Status rekomendasi. Untuk mengetahui daftar kemungkinan nilai, lihat Status.
primary_impact RECORD Dampak yang dapat ditimbulkan rekomendasi ini saat mencoba mengoptimalkan kategori utama. Berisi kolom berikut:
  • category: Kategori yang dicoba dioptimalkan oleh rekomendasi ini. Untuk mengetahui daftar kemungkinan nilai, lihat Kategori.
  • cost_projection: Nilai ini dapat diisi jika rekomendasi dapat memproyeksikan penghematan biaya dari rekomendasi ini. Hanya ada jika kategorinya COST.
  • security_projection: Mungkin ada jika kategorinya adalah SECURITY.
priority STRING Prioritas rekomendasi. Untuk mengetahui daftar kemungkinan nilai, lihat Prioritas.
associated_insight_ids STRING Nama Insight lengkap yang terkait dengan rekomendasi.Nama Insight adalah representasi nama jenis Insight & ID Insight yang dienkode Base64. Ini dapat digunakan untuk membuat kueri tampilan Insight.
additional_details RECORD Detail Tambahan tentang rekomendasi.
  • overview: Ringkasan rekomendasi dalam format JSON. Konten kolom ini dapat berubah berdasarkan perekomendasikan.
  • state_metadata: Metadata tentang status rekomendasi dalam pasangan nilai kunci.
  • operations: Daftar operasi yang dapat dilakukan pengguna pada resource target. Isinya adalah kolom berikut:
    • action: Jenis tindakan yang harus dilakukan pengguna. Ini dapat berupa teks bebas yang ditetapkan oleh sistem saat membuat rekomendasi. Akan selalu terisi.
    • resource_type: Jenis resource cloud.
    • resource: Nama resource yang sepenuhnya memenuhi syarat.
    • path: Jalur kolom target relatif terhadap resource.
    • value: Nilai kolom jalur.

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.RECOMMENDATIONS[_BY_PROJECT] 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`.

    • Contoh

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

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

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

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

    Melihat rekomendasi penghematan biaya teratas

    Contoh berikut menampilkan 3 rekomendasi kategori COST teratas berdasarkan slot_hours_saved_monthly yang diproyeksikan:

    SELECT 
   recommender,
   target_resources,
   LAX_INT64(additional_details.overview.bytesSavedMonthly) / POW(1024, 3) as est_gb_saved_monthly,
    LAX_INT64(additional_details.overview.slotMsSavedMonthly) / (1000 * 3600) as slot_hours_saved_monthly,
  last_updated_time
FROM 
  `region-us`.
   INFORMATION_SCHEMA.RECOMMENDATIONS_BY_PROJECT
WHERE 
   primary_impact.category = 'COST'
AND
   state = 'ACTIVE'
ORDER by 
   slot_hours_saved_monthly DESC 
LIMIT 3;

    Hasilnya mirip dengan berikut ini:

    +---------------------------------------------------+--------------------------------------------------------------------------------------------------+
|                    recommender                    |   target_resources      | est_gb_saved_monthly | slot_hours_saved_monthly |  last_updated_time
+---------------------------------------------------+--------------------------------------------------------------------------------------------------+
| google.bigquery.materializedview.Recommender      | ["project_resource"]    | 140805.38289248943   |        9613.139166666666 |  2024-07-01 13:00:00
| google.bigquery.table.PartitionClusterRecommender | ["table_resource_1"]    | 4393.7416711859405   |        56.61476777777777 |  2024-07-01 13:00:00
| google.bigquery.table.PartitionClusterRecommender | ["table_resource_2"]    |   3934.07264107652   |       10.499466666666667 |  2024-07-01 13:00:00
+---------------------------------------------------+--------------------------------------------------------------------------------------------------+