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 pemberi rekomendasi BigQuery dari Active Assist dan menampilkannya di tampilan ini.

Tampilan INFORMATION_SCHEMA.RECOMMENDATIONS mendukung rekomendasi berikut:

Tampilan INFORMATION_SCHEMA.RECOMMENDATIONS hanya menampilkan rekomendasi terkait BigQuery. Anda dapat melihat Google Cloud rekomendasi di Active Assist.

Izin yang diperlukan

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

Minta administrator Anda untuk memberikan akses guna melihat rekomendasi. Untuk melihat izin yang diperlukan untuk setiap pemberi rekomendasi, lihat bagian berikut:

Skema

Tampilan INFORMATION_SCHEMA.RECOMMENDATIONS memiliki skema berikut:

Nama kolom Jenis data Nilai
recommendation_id STRING ID berenkode Base64 yang berisi RecommendationID dan pemberi rekomendasi.
recommender STRING Jenis rekomendasi. Misalnya, google.bigquery.table.PartitionClusterRecommender untuk rekomendasi partisi dan pengelompokan.
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 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 rekomendasi ini saat mencoba mengoptimalkan kategori utama. Berisi kolom berikut:
  • category: Kategori yang coba 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 adalah COST.
  • security_projection: Mungkin ada jika kategori 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 pemberi rekomendasi.
  • state_metadata: Metadata tentang status rekomendasi dalam pasangan nilai kunci.
  • operations: Daftar operasi yang dapat dilakukan pengguna pada resource target. Objek ini berisi 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 proyeksi slot_hours_saved_monthly:

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
+---------------------------------------------------+--------------------------------------------------------------------------------------------------+