インデックスに関する推奨事項を使用する

Azure portal を使用して以下を実行します。

1. お使いの Azure Database for PostgreSQL フレキシブル サーバーを選択します。

2. リソース メニューの [ インテリジェント パフォーマンス] で、[ インデックスのチューニング] を選択します。

   • この機能が有効になっていても、レコメンデーションがまだ生成されていない場合、画面は次のようになります。

     

   • この機能が無効になっており、過去に推奨事項が生成されたことがない場合、画面は次のようになります。

     

   • 機能が無効になっていても、推奨事項が生成される前に有効になっていた場合、画面は次のようになります。

     

3. 使用可能なレコメンデーションがある場合は、[インデックスのレコメンデーション表示] の要約を選択して、完全な一覧にアクセスします。

   

4. この一覧には、使用可能なすべてのレコメンデーションと、それぞれの詳細が表示されます。 既定では、一覧は [最終レコメンデーション] (降順) で並べ替えられます。一番上に最新のレコメンデーションが表示されます。 ただし、他の列で並べ替え、フィルター ボックスを使用して表示される項目の一覧を減らすことができます。 フィルター処理された項目は、データベース、スキーマ、またはテーブル名に指定されたテキストが含まれている項目です。

   

5. 特定のレコメンデーションに関する詳細情報を表示するには、そのレコメンデーションの名前を選択すると、画面の右側に [インデックスのレコメンデーションの詳細] ウィンドウが開き、そのレコメンデーションに関して使用可能なすべての詳細が表示されます。

   

az postgres flexible-server index-tuning list-recommendations コマンドを使用して、既存のサーバーでインデックスチューニングによって生成されるインデックス調整の推奨事項を一覧表示できます。

すべての CREATE INDEX の推奨事項を一覧表示するには、次のコマンドを使用します。

az postgres flexible-server index-tuning list-recommendations \
  --resource-group <resource_group> \
  --server-name <server> \
  --recommendation-type createindex

このコマンドは、インデックスのチューニングによって生成された CREATE INDEX の推奨事項に関するすべての情報を返します。次のような出力が表示されます。

[
  {
    "analyzedWorkload": {
      "endTime": "2025-02-26T14:40:18.788628+00:00",
      "queryCount": 18,
      "startTime": "2025-02-26T13:40:18.788628+00:00"
    },
    "details": {
      "databaseName": "<database>",
      "includedColumns": "",
      "indexColumns": "\"<table>\".\"<column>\"",
      "indexName": "<index>",
      "indexType": "BTREE",
      "schema": "<schema>",
      "table": "<table>"
    },
    "estimatedImpact": [
      {
        "absoluteValue": 0.3984375,
        "dimensionName": "IndexSize",
        "queryId": null,
        "unit": "MB"
      },
      {
        "absoluteValue": 62.86969111969111,
        "dimensionName": "QueryCostImprovement",
        "queryId": -555955670159268890,
        "unit": "Percentage"
      }
    ],
    "id": "/subscriptions/<subscription_id>/resourceGroups/<resource_group>/providers/Microsoft.DBforPostgreSQL/flexibleServers/<server>/tuningOptions/index/recommendations/<recommendation_id>",
    "implementationDetails": {
      "method": "SQL",
      "script": "create index concurrently <index> on <schema>.<table>(<column>)"
    },
    "improvedQueryIds": [
      -555955670159268890
    ],
    "initialRecommendedTime": "2025-02-26T14:40:19.707617+00:00",
    "kind": "",
    "lastRecommendedTime": "2025-02-26T14:40:19.707617+00:00",
    "name": "CreateIndex_<database>_<schema>_<column>_idx",
    "recommendationReason": "Column \"<table>\".\"<column>\" appear in Equal Predicate clause(s) in query -555955670159268890;",
    "recommendationType": "CreateIndex",
    "resourceGroup": "<resource_group>",
    "systemData": null,
    "timesRecommended": 1,
    "type": "Microsoft.DBforPostgreSQL/flexibleServers/tuningOptions/index"
  },
  {
    .
    .
    .
  }
]

DROP INDEX のすべての推奨事項を一覧表示するには、次のコマンドを使用します。

az postgres flexible-server index-tuning list-recommendations \
  --resource-group <resource_group> \
  --server-name <server> \
  --recommendation-type dropindex

このコマンドは、インデックスのチューニングによって生成された DROP INDEX の推奨事項に関するすべての情報を返します。次のような出力が表示されます。

[
  {
    "analyzedWorkload": {
      "endTime": "2025-02-26T19:02:47.522193+00:00",
      "queryCount": 0,
      "startTime": "2025-01-22T19:02:47.522193+00:00"
    },
    "details": {
      "databaseName": "<database>",
      "includedColumns": "",
      "indexColumns": "<column>",
      "indexName": "<index>",
      "indexType": "BTREE",
      "schema": "<schema>",
      "table": "<table>"
    },
    "estimatedImpact": [
      {
        "absoluteValue": 35.0,
        "dimensionName": "Benefit",
        "queryId": null,
        "unit": "Percentage"
      },
      {
        "absoluteValue": 31.28125,
        "dimensionName": "IndexSize",
        "queryId": null,
        "unit": "MB"
      }
    ],
    "id": "/subscriptions/<subscription_id>/resourceGroups/<resource_group>/providers/Microsoft.DBforPostgreSQL/flexibleServers/<server>/tuningOptions/index/recommendations/<recommendation_id>",
    "implementationDetails": {
      "method": "SQL",
      "script": "drop index concurrently \"<schema>\".\"<index>\";"
    },
    "improvedQueryIds": null,
    "initialRecommendedTime": "2025-02-26T19:02:47.556792+00:00",
    "kind": "",
    "lastRecommendedTime": "2025-02-26T19:02:47.556792+00:00",
    "name": "DropIndex_<database>_<sechema>_<index>",
    "recommendationReason": "Duplicate of \"<index>\". The equivalent index \"<index>\" has a shorter length compared to \"<index>\".",
    "recommendationType": "DropIndex",
    "resourceGroup": "<resource_group>",
    "systemData": null,
    "timesRecommended": 1,
    "type": "Microsoft.DBforPostgreSQL/flexibleServers/tuningOptions/index"
  }
]

