Tabel virtual INFORMATION_SCHEMA.RECOMMENDATIONS_BY_ORGANIZATION

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

Tabel virtual INFORMATION_SCHEMA.RECOMMENDATIONS_BY_ORGANIZATION berisi data tentang semua rekomendasi BigQuery untuk semua project di organisasi saat ini.

Tabel virtual INFORMATION_SCHEMA.RECOMMENDATIONS_BY_ORGANIZATION mendukung rekomendasi berikut:

Tabel virtual skema ini hanya tersedia untuk pengguna dengan Google Cloud organisasi yang ditentukan.

Izin yang diperlukan

Untuk melihat rekomendasi dengan tabel virtual INFORMATION_SCHEMA.RECOMMENDATIONS_BY_ORGANIZATION, Anda harus memiliki izin yang diperlukan untuk pemberi rekomendasi yang sesuai. Tabel virtual INFORMATION_SCHEMA.RECOMMENDATIONS_BY_ORGANIZATION hanya menampilkan rekomendasi yang memiliki izin untuk Anda lihat. Jika memiliki izin yang diperlukan di organisasi, Anda dapat melihat rekomendasi untuk semua project dalam organisasi tersebut, terlepas dari izin Anda di project itu sendiri.

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

Skema

Tampilan INFORMATION_SCHEMA.RECOMMENDATIONS_BY_ORGANIZATION 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 clustering.
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 yang dapat ditimbulkan oleh 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 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 yang dienkode Base64 dari nama jenis Insight &ID Insight. Hal 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. Tindakan 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.

Untuk stabilitas, sebaiknya cantumkan kolom secara eksplisit dalam kueri skema informasi, bukan menggunakan karakter pengganti (SELECT *). Mencantumkan kolom secara eksplisit mencegah kueri rusak 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.RECOMMENDATIONS[_BY_ORGANIZATION] Level project REGION
Ganti kode berikut:
  • Opsional: PROJECT_ID: ID project Anda. Google Cloud 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_BY_ORGANIZATION
 Ganti kode berikut:

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

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

Melihat rekomendasi tampilan terwujud di organisasi

Contoh berikut menampilkan rekomendasi tampilan terwujud di organisasi:

SELECT
  project_id,
  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_ORGANIZATION
WHERE
  recommender = 'google.bigquery.materializedview.Recommender'
LIMIT 3;

Hasilnya mirip dengan berikut ini:

+-------------------------------+----------------------------------------------------------------------+
|          project_id           | est_gb_saved_monthly| slot_hours_saved_monthly |  last_updated_time  |
+-------------------------------+----------------------------------------------------------------------+
| project1                      |   4689.071544663957 |       2682.1816833333337 | 2024-07-01 13:00:31 |
| project2                      |   137.5052567309467 |        9613.139166666666 | 2024-07-01 13:00:31 |
| project3                      |  146.83722260318973 |        7093.014316666667 | 2024-07-01 13:00:31 |
+-------------------------------+----------------------------------------------------------------------+