INFORMATION_SCHEMA.RECOMMENDATIONS tampilan

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

Tampilan INFORMATION_SCHEMA.RECOMMENDATIONS berisi data tentang semua BigQuery rekomendasi dalam proyek saat ini. BigQuery mengambil rekomendasi untuk semua pemberi rekomendasi BigQuery dari Hub Rekomendasi dan menampilkannya dalam tampilan ini.

Tampilan INFORMATION_SCHEMA.RECOMMENDATIONS mendukung hal berikut rekomendasi:

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 pemberi rekomendasi terkait. Tujuan INFORMATION_SCHEMA.RECOMMENDATIONS tampilan hanya menampilkan rekomendasi yang memiliki izin untuk melihat.

Minta administrator Anda untuk memberikan akses agar dapat melihat rekomendasi. Untuk melihat izin yang diperlukan untuk setiap pemberi rekomendasi, 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 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 rekomendasi ini.
state STRING Status rekomendasi. Untuk daftar kemungkinan nilai, lihat State.
primary_impact RECORD Dampak yang dapat ditimbulkan rekomendasi ini saat mencoba mengoptimalkan kategori utama. Berisi kolom berikut:
  • category: Kategori yang coba dioptimalkan oleh rekomendasi ini. Untuk 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 saat kategorinya adalah SECURITY.
priority STRING Prioritas rekomendasi. Untuk daftar kemungkinan nilai, lihat Prioritas.
associated_insight_ids STRING Nama Insight Lengkap yang terkait dengan nama Recommendations.Insight adalah representasi yang dienkode Base64 dari nama jenis Insight & ID Insight. Kolom 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. Kolom 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 diisi.
    • 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. 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 yang berikut:

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

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

Lihat rekomendasi penghematan biaya teratas

Contoh berikut menampilkan 3 rekomendasi kategori COST teratas berdasarkan basis dari 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
+---------------------------------------------------+--------------------------------------------------------------------------------------------------+