INFORMATION_SCHEMA.INSIGHTS 檢視畫面

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

INFORMATION_SCHEMA.INSIGHTS 檢視畫面會顯示目前專案中所有 BigQuery 建議的深入分析結果。BigQuery 會從建議中心擷取所有 BigQuery 洞察類型，並顯示在這個檢視畫面中。BigQuery 洞察資料一律會與建議相關聯。

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

必要權限

如要使用 INFORMATION_SCHEMA.INSIGHTS 檢視深入分析，您必須具備相應建議工具的必要權限。INFORMATION_SCHEMA.INSIGHTS檢視畫面只會傳回您有權查看的建議洞察資料。

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

結構定義

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

資料欄名稱 資料類型 值
insight_id STRING 採用 Base64 編碼的 ID，內含洞察類型和洞察 ID
insight_type STRING 洞察類型。例如 google.bigquery.materializedview.Insight。
subtype STRING 深入分析的子類型。
project_id STRING 專案 ID。
project_number STRING 專案編號。
description STRING 建議的說明。
last_updated_time TIMESTAMP 這個欄位代表洞察資料上次更新的時間。
category STRING 影響的最佳化類別。
target_resources STRING 這項洞察資訊的完整資源名稱。
state STRING 洞察的狀態。如需可能值的清單，請參閱「值」。
severity STRING 洞察的嚴重程度。如需可能值的清單，請參閱「嚴重程度」。
associated_recommendation_ids STRING 與這項洞察資料相關聯的完整建議名稱。建議名稱是以 Base64 編碼表示的推薦工具類型和建議 ID。
additional_details RECORD 深入分析的額外詳細資料。
  • content：JSON 格式的洞察內容。
  • state_metadata：洞察狀態相關中繼資料。包含鍵/值組合。
  • observation_period_seconds：產生洞察資料的觀察期。

範圍和語法

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

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

範例

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

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

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

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

查看可節省費用的有效洞察

以下範例會將洞察資料檢視畫面與建議檢視畫面聯結，針對「費用」類別中處於「有效」狀態的洞察資料，傳回 3 項建議：

WITH 
 insights as (SELECT * FROM `region-us`.INFORMATION_SCHEMA.INSIGHTS),
 recs as (SELECT recommender, recommendation_id, additional_details FROM `region-us`.INFORMATION_SCHEMA.RECOMMENDATIONS)

SELECT  
   recommender,
   target_resources,
   LAX_INT64(recs.additional_details.overview.bytesSavedMonthly) / POW(1024, 3) as est_gb_saved_monthly,
   LAX_INT64(recs.additional_details.overview.slotMsSavedMonthly) / (1000 * 3600) as slot_hours_saved_monthly,
   insights.additional_details.observation_period_seconds / 86400 as observation_period_days,
   last_updated_time
FROM 
  insights 
JOIN recs 
ON 
  recommendation_id in UNNEST(associated_recommendation_ids) 
WHERE 
  state = 'ACTIVE' 
AND
  category = 'COST'
LIMIT 3;

結果大致如下：

+---------------------------------------------------+---------------------+--------------------+--------------------------+-------------------------+---------------------+
|                    recommender                    |   target_resource   |  gb_saved_monthly  | slot_hours_saved_monthly | observation_period_days |  last_updated_time  |
+---------------------------------------------------+---------------------+--------------------+--------------------------+-------------------------+---------------------+
| google.bigquery.table.PartitionClusterRecommender | ["table_resource1"] |   3934.07264107652 |       10.499466666666667 |                    30.0 | 2024-07-01 16:41:25 |
| google.bigquery.table.PartitionClusterRecommender | ["table_resource2"] | 4393.7416711859405 |        56.61476777777777 |                    30.0 | 2024-07-01 16:41:25 |
| google.bigquery.materializedview.Recommender      | ["project_resource"]| 140805.38289248943 |        9613.139166666666 |                     2.0 | 2024-07-01 13:00:31 |
+---------------------------------------------------+---------------------+--------------------+--------------------------+-------------------------+---------------------+