インデックスのチューニングを構成する

インデックス チューニングは、チューニング セッションを実行できる頻度など、その動作を制御する一連のパラメーターを使って有効化、無効化、構成できます。

インデックス チューニングは、クエリ ストアに依存します。 パフォーマンスへの影響があるため、Burstable 価格レベルでクエリ ストアを有効にすることはお勧めしません。 同じ理由から、バースト可能レベルのコンピューティングを使用するサーバーでは、インデックスのチューニングは推奨されません。

インデックス チューニングはオプトイン機能であるため、既定ではサーバー上で有効になっていません。 これは特定のサーバー上のすべてのデータベースに対してグローバルに有効または無効にでき、データベースごとにオンまたはオフにすることはできません。

インデックスのチューニングを有効にする手順

Note

インデックスのチューニングは、Azure Database for PostgreSQL バージョン 18 ではサポートされていないクエリ ストアに依存します。

ポータル

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

1. Azure Database for PostgreSQL フレキシブル サーバー インスタンスを選択します。

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

   

3. pg_qs.query_capture_mode が NONE に設定されているか、index_tuning.mode が OFF に設定されている場合、[インデックス チューニング] ページに、インデックス チューニングを有効にするオプションが表示されます。 2 つの [インデックス チューニングを有効にする] ボタンのいずれかを選択して、インデックス チューニング機能とそれに必要なクエリ ストアの依存関係 (クエリ ストアが無効になっている場合) を有効にします。

   

4. デプロイが正常に完了するまで待ってから、機能が有効になっていることを検討してください。

   

5. インデックス チューニングを有効にした後、最終的にインデックスの作成または削除のレコメンデーションが生成されるまで 12 時間かかると見ておいてください。その期間中にクエリ ストアによって収集されたワークロードがインデックス チューニング エンジンで分析されます。

重要

[インデックス チューニングを有効にする] ボタンを使用してインデックス チューニングを有効にした場合、pg_qs.query_capture_mode が NONE に設定されているときは、ALL に変更されます。 既に TOP または ALL に設定されていた場合は、現在の状態のままになります。

CLI

az postgres flexible-server index-tuning update コマンドを使用して、既存のサーバーでインデックスのチューニングを有効にすることができます。

インデックスのチューニングを有効にするには、次のコマンドを使用します。

az postgres flexible-server index-tuning update \
  --resource-group <resource_group> \
  --server-name <server> \
  --enabled true

前のコマンドが正常に実行されると、次の出力が表示されます。

WARNING: Enabling index tuning for the server.
WARNING: Index tuning is enabled for the server.

インデックスのチューニングを無効にする手順

ポータル

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

1. Azure Database for PostgreSQL フレキシブル サーバー インスタンスを選択します。

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

   

3. [ インデックスのチューニングを無効にする ] を選択して、この機能を無効にします。

   

4. デプロイが正常に完了するまで待ってから、機能が無効になっていることを検討してください。

   

5. クエリ ストアでパフォーマンスの監視を引き続き使用してワークロードのパフォーマンスを監視し、有効のままにするか、無効にする場合は、pg_qs.query_capture_modeをNONEに設定して評価します。

重要

[インデックスのチューニングを無効にする] ボタンを使用して インデックスのチューニングを無効 にすると、サーバー パラメーター pg_qs.query_capture_mode は NONEに設定されず、構成時に残ります。

CLI

az postgres flexible-server index-tuning update コマンドを使用して、既存のサーバーでインデックスのチューニングを無効にすることができます。

インデックスのチューニングを無効にするには、次のコマンドを使用します。

az postgres flexible-server index-tuning update \
  --resource-group <resource_group> \
  --server-name <server> \
  --enabled false

前のコマンドが正常に実行されると、次の出力が表示されます。

WARNING: Disabling index tuning for the server.
WARNING: Index tuning is disabled for the server.

クエリ ストアでパフォーマンスの監視を引き続き使用してワークロードのパフォーマンスを監視し、有効のままにするか、無効にする場合は、pg_qs.query_capture_modeをNONEに設定して評価します。

