INFORMATION_SCHEMA.RECOMMENDATIONS 檢視區塊

如要尋求支援或針對這項功能提供意見回饋，請傳送電子郵件至 bq-recommendations+feedback@google.com。

INFORMATION_SCHEMA.RECOMMENDATIONS 檢視畫面包含目前專案中所有 BigQuery 建議的資料。BigQuery 會從 Recommendation Hub 擷取所有 BigQuery 建議工具的建議，並顯示在這個檢視畫面中。

「INFORMATION_SCHEMA.RECOMMENDATIONS」檢視畫面支援下列建議：

INFORMATION_SCHEMA.RECOMMENDATIONS 檢視畫面只會顯示 BigQuery 相關建議。您可以在建議中心查看 Trusted Cloud by S3NS 建議。

必要權限

如要透過 INFORMATION_SCHEMA.RECOMMENDATIONS 檢視畫面查看建議，您必須具備相應建議工具的必要權限。INFORMATION_SCHEMA.RECOMMENDATIONS 檢視畫面只會傳回您有權查看的建議。

請要求管理員授予查看建議的權限。如要查看各項建議的必要權限，請參閱下列文章：

結構定義

INFORMATION_SCHEMA.RECOMMENDATIONS 檢視表具有下列結構定義：

資料欄名稱 資料類型 值
recommendation_id STRING Base64 編碼 ID，內含 RecommendationID 和建議者。
recommender STRING 建議類型。舉例來說，google.bigquery.table.PartitionClusterRecommender 代表分區和分群建議。
subtype STRING 建議的子類型。
project_id STRING 專案 ID。
project_number STRING 專案編號。
description STRING 建議的說明。
last_updated_time TIMESTAMP 這個欄位代表上次建立建議的時間。
target_resources STRING 這項建議的完整資源名稱。
state STRING 建議的狀態。如需可能值的清單，請參閱「狀態」。
primary_impact RECORD 這項建議在最佳化主要類別時可能帶來的影響。包含下列欄位：
  • category：這項建議嘗試最佳化的類別。如需可能值的清單，請參閱「類別」。
  • cost_projection：如果建議可以預估節省的費用，系統可能會填入這個值。只有在類別為「COST」時才會顯示。
  • security_projection：如果類別為 SECURITY，則可能會出現這個欄位。
priority STRING 建議的優先順序。如需可能值的清單，請參閱「優先順序」。
associated_insight_ids STRING 與建議相關聯的完整洞察名稱。洞察名稱是洞察類型名稱和洞察 ID 的 Base64 編碼表示法。可用於查詢洞察檢視畫面。
additional_details RECORD 最佳化建議的其他詳細資料。
  • overview：JSON 格式的建議總覽。這個欄位的內容可能會因推薦者而異。
  • state_metadata：以鍵/值組合形式呈現建議狀態的中繼資料。
  • operations：使用者可對目標資源執行的作業清單。當中包含下列欄位：
    • action：使用者必須執行的動作類型。這是系統在生成建議時設定的任意文字。一律會填入。
    • resource_type：雲端資源類型。
    • resource：完整資源名稱。
    • path：目標欄位相對於資源的路徑。
    • value：路徑欄位的值。

範圍和語法

對這個檢視表執行的查詢必須包含區域限定詞。專案 ID 為選填欄位。如果未指定專案 ID，系統會使用查詢執行的專案。

檢視表名稱 資源範圍 區域範圍
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.RECOMMENDATIONS[_BY_PROJECT] 專案層級 REGION
取代下列項目：
  • 選用：PROJECT_ID：您的 Trusted Cloud 專案 ID。如未指定，系統會使用預設專案。
  • REGION：任何資料集區域名稱。 例如：`region-us`。

範例

如要對預設專案以外的專案執行查詢，請使用以下格式新增專案 ID：

`PROJECT_ID`.`region-REGION_NAME`.INFORMATION_SCHEMA.RECOMMENDATIONS
 取代下列項目：

  • PROJECT_ID：專案的 ID。
  • REGION_NAME：專案的區域。

例如 `myproject`.`region-us`.INFORMATION_SCHEMA.RECOMMENDATIONS。

查看節省費用的熱門建議

以下範例會根據預估的 slot_hours_saved_monthly，傳回前 3 個 COST 類別建議：

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;

結果大致如下：

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