任意の PostgreSQL クライアント ツールを使用する。

1. インスタンスに接続するためのアクセス許可を持つ任意のロールを使用して、サーバーで使用可能な azure_sys データベースに接続します。 public ロールのメンバーは、これらのビューから読み取ることができます。

2. sessions ビューでクエリを実行して、レコメンデーション セッションに関する詳細を取得します。

3. CREATE INDEX と DROP INDEX のインデックス チューニングによって生成されたレコメンデーションを取得するには、recommendations ビューに対してクエリを実行します。

ビュー

azure_sys データベース内のビューは、インデックスのチューニングによって生成されたインデックスのレコメンデーションにアクセスして取得する便利な方法を提供します。 具体的には、createindexrecommendations および dropindexrecommendations ビューにはそれぞれ、CREATE INDEX と DROP INDEX のレコメンデーションに関する詳細情報が含まれています。 これらのビューでは、セッション ID、データベース名、アドバイザーの種類、チューニング セッションの開始時刻と停止時間、レコメンデーション ID、レコメンデーションの種類、レコメンデーションの理由、その他の関連する詳細などのデータが公開されます。 ユーザーは、これらのビューに対してクエリを実行して、インデックスのチューニングによって生成されたインデックスの推奨事項に簡単にアクセスして分析できます。

インテリジェントパフォーマンスセッションズ

sessions ビューには、すべてのインデックス チューニング セッションのすべての詳細が公開されます。

インテリジェントパフォーマンスの推奨事項

recommendations ビューでは、基になるテーブルにまだデータが残されているチューニング セッションで生成されたすべてのレコメンデーションの詳細をすべて公開します。

インデックスの作成が推奨される理由

インデックス チューニングによって、インデックスを作成するよう推奨される場合、少なくとも次の理由のうち 1 つが追加されます。

インデックスの削除が推奨される理由

インデックス チューニングで無効とマークされたインデックスが特定された場合、次の理由で削除することが提案されます。

The index is invalid and the recommended recovery method is to reindex.

インデックスが無効とマークされる理由とタイミングの詳細については、PostgreSQL 公式ドキュメントの「REINDEX」を参照してください。

インデックスの削除が推奨される理由

インデックス チューニングで、index_tuning.unused_min_period で設定した日数以上使用されていないインデックスが検出されると、次の理由で削除することが提案されます。

The index is unused in the past <days_unused> days.

インデックス チューニングで重複するインデックスが検出された場合、どちらか一方が残され、もう一方は削除することが提案されます。 提供される理由は、常に次の文言で始まります。

Duplicate of <surviving_duplicate>.

その後に、各重複がドロップ対象として選択された理由を説明する別のテキストが続きます。

インデックスが重複により削除対象となっているだけでなく、少なくとも index_tuning.unused_min_period で定められた日数にわたって使用されていない場合、理由に次の文言が追加されます。

Also, the index is unused in the past <days_unused> days.

Azure portal を使用して以下を実行します。

1. お使いの Azure Database for PostgreSQL フレキシブル サーバーを選択します。

2. リソース メニューの [ インテリジェント パフォーマンス] で、[ インデックスのチューニング] を選択します。

   

3. インデックスのチューニングによって推奨事項が生成された場合は、[ インデックスの推奨事項 の概要を表示] を選択して、使用可能な推奨事項の一覧にアクセスします。

   

4. レコメンデーションの一覧から、次のいずれかを行います。

   • SQL ステートメントを取得するレコメンデーションの右側にある省略記号を選択し、[SQL スクリプトのコピー] を選択します。

     

   • または、レコメンデーションの名前を選択してインデックスのレコメンデーションの詳細を表示し、[SQL スクリプト] テキスト ボックスでクリップボードへのコピー アイコンを選択して SQL ステートメントをコピーします。

     

az postgres flexible-server index-tuning list-recommendations コマンドを使用して、既存のサーバーでインデックスチューニングによって生成されるインデックス調整の推奨事項を一覧表示できます。

すべての CREATE INDEX の推奨事項を一覧表示するには、次のコマンドを使用します。

az postgres flexible-server index-tuning list-recommendations \
  --resource-group <resource_group> \
  --server-name <server> \
  --query [].implementationDetails.script

このコマンドは、生成されたすべての推奨事項を実装するために実行する必要があるすべてのステートメントを返します。次のような出力が表示されます。

[
  "create index concurrently <column>_idx on <schema>.<table>(<column>)",
  "drop index concurrently \"<schema>\".\"<index>\";"
]