重要

CLI コマンドを使用してインデックスのチューニングを無効にすると、サーバー パラメーター pg_qs.query_capture_mode は NONE に設定されず、構成された状態のままです。

インデックスチューニングの状態を表示する手順

ポータル

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

1. Azure Database for PostgreSQL フレキシブル サーバー インスタンスを選択します。

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

   

3. インデックスのチューニングが有効になっている場合、ページに [インデックスのチューニングを無効にする ] ボタンが表示されます。

   

4. インデックスのチューニングが無効になっている場合、ページに [インデックスのチューニングを有効にする] ボタンが表示されます。

   

CLI

az postgres flexible-server index-tuning show コマンドを使用して、既存のサーバーでインデックスチューニングの状態を表示できます。

インデックスのチューニングを無効にするには、次のコマンドを使用します。

az postgres flexible-server index-tuning show \
  --resource-group <resource_group> \
  --server-name <server>

インデックスのチューニングが有効になっている場合は、次の出力が表示されます。

WARNING: Index tuning is enabled for the server.

インデックスのチューニングが無効になっている場合は、次の出力が表示されます。

WARNING: Index tuning is disabled for the server.

インデックスのチューニング設定を一覧表示する手順

ポータル

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

1. Azure Database for PostgreSQL フレキシブル サーバー インスタンスを選択します。

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

   

3. [ チューニング設定] を選択します。

   

CLI

az postgres flexible-server index-tuning show-settings コマンドを使用して、既存のサーバーで 1 つのインデックスチューニング設定の値を表示できます。

たとえば、 analyze_intervalと呼ばれるインデックス チューニング設定の値を表示するには、次のコマンドを使用します。

az postgres flexible-server index-tuning show-settings \
  --resource-group <resource_group> \
  --server-name <server> \
  --name analyze_interval

このコマンドは、インデックス チューニングの設定に対応するサーバー パラメーターに関するすべての情報を返します。出力は次のようになります。

{
  "allowedValues": "60-10080",
  "dataType": "Integer",
  "defaultValue": "720",
  "description": "Sets the frequency at which each index optimization session is triggered when index_tuning.mode is set to 'REPORT'.",
  "documentationLink": "https://go.microsoft.com/fwlink/?linkid=2274149",
    "id": "/subscriptions/<subscription_id>/resourceGroups/<resource_group>/providers/Microsoft.DBforPostgreSQL/flexibleServers/<server>/configurations/index_tuning.analysis_interval",
  "isConfigPendingRestart": false,
  "isDynamicConfig": true,
  "isReadOnly": false,
  "name": "index_tuning.analysis_interval",
  "resourceGroup": "<resource_group>",
  "source": "user-override",
  "systemData": null,
  "type": "Microsoft.DBforPostgreSQL/flexibleServers/configurations",
  "unit": "minutes",
  "value": "720"
}

また、 az postgres flexible-server index-tuning list-settings コマンドを使用して、既存のサーバーのすべてのインデックス チューニング設定の一覧を 表示することもできます。

すべてのインデックス チューニング設定を一覧表示するには、次のコマンドを使用します。

az postgres flexible-server index-tuning list-settings \
  --resource-group <resource_group> \
  --server-name <server>

このコマンドは、インデックスチューニングのさまざまな設定を制御するすべてのサーバー パラメーターを返します。出力は次のようになります。

