INFORMATION_SCHEMA.RECOMMENDATIONS ビュー

プレビュー

このプロダクトまたは機能には、サービス固有の利用規約の「一般的なサービス規約」の「pre-GA サービス規約」が適用されます。 一般提供前のプロダクトと機能は「現状のまま」ご利用いただけますが、サポートが制限される場合があります。 詳しくは、リリース ステージの説明をご覧ください。

この機能に関するフィードバックやサポートのリクエストを行う場合は、[e-mail] 宛てにメールを送信してください。

INFORMATION_SCHEMA.RECOMMENDATIONS ビューには、現在のプロジェクト内のすべての BigQuery 推奨事項に関するデータが含まれています。BigQuery は、おすすめハブからすべての BigQuery Recommender の推奨事項を取得し、このビューに表示します。

INFORMATION_SCHEMA.RECOMMENDATIONS ビューでは、次の推奨事項をサポートしています。

• パーティションとクラスタの推奨事項
• マテリアライズド ビューの推奨事項
• BigQuery データセットのロールの推奨事項

INFORMATION_SCHEMA.RECOMMENDATIONS ビューには、BigQuery 関連の推奨事項のみが表示されます。Google Cloud の推奨事項は、おすすめハブで確認できます。

必要な権限

INFORMATION_SCHEMA.RECOMMENDATIONS ビューで推奨事項を表示するには、対応する Recommender に必要な権限を有している必要があります。INFORMATION_SCHEMA.RECOMMENDATIONS ビューは、表示する権限のある推奨事項のみを返します。

推奨事項を表示する権限の付与を管理者に依頼してください。各 Recommender に必要な権限を確認するには、以下をご覧ください。

• パーティションとクラスタの Recommender の権限
• マテリアライズド ビューの推奨事項の権限
• データセットに対するロールの推奨事項に関する権限

スキーマ

INFORMATION_SCHEMA.RECOMMENDATIONS ビューのスキーマは次のとおりです。

列名	データ型	値
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_PROJECT]	プロジェクト レベル	REGION

次のように置き換えます。

• 省略可: PROJECT_ID: Google Cloud プロジェクトの ID。指定しない場合は、デフォルトのプロジェクトが使用されます。

• REGION: 任意のデータセット リージョン名。例: `region-us`

注: INFORMATION_SCHEMA ビューに対してクエリを実行するには、リージョン修飾子を使用する必要があります。クエリ実行のロケーションは、INFORMATION_SCHEMA ビューのリージョンと一致する必要があります。

例

デフォルト プロジェクト以外のプロジェクトに対してクエリを実行するには、次の形式でプロジェクト ID を追加します。

`PROJECT_ID`.`region-REGION_NAME`.INFORMATION_SCHEMA.RECOMMENDATIONS

次のように置き換えます。

• PROJECT_ID: プロジェクトの ID。
• REGION_NAME: プロジェクトのリージョン。

例: `myproject`.`region-us`.INFORMATION_SCHEMA.RECOMMENDATIONS

費用削減の上位の推奨事項を表示する

次の例は、予測される slot_hours_saved_monthly に基づいて、上位 3 つの COST カテゴリの推奨事項を返します。

SELECT 
   recommender,
   target_resources,
   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_PROJECT
WHERE 
   primary_impact.category = 'COST'
AND
   state = 'ACTIVE'
ORDER by 
   slot_hours_saved_monthly DESC 
LIMIT 3;

注: INFORMATION_SCHEMA ビューの名前では大文字と小文字が区別されます。

次のような結果になります。

+---------------------------------------------------+--------------------------------------------------------------------------------------------------+
|                    recommender                    |   target_resources      | est_gb_saved_monthly | slot_hours_saved_monthly |  last_updated_time
+---------------------------------------------------+--------------------------------------------------------------------------------------------------+
| google.bigquery.materializedview.Recommender      | ["project_resource"]    | 140805.38289248943   |        9613.139166666666 |  2024-07-01 13:00:00
| google.bigquery.table.PartitionClusterRecommender | ["table_resource_1"]    | 4393.7416711859405   |        56.61476777777777 |  2024-07-01 13:00:00
| google.bigquery.table.PartitionClusterRecommender | ["table_resource_2"]    |   3934.07264107652   |       10.499466666666667 |  2024-07-01 13:00:00
+---------------------------------------------------+--------------------------------------------------------------------------------------------------+