Configureren van indexafstemming

2025-09-29

Indexafstemming kan worden ingeschakeld, uitgeschakeld en geconfigureerd via een set parameters die het gedrag ervan bepalen, zoals hoe vaak een afstemmingssessie kan worden uitgevoerd.

Het afstemmen van de index is afhankelijk van het queryarchief. We raden u niet aan om querystore in te schakelen voor de prijscategorie Burstable, vanwege de gevolgen voor de prestaties die dit kan hebben. Om dezelfde reden wordt indexafstemming niet aanbevolen voor servers die gebruikmaken van rekenkracht uit de Burstable-laag.

Indexafstemming is een opt-in-functie die niet standaard is ingeschakeld op een server. Het kan globaal worden ingeschakeld of uitgeschakeld voor alle databases op een bepaalde server en kan niet per database worden ingeschakeld of uitgeschakeld.

Stappen voor het afstemmen van indexen

Notitie

Het afstemmen van de index is afhankelijk van de query store, die niet wordt ondersteund in Azure Database voor PostgreSQL Flexible Server versie 18, zolang het in preview is.

Portal
CLI

Azure Portal gebruiken:

Selecteer uw Azure Database voor PostgreSQL-flexibele serverexemplaar.
Selecteer indexafstemming in het resourcemenu onder Intelligente prestaties.
Als een pg_qs.query_capture_mode van beide is ingesteld op of NONE is ingesteld index_tuning.modeOFFop, geeft de pagina Indexafstemming u de optie om indexafstemming in te schakelen. Selecteer een van de twee knoppen voor het afstemmen van indexen inschakelen om de functie voor indexafstemming en de vereiste afhankelijkheid van het queryarchief in te schakelen als querystore is uitgeschakeld.
Wacht tot de implementatie is voltooid voordat wordt overwogen dat de functie is ingeschakeld.
Nadat het afstemmen van de index is ingeschakeld, kunt u 12 uur duren voordat de indexafstemmingsengine de werkbelasting analyseert die door het queryarchief is verzameld, en produceert u uiteindelijk aanbevelingen voor het maken of verwijderen van indexen.

Belangrijk

Wanneer indexafstemming is ingeschakeld via de knop Indexafstemming inschakelen, indien pg_qs.query_capture_mode ingesteld NONEop , wordt deze gewijzigd in ALL. Als deze al is ingesteld op of TOPALL, blijft deze in de huidige status.

U kunt indexafstemming inschakelen op een bestaande server via de opdracht az postgres flexible-server index-tuning update .

Als u indexafstemming wilt inschakelen, gebruikt u deze opdracht:

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

Als de vorige opdracht is uitgevoerd, ziet u de volgende uitvoer:

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

Stappen voor het uitschakelen van indexoptimalisatie

Portal
CLI

Azure Portal gebruiken:

Selecteer uw Azure Database voor PostgreSQL-flexibele serverexemplaar.
Selecteer indexafstemming in het resourcemenu onder Intelligente prestaties.
Selecteer Indexafstemming uitschakelen om de functie uit te schakelen.
Wacht totdat de implementatie is voltooid voordat wordt overwogen dat de functie is uitgeschakeld.
Bepaal of u de prestaties van uw workload wilt blijven bewaken met Query Store en deze ingeschakeld wilt laten, of dat u deze wilt uitschakelen door pg_qs.query_capture_mode in te stellen op NONE.

Belangrijk

Wanneer indexafstemming is uitgeschakeld via de knop Indexafstemming uitschakelen, wordt de serverparameter pg_qs.query_capture_mode niet ingesteld op NONE, maar blijft zoals geconfigureerd.

U kunt het afstemmen van indexen op een bestaande server uitschakelen via de opdracht az postgres flexible-server index-tuning update .

Als u het afstemmen van indexen wilt uitschakelen, gebruikt u deze opdracht:

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

Als de vorige opdracht is uitgevoerd, ziet u de volgende uitvoer:

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

Bepaal of u de prestaties van uw workload wilt blijven bewaken met Query Store en deze ingeschakeld wilt laten, of dat u deze wilt uitschakelen door pg_qs.query_capture_mode in te stellen op NONE.

