Konfigurera indexoptimering

2025-10-02

Indexjustering kan aktiveras, inaktiveras och konfigureras via en uppsättning parametrar som styr dess beteende, till exempel hur ofta en justeringssession kan köras.

Indexjustering beror på frågearkivet. Vi rekommenderar inte att du aktiverar frågearkivet på prisnivån Burstable på grund av de prestandakonsekvenser det kan ha. Av samma anledning rekommenderas inte indexjustering för servrar som använder beräkning från nivån Burstable.

Indexjustering är en opt-in-funktion som inte är aktiverad som standard på en server. Den kan aktiveras eller inaktiveras globalt för alla databaser på en viss server och kan inte aktiveras eller inaktiveras per databas.

Steg för att aktivera indexjustering

Anmärkning

Optimering av index beror på frågearkivet, som inte stöds i Azure Database for PostgreSQL – flexibel server version 18, när det är i förhandsversion.

Portal
CLI

Använd Azure Portal:

Välj din Azure Database for PostgreSQL-flexibla serverinstans.
På resursmenyn går du till Intelligenta prestanda och väljer Indexjustering.
Om antingen pg_qs.query_capture_mode är inställt på NONE eller index_tuning.mode är inställt på OFFger sidan Indexjustering möjlighet att aktivera indexjustering. Välj någon av de två aktivera indexjusteringsknapparna för att aktivera funktionen för indexjustering och dess nödvändiga beroende för frågearkivet om frågearkivet är inaktiverat.
Vänta tills distributionen har slutförts innan du överväger att funktionen är aktiverad.
När du har aktiverat indexjustering kan du tillåta 12 timmar för indexjusteringsmotorn att analysera arbetsbelastningen som samlats in av frågearkivet under den tiden och slutligen skapa eller släppa indexrekommendationer.

Viktigt!

När indexjustering aktiveras via knappen Aktivera indexjustering ändras den till pg_qs.query_capture_modeNONE.ALL Om den redan har angetts till antingen TOP eller ALL, lämnas den i sitt aktuella tillstånd.

Du kan aktivera indexjustering på en befintlig server via kommandot az postgres flexible-server index-tuning update .

Använd det här kommandot för att aktivera indexjustering:

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

Om föregående kommando körs korrekt bör du se följande utdata:

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

Använd Azure Portal:

Välj din Azure Database for PostgreSQL-flexibla serverinstans.
På resursmenyn går du till Intelligenta prestanda och väljer Indexjustering.
Välj Inaktivera indexjustering för att inaktivera funktionen.
Vänta tills distributionen har slutförts innan du överväger att funktionen är inaktiverad.
Utvärdera om du vill fortsätta använda Övervaka prestanda med frågearkivet för att övervaka arbetsbelastningens prestanda och lämna den aktiverad eller, om du vill inaktivera den, genom att ange pg_qs.query_capture_mode till NONE.

Viktigt!

När indexjustering inaktiveras via knappen Inaktivera indexjustering är serverparametern pg_qs.query_capture_mode inte inställd på NONE, men vänster när den har konfigurerats.

Du kan inaktivera indexjustering på en befintlig server via kommandot az postgres flexible-server index-tuning update .

Om du vill inaktivera indexjustering använder du det här kommandot:

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

Om föregående kommando körs korrekt bör du se följande utdata:

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

Utvärdera om du vill fortsätta använda Övervaka prestanda med frågearkivet för att övervaka arbetsbelastningens prestanda och lämna den aktiverad eller, om du vill inaktivera den, genom att ange pg_qs.query_capture_mode till NONE.

Viktigt!

När indexjustering har inaktiverats via CLI-kommandot är serverparametern pg_qs.query_capture_mode inte inställd på NONE, utan vänster när den har konfigurerats.

Steg för att visa status för indexoptimering

Portal
CLI

Använd Azure Portal:

Välj din Azure Database for PostgreSQL-flexibla serverinstans.
På resursmenyn går du till Intelligenta prestanda och väljer Indexjustering.
Om indexjustering är aktiverat visar sidan knappen Inaktivera indexjustering .
Om indexjustering är inaktiverat visar sidan knappen Aktivera indexjustering .

Du kan visa status för indexjustering på en befintlig server via kommandot az postgres flexible-server index-tuning show .

Om du vill inaktivera indexjustering använder du det här kommandot:

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

Om indexjustering är aktiverat bör du se följande utdata:

WARNING: Index tuning is enabled for the server.

Om indexjustering är inaktiverat bör du se följande utdata:

WARNING: Index tuning is disabled for the server.

Steg för att lista inställningar för indexjustering

Portal
CLI

Använd Azure Portal:

Välj din Azure Database for PostgreSQL-flexibla serverinstans.
På resursmenyn går du till Intelligenta prestanda och väljer Indexjustering.
Välj Justeringsinställningar.

Du kan visa värdet för en enda indexjusteringsinställning på en befintlig server via kommandot az postgres flexible-server index-tuning show-settings .

Om du till exempel vill visa värdet för indexjusteringsinställningen med namnet analyze_intervalanvänder du det här kommandot:

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

Kommandot returnerar all information om serverparametern som motsvarar den inställningen för indexjustering och utdata liknar följande:

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

Du kan också visa listan över alla inställningar för indexjustering på en befintlig server via kommandot az postgres flexible-server index-tuning list-settings .

Använd det här kommandot om du vill visa en lista över alla inställningar för indexjustering:

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

Kommandot returnerar alla serverparametrar som styr de olika inställningarna för indexjustering och utdata liknar följande:

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

Steg för att ändra inställningar för indexjustering

Portal
CLI

Använd Azure Portal:

Välj din Azure Database for PostgreSQL-flexibla serverinstans.
På resursmenyn går du till Intelligenta prestanda och väljer Indexjustering.
Välj Justeringsinställningar.
Ändra värdena för så många inställningar som du vill ändra och välj Spara.
Vänta tills distributionen har slutförts innan du överväger att värdet för inställningarna ändras.

Du kan ändra värdet för en enda indexjusteringsinställning på en befintlig server via kommandot az postgres flexible-server index-tuning set-settings .

Om du till exempel vill ange värdet för indexjusteringsinställningen som kallas analyze_interval för 1440använder du det här kommandot:

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

Kommandot returnerar all information om serverparametern som motsvarar den inställningen för indexjustering och utdata liknar följande:

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

Var den här sidan till hjälp?

Dela via

Konfigurera indexoptimering

Steg för att aktivera indexjustering

Steg för att inaktivera indexjustering

Steg för att visa status för indexoptimering

Steg för att lista inställningar för indexjustering

Steg för att ändra inställningar för indexjustering

Relaterat innehåll

Feedback

Ytterligare resurser