[
  {
    "allowedValues": "60-10080",
    "dataType": "Integer",
    "defaultValue": "720",
    "description": "Sets the frequency at which each index optimization session is triggered when index_tuning.mode is set to 'REPORT'.",
    "documentationLink": "https://go.microsoft.com/fwlink/?linkid=2274149",
    "id": "/subscriptions/<subscription_id>/resourceGroups/<resource_group>/providers/Microsoft.DBforPostgreSQL/flexibleServers/<server>/configurations/index_tuning.analysis_interval",
    "isConfigPendingRestart": false,
    "isDynamicConfig": true,
    "isReadOnly": false,
    "name": "index_tuning.analysis_interval",
    "resourceGroup": "<resource_group>",
    "source": "user-override",
    "systemData": null,
    "type": "Microsoft.DBforPostgreSQL/flexibleServers/configurations",
    "unit": "minutes",
    "value": "720"
  },
  {
    "allowedValues": "1-10",
    "dataType": "Integer",
    "defaultValue": "2",
    "description": "Maximum number of columns that can be part of the index key for any recommended index.",
    "documentationLink": "https://go.microsoft.com/fwlink/?linkid=2274149",
    "id": "/subscriptions/<subscription_id>/resourceGroups/<resource_group>/providers/Microsoft.DBforPostgreSQL/flexibleServers/<server>/configurations/index_tuning.max_columns_per_index",
    "isConfigPendingRestart": false,
    "isDynamicConfig": true,
    "isReadOnly": false,
    "name": "index_tuning.max_columns_per_index",
    "resourceGroup": "<resource_group>",
    "source": "system-default",
    "systemData": null,
    "type": "Microsoft.DBforPostgreSQL/flexibleServers/configurations",
    "unit": null,
    "value": "2"
  },
  {
    "allowedValues": "1-25",
    "dataType": "Integer",
    "defaultValue": "10",
    "description": "Maximum number of indexes that can be recommended for each database during one optimization session.",
    "documentationLink": "https://go.microsoft.com/fwlink/?linkid=2274149",
    "id": "/subscriptions/<subscription_id>/resourceGroups/<resource_group>/providers/Microsoft.DBforPostgreSQL/flexibleServers/<server>/configurations/index_tuning.max_index_count",
    "isConfigPendingRestart": false,
    "isDynamicConfig": true,
    "isReadOnly": false,
    "name": "index_tuning.max_index_count",
    "resourceGroup": "<resource_group>",
    "source": "system-default",
    "systemData": null,
    "type": "Microsoft.DBforPostgreSQL/flexibleServers/configurations",
    "unit": null,
    "value": "10"
  },
  {
    "allowedValues": "1-25",
    "dataType": "Integer",
    "defaultValue": "10",
    "description": "Maximum number of indexes that can be recommended for each table.",
    "documentationLink": "https://go.microsoft.com/fwlink/?linkid=2274149",
    "id": "/subscriptions/<subscription_id>/resourceGroups/<resource_group>/providers/Microsoft.DBforPostgreSQL/flexibleServers/<server>/configurations/index_tuning.max_indexes_per_table",
    "isConfigPendingRestart": false,
    "isDynamicConfig": true,
    "isReadOnly": false,
    "name": "index_tuning.max_indexes_per_table",
    "resourceGroup": "<resource_group>",
    "source": "system-default",
    "systemData": null,
    "type": "Microsoft.DBforPostgreSQL/flexibleServers/configurations",
    "unit": null,
    "value": "10"
  },
  {
    "allowedValues": "5-100",
    "dataType": "Integer",
    "defaultValue": "25",
    "description": "Number of slowest queries per database for which indexes can be recommended.",
    "documentationLink": "https://go.microsoft.com/fwlink/?linkid=2274149",
    "id": "/subscriptions/<subscription_id>/resourceGroups/<resource_group>/providers/Microsoft.DBforPostgreSQL/flexibleServers/<server>/configurations/index_tuning.max_queries_per_database",
    "isConfigPendingRestart": false,
    "isDynamicConfig": true,
    "isReadOnly": false,
    "name": "index_tuning.max_queries_per_database",
    "resourceGroup": "<resource_group>",
    "source": "system-default",
    "systemData": null,
    "type": "Microsoft.DBforPostgreSQL/flexibleServers/configurations",
    "unit": null,
    "value": "25"
  },
  {
    "allowedValues": "0.05-0.2",
    "dataType": "Numeric",
    "defaultValue": "0.1",
    "description": "Acceptable regression introduced by a recommended index on any of the queries analyzed during one optimization session.",
    "documentationLink": "https://go.microsoft.com/fwlink/?linkid=2274149",
    "id": "/subscriptions/<subscription_id>/resourceGroups/<resource_group>/providers/Microsoft.DBforPostgreSQL/flexibleServers/<server>/configurations/index_tuning.max_regression_factor",
    "isConfigPendingRestart": false,
    "isDynamicConfig": true,
    "isReadOnly": false,
    "name": "index_tuning.max_regression_factor",
    "resourceGroup": "<resource_group>",
    "source": "system-default",
    "systemData": null,
    "type": "Microsoft.DBforPostgreSQL/flexibleServers/configurations",
    "unit": "percentage",
    "value": "0.1"
  },
  {
    "allowedValues": "0-1.0",
    "dataType": "Numeric",
    "defaultValue": "0.1",
    "description": "Maximum total size, in percentage of total disk space, that all recommended indexes for any given database can use.",
    "documentationLink": "https://go.microsoft.com/fwlink/?linkid=2274149",
    "id": "/subscriptions/<subscription_id>/resourceGroups/<resource_group>/providers/Microsoft.DBforPostgreSQL/flexibleServers/<server>/configurations/index_tuning.max_total_size_factor",
    "isConfigPendingRestart": false,
    "isDynamicConfig": true,
    "isReadOnly": false,
    "name": "index_tuning.max_total_size_factor",
    "resourceGroup": "<resource_group>",
    "source": "system-default",
    "systemData": null,
    "type": "Microsoft.DBforPostgreSQL/flexibleServers/configurations",
    "unit": "percentage",
    "value": "0.1"
  },
  {
    "allowedValues": "0-20.0",
    "dataType": "Numeric",
    "defaultValue": "0.2",
    "description": "Cost improvement that a recommended index must provide to at least one of the queries analyzed during one optimization session.",
    "documentationLink": "https://go.microsoft.com/fwlink/?linkid=2274149",
    "id": "/subscriptions/<subscription_id>/resourceGroups/<resource_group>/providers/Microsoft.DBforPostgreSQL/flexibleServers/<server>/configurations/index_tuning.min_improvement_factor",
    "isConfigPendingRestart": false,
    "isDynamicConfig": true,
    "isReadOnly": false,
    "name": "index_tuning.min_improvement_factor",
    "resourceGroup": "<resource_group>",
    "source": "system-default",
    "systemData": null,
    "type": "Microsoft.DBforPostgreSQL/flexibleServers/configurations",
    "unit": "percentage",
    "value": "0.2"
  },
  {
    "allowedValues": "off,report",
    "dataType": "Enumeration",
    "defaultValue": "off",
    "description": "Configures index optimization as disabled ('OFF') or enabled to only emit recommendation. Requires Query Store to be enabled by setting pg_qs.query_capture_mode to 'TOP' or 'ALL'.",
    "documentationLink": "https://go.microsoft.com/fwlink/?linkid=2274149",
    "id": "/subscriptions/<subscription_id>/resourceGroups/<resource_group>/providers/Microsoft.DBforPostgreSQL/flexibleServers/<server>/configurations/index_tuning.mode",
    "isConfigPendingRestart": false,
    "isDynamicConfig": true,
    "isReadOnly": false,
    "name": "index_tuning.mode",
    "resourceGroup": "<resource_group>",
    "source": "user-override",
    "systemData": null,
    "type": "Microsoft.DBforPostgreSQL/flexibleServers/configurations",
    "unit": null,
    "value": "off"
  },
  {
    "allowedValues": "0-9999999",
    "dataType": "Integer",
    "defaultValue": "1000",
    "description": "Minimum number of daily average DML operations affecting the table, so that their unused indexes are considered for dropping.",
    "documentationLink": "https://go.microsoft.com/fwlink/?linkid=2274149",
    "id": "/subscriptions/<subscription_id>/resourceGroups/<resource_group>/providers/Microsoft.DBforPostgreSQL/flexibleServers/<server>/configurations/index_tuning.unused_dml_per_table",
    "isConfigPendingRestart": false,
    "isDynamicConfig": true,
    "isReadOnly": false,
    "name": "index_tuning.unused_dml_per_table",
    "resourceGroup": "<resource_group>",
    "source": "system-default",
    "systemData": null,
    "type": "Microsoft.DBforPostgreSQL/flexibleServers/configurations",
    "unit": null,
    "value": "1000"
  },
  {
    "allowedValues": "30-720",
    "dataType": "Integer",
    "defaultValue": "35",
    "description": "Minimum number of days the index has not been used, based on system statistics, so that it is considered for dropping.",
    "documentationLink": "https://go.microsoft.com/fwlink/?linkid=2274149",
    "id": "/subscriptions/<subscription_id>/resourceGroups/<resource_group>/providers/Microsoft.DBforPostgreSQL/flexibleServers/<server>/configurations/index_tuning.unused_min_period",
    "isConfigPendingRestart": false,
    "isDynamicConfig": true,
    "isReadOnly": false,
    "name": "index_tuning.unused_min_period",
    "resourceGroup": "<resource_group>",
    "source": "system-default",
    "systemData": null,
    "type": "Microsoft.DBforPostgreSQL/flexibleServers/configurations",
    "unit": "days",
    "value": "35"
  },
  {
    "allowedValues": "0-9999999",
    "dataType": "Integer",
    "defaultValue": "1000",
    "description": "Minimum number of daily average read operations affecting the table, so that their unused indexes are considered for dropping.",
    "documentationLink": "https://go.microsoft.com/fwlink/?linkid=2274149",
    "id": "/subscriptions/<subscription_id>/resourceGroups/<resource_group>/providers/Microsoft.DBforPostgreSQL/flexibleServers/<server>/configurations/index_tuning.unused_reads_per_table",
    "isConfigPendingRestart": false,
    "isDynamicConfig": true,
    "isReadOnly": false,
    "name": "index_tuning.unused_reads_per_table",
    "resourceGroup": "<resource_group>",
    "source": "system-default",
    "systemData": null,
    "type": "Microsoft.DBforPostgreSQL/flexibleServers/configurations",
    "unit": null,
    "value": "1000"
  }
]