Belangrijk

Wanneer indexafstemming is uitgeschakeld via de CLI-opdracht, is de serverparameter pg_qs.query_capture_mode niet ingesteld op NONE, maar blijft zoals het is geconfigureerd.

Stappen voor het weergeven van de status van het afstemmen van de index

Portal
CLI

Azure Portal gebruiken:

Selecteer uw Azure Database voor PostgreSQL-flexibele serverexemplaar.
Selecteer indexafstemming in het resourcemenu onder Intelligente prestaties.
Als indexafstemming is ingeschakeld, wordt op de pagina de knop Indexafstemming uitschakelen weergegeven.
Als indexafstemming is uitgeschakeld, wordt op de pagina de knop Indexafstemming inschakelen weergegeven.

U kunt de status van indexafstemming op een bestaande server weergeven via de opdracht az postgres flexible-server index-tuning show .

Als u het afstemmen van indexen wilt uitschakelen, gebruikt u deze opdracht:

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

Als indexafstemming is ingeschakeld, ziet u de volgende uitvoer:

WARNING: Index tuning is enabled for the server.

Als indexafstemming is uitgeschakeld, ziet u de volgende uitvoer:

WARNING: Index tuning is disabled for the server.

Stappen voor het weergeven van instellingen voor het afstemmen van indexen

Portal
CLI

Azure Portal gebruiken:

Selecteer uw Azure Database voor PostgreSQL-flexibele serverexemplaar.
Selecteer indexafstemming in het resourcemenu onder Intelligente prestaties.
Selecteer Afstemmingsinstellingen.

U kunt de waarde van één instelling voor indexafstemming op een bestaande server weergeven via de opdracht az postgres flexible-server index-tuning show-settings .

Als u bijvoorbeeld de waarde wilt weergeven van de instelling voor indexafstemming met de naam analyze_interval, gebruikt u deze opdracht:

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

De opdracht retourneert alle informatie over de serverparameter die overeenkomt met die instelling van indexafstemming en de uitvoer is vergelijkbaar met de volgende:

{
  "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"
}

U kunt ook de lijst met alle instellingen voor indexafstemming op een bestaande server weergeven via de opdracht az postgres flexible-server index-tuning list-settings .

Als u alle instellingen voor indexafstemming wilt weergeven, gebruikt u deze opdracht:

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

De opdracht retourneert alle serverparameters die de verschillende instellingen van indexafstemming beheren en de uitvoer is vergelijkbaar met het volgende:

[
  {
    "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"
  }
]

Stappen voor het wijzigen van instellingen voor indexafstemming

Portal
CLI

Azure Portal gebruiken:

Selecteer uw Azure Database voor PostgreSQL-flexibele serverexemplaar.
Selecteer indexafstemming in het resourcemenu onder Intelligente prestaties.
Selecteer Afstemmingsinstellingen.
Wijzig de waarden van zoveel instellingen als u wilt wijzigen en selecteer Opslaan.
Wacht tot de implementatie is voltooid voordat wordt overwogen dat de waarde van de instellingen is gewijzigd.

U kunt de waarde van één instelling voor het afstemmen van indexen in een bestaande server wijzigen via de opdracht az postgres flexible-server index-tuning set-settings .

Als u bijvoorbeeld de waarde van de index-tuning-instelling genaamd analyze_interval naar 1440 wilt instellen, gebruikt u deze opdracht:

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

De opdracht retourneert alle informatie over de serverparameter die overeenkomt met die instelling van indexafstemming en de uitvoer is vergelijkbaar met de volgende:

{
  "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"
}

Feedback

Is deze pagina nuttig?

Delen via

Configureren van indexafstemming

Stappen voor het afstemmen van indexen

Stappen voor het uitschakelen van indexoptimalisatie

Stappen voor het weergeven van de status van het afstemmen van de index

Stappen voor het weergeven van instellingen voor het afstemmen van indexen

Stappen voor het wijzigen van instellingen voor indexafstemming

Gerelateerde inhoud

Feedback

Aanvullende resources