INFORMATION_SCHEMA.RECOMMENDATIONS_BY_ORGANIZATION 檢視

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

INFORMATION_SCHEMA.RECOMMENDATIONS_BY_ORGANIZATION 檢視畫面包含目前機構中所有專案的所有 BigQuery 最佳化建議相關資料。

INFORMATION_SCHEMA.RECOMMENDATIONS_BY_ORGANIZATION 檢視畫面支援下列最佳化建議：

只有已定義Google Cloud 機構的使用者，才能使用這個結構定義檢視畫面。

所需權限

如要透過 INFORMATION_SCHEMA.RECOMMENDATIONS_BY_ORGANIZATION 檢視建議，您必須具備對應推薦工具的必要權限。INFORMATION_SCHEMA.RECOMMENDATIONS_BY_ORGANIZATION 檢視畫面只會傳回您有權查看的推薦內容。只要您具備機構的必要權限，無論您對專案本身的權限為何，都可以查看該機構內所有專案的最佳化建議。

請要求管理員授予存取權，以便查看推薦內容。如要查看每個推薦工具的必要權限，請參閱以下內容：

結構定義

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

資料欄名稱 資料類型 值
recommendation_id STRING 包含推薦 ID 和推薦者，並採用 Base64 編碼的 ID。
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_ORGANIZATION] 專案層級 REGION
替換下列內容：
  • 選用：PROJECT_ID： Google Cloud 專案的 ID。如果未指定，系統會使用預設專案。
  • REGION：任一資料集區域名稱。例如：`region-us`。

範例

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

`PROJECT_ID`.`region-REGION_NAME`.INFORMATION_SCHEMA.RECOMMENDATIONS_BY_ORGANIZATION
 取代下列內容：

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

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

查看貴機構的具體化檢視表建議

以下範例會傳回機構中的具體化檢視表建議：

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;

結果大致如下：

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