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: レコメンデーションの状態に関するメタデータ(Key-Value ペア)。
  • 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 |
    +-------------------------------+----------------------------------------------------------------------+