インデックスのチューニング設定を変更する手順

ポータル

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

1. Azure Database for PostgreSQL フレキシブル サーバー インスタンスを選択します。

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

   

3. [ チューニング設定] を選択します。

   

4. 変更する設定の値を変更し、[ 保存] を選択します。

   

5. 設定の値が変更されることを考慮する前に、デプロイが正常に完了するまで待ちます。

   

CLI

az postgres flexible-server index-tuning set-settings コマンドを使用して、既存のサーバーの単一のインデックス チューニング設定の値を変更できます。

たとえば、 analyze_interval と呼ばれるインデックス チューニング設定の値を 1440 に設定するには、次のコマンドを使用します。

az postgres flexible-server index-tuning set-settings \
  --resource-group <resource_group> \
  --server-name <server> \
  --name analyze_interval \
  --value 1440

このコマンドは、インデックス チューニングの設定に対応するサーバー パラメーターに関するすべての情報を返します。出力は次のようになります。

{
  "allowedValues": "60-10080",
  "dataType": "Integer",
  "defaultValue": "720",
  "description": "Sets the frequency at which each index optimization session is triggered when index_tuning.mode is set to 'REPORT'.",
  "documentationLink": "https://go.microsoft.com/fwlink/?linkid=2274149",
  "id": "/subscriptions/<subscription_id>/resourceGroups/<resource_group>/providers/Microsoft.DBforPostgreSQL/flexibleServers/<server>/configurations/index_tuning.analysis_interval",
  "isConfigPendingRestart": false,
  "isDynamicConfig": true,
  "isReadOnly": false,
  "name": "index_tuning.analysis_interval",
  "resourceGroup": "<resource_group>",
  "source": "user-override",
  "systemData": null,
  "type": "Microsoft.DBforPostgreSQL/flexibleServers/configurations",
  "unit": "minutes",
  "value": "1440"
}

関連コンテンツ

• インデックスのチューニング
• インデックスの推奨事項の使用
• クエリ ストア