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 视图查看建议，您必须拥有相应 Recommender 所需的权限。INFORMATION_SCHEMA.RECOMMENDATIONS_BY_ORGANIZATION 视图仅返回您有权查看的建议。如果您对组织拥有所需的权限，则无论您对项目本身拥有何种权限，都可以查看针对该组织中所有项目的建议。

请让您的管理员授予查看建议的访问权限。如需查看每个 Recommender 所需的权限，请参阅以下内容：

架构

INFORMATION_SCHEMA.RECOMMENDATIONS_BY_ORGANIZATION 视图具有如下架构：

列名 数据类型 值
recommendation_id STRING 包含 RecommendationID 和 Recommender 的 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 格式的建议概览。此字段的内容可能会根据 Recommender 而变化。
  • 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 |
+-------------------------------+----------------------------------------------------------------------+---------------------+--------------------------+---------------------+