INFORMATION_SCHEMA.RECOMMENDATIONS_BY_ORGANIZATION 檢視畫面

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

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

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

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

所需權限

如要透過 INFORMATION_SCHEMA.RECOMMENDATIONS_BY_ORGANIZATION 檢視建議，您必須具備相應建議工具的必要權限。INFORMATION_SCHEMA.RECOMMENDATIONS_BY_ORGANIZATION檢視畫面只會傳回您有權查看的建議。只要您在機構中擁有必要權限，就能查看該機構內所有專案的建議，不必具備專案本身的權限。

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

結構定義

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

資料欄名稱 資料類型 值
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_ORGANIZATION] 專案層級 REGION
取代下列項目：
  • 選用：PROJECT_ID：您的 Trusted 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。

在機構中查看具體化檢視表建議

以下範例會傳回機構中的 materialized view 建議：

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