インデックスの作成または結合設定の再構成

このページでは、インスタンスの結合バッファ内の、インデックスを使用しない結合の数を管理する方法について説明します。この Recommender は、インデックスの作成または結合設定の再構成と呼ばれます。

この Recommender によって、結合バッファ内のインデックスを使用しない結合の数が毎日監視されます。結合バッファは接続ごとのメモリバッファであり、インデックスを使用できない結合オペレーション中にデータを格納するために使用されます。インデックスを使用しない結合の総数が 1 時間あたり 500 を超える場合は、インデックスを作成するか join_buffer_size の値を大きくすることが推奨されます。

join_buffer_size の値を大きくすることについて詳しくは、その他のメモリ使用量をご覧ください。

料金

インデックスの作成または結合設定の再構成の Recommender は、標準の Recommender の料金ティアに含まれています。

始める前に

Recommender API を有効にします。

必要なロールと権限

分析情報と推奨事項を表示して操作するための権限を取得するには、必要な Identity and Access Management（IAM）ロールが付与されていることを確認してください。

タスク ロール
推奨事項を表示する recommender.cloudsqlViewer または cloudsql.admin
推奨事項を適用する cloudsql.editor または cloudsql.admin
IAM ロールの詳細については、IAM の基本ロールと事前定義ロールのリファレンスとプロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。

推奨事項を一覧表示する

推奨事項を一覧表示する手順は次のとおりです。

コンソール

インスタンスのパフォーマンスに関する推奨事項を一覧表示する手順は次のとおりです。

  1. Cloud SQL の [インスタンス] ページに移動します。

Cloud SQL の [インスタンス] に移動

  1. [問題を調査し、推奨事項に従い対策を行うことで、インスタンスの健全性を向上させます] バナーで、[詳細を表示] をクリックします。

別の手順は次のとおりです。

  1. [おすすめハブ] に移動します。おすすめハブで推奨事項を探して適用するもご覧ください。

    おすすめハブに移動

  2. [すべての推奨事項] カードで [パフォーマンス] をクリックします。

gcloud

次のように gcloud recommender recommendations list コマンドを実行します。

gcloud recommender recommendations list \
--project=PROJECT_ID \
--location=LOCATION \
--recommender=google.cloudsql.instance.PerformanceRecommender \
--filter=recommenderSubtype=MYSQL_CREATE_INDEX_OR_RECONFIG_JOIN_BUFFER

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

  • PROJECT_ID: プロジェクト ID
  • LOCATION: インスタンスが配置されているリージョン（たとえば us-central1）

API

次のように recommendations.list メソッドを呼び出します。

GET https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/recommenders/google.cloudsql.instance.PerformanceRecommender/recommendations

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

  • PROJECT_ID: プロジェクト ID
  • LOCATION: インスタンスが配置されているリージョン（たとえば us-central1）

分析情報と詳細な推奨事項を表示する

分析情報と詳細な推奨事項を表示する手順は次のとおりです。

コンソール

次のいずれかを行います。

  • [パフォーマンスに関する推奨事項] ページで、[パフォーマンスに関する推奨事項] カードをクリックし、[インデックスの作成または結合設定の再構成] をクリックします。推奨事項のパネルが表示されます。このパネルには、インスタンスの分析情報と詳細な推奨事項が含まれています。

  • [インスタンス] ページで、[インデックスの作成または結合設定の再構成] をクリックします。インスタンスのリストには、推奨事項が適用されるインスタンスのみが表示されます。

gcloud

次のように gcloud recommender insights list コマンドを実行します。


gcloud recommender insights list \
--project=PROJECT_ID \
--location=LOCATION \
--insight-type=google.cloudsql.instance.PerformanceInsight \
--filter=insightSubtype=MYSQL_HIGH_JOINS_WITHOUT_INDEXES

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

  • PROJECT_ID: プロジェクト ID
  • LOCATION: インスタンスが配置されているリージョン（たとえば us-central1）

API

次のように insights.list メソッドを呼び出します。


GET https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/insightTypes/google.cloudsql.instance.PerformanceInsight/insights

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

  • PROJECT_ID: プロジェクト ID
  • LOCATION: インスタンスが配置されているリージョン（たとえば us-central1）

推奨事項を適用する

この推奨事項を実装する手順は次のとおりです。

  • インデックスを使用しない結合が大量に発生するのを防ぐために、適切なインデックスをインスタンス内で作成します。

  • 結合のためのインデックスを作成できない場合は、推奨事項が表示されなくなるまで join_buffer_size の値を大きくします。結合バッファは、セッション単位またはグローバルで増大できます。結合が多いセッションでは、結合バッファを増大することをおすすめします。

    join_buffer_size の値を大きくすることについて詳しくは、その他のメモリ使用量をご覧ください。

次のステップ