Configurare l'ottimizzazione automatica in Server flessibile di Database di Azure per PostgreSQL

È possibile abilitare, disabilitare e configurare l'ottimizzazione autonoma tramite un set di parametri che ne controllano il comportamento, ad esempio la frequenza con cui deve essere eseguita una sessione di ottimizzazione.

L'ottimizzazione automatica dipende dai dati che query store salva localmente nel database azure_sys. Non abilitare Query Store nel piano tariffario Burstable, a causa delle implicazioni sulle prestazioni che potrebbe avere. Per lo stesso motivo, non utilizzare il tuning automatico per i server che usano risorse di calcolo del tier Burstable.

L'ottimizzazione autonoma è una funzionalità di consenso esplicito disabilitata per impostazione predefinita in un server. È possibile abilitarlo o disabilitarlo a livello globale per tutti i database in un determinato server. Non è possibile attivarlo o disattivarlo per ogni database.

Passaggi per abilitare l'ottimizzazione autonoma

Portal
CLI

Usare il portale di Azure:

Seleziona il server flessibile di Azure Database per PostgreSQL.
Nel menu delle risorse, in Prestazioni intelligenti, selezionare Ottimizzazione autonoma.
Se pg_qs.query_capture_mode è impostato su none o index_tuning.mode è impostato su off, la pagina ottimizzazione autonoma consente di abilitare l'ottimizzazione autonoma. Selezionare uno dei due pulsanti Abilita tuning per abilitare la funzionalità di tuning autonomo e la dipendenza dell'archivio query necessaria, se l'archivio query è disabilitato.
Attendere il completamento della distribuzione prima di considerare che la funzionalità è abilitata.
Dopo aver abilitato l'ottimizzazione autonoma, possono occorrere fino a 12 ore affinché il motore di ottimizzazione autonoma analizzi il carico di lavoro raccolto dall'archivio delle query durante questo tempo e infine produca raccomandazioni.

Importante

Quando si abilita l'ottimizzazione autonoma usando il pulsante Abilita ottimizzazione , se pg_qs.query_capture_mode è impostato su none, il processo lo modifica in all. Se è già impostato su top o all, il processo lo lascia invariato.

Usare il comando az postgres flexible-server autonomous-tuning update per abilitare l'ottimizzazione autonoma in un server esistente.

Per abilitare l'ottimizzazione autonoma, usare questo comando:

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

Se il comando precedente viene eseguito correttamente, viene visualizzato l'output seguente:

WARNING: Enabling autonomous tuning for the server.
WARNING: Autonomous tuning is enabled for the server.

Passaggi per disabilitare la sintonizzazione autonoma

Portal
CLI

Usare il portale di Azure:

Seleziona il server flessibile di Azure Database per PostgreSQL.
Nel menu delle risorse, in Prestazioni intelligenti, selezionare Ottimizzazione autonoma.
Selezionare Disabilita tuning per disabilitare la funzionalità.
Attendere il completamento della distribuzione prima di considerare che la funzionalità è disabilitata.
Valutare se si vuole continuare a usare Query Store per monitorare le prestazioni del carico di lavoro e lasciarlo abilitato o, se si vuole disabilitarlo, farlo impostando su pg_qs.query_capture_modenone.

Importante

Quando l'ottimizzazione autonoma è disabilitata tramite il pulsante Disabilita ottimizzazione , il parametro pg_qs.query_capture_mode non è impostato su none, ma lasciato come configurato.

Usare il comando az postgres flexible-server autonomous-tuning update per disabilitare l'ottimizzazione autonoma in un server esistente.

Per disabilitare l'ottimizzazione autonoma, usare questo comando:

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

Se il comando precedente viene eseguito correttamente, viene visualizzato l'output seguente:

WARNING: Disabling autonomous tuning for the server.
WARNING: Autonomous tuning is disabled for the server.

Valutare se si vuole continuare a usare Query Store per monitorare le prestazioni del carico di lavoro e lasciarlo abilitato oppure, se si vuole disabilitarlo, impostando su pg_qs.query_capture_modenone.

Importante

Quando l'ottimizzazione autonoma viene disabilitata tramite il comando dell'interfaccia della riga di comando, il parametro pg_qs.query_capture_mode non è impostato su none, ma viene lasciato come configurato.

I passaggi per verificare lo stato dell'autotuning autonomo

Portal
CLI

Usare il portale di Azure:

Seleziona il server flessibile di Azure Database per PostgreSQL.
Nel menu delle risorse, in Prestazioni intelligenti, selezionare Ottimizzazione autonoma.
Se l'ottimizzazione autonoma è abilitata, nella pagina viene visualizzato il pulsante Disabilita ottimizzazione .
Se l'ottimizzazione autonoma è disabilitata, nella pagina viene visualizzato il pulsante Abilita ottimizzazione .

Usare il comando az postgres flexible-server autonomous-tuning show per visualizzare lo stato dell'ottimizzazione autonoma in un server esistente.

Per visualizzare lo stato dell'ottimizzazione autonoma, usare questo comando:

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

Se l'ottimizzazione autonoma è abilitata, verrà visualizzato l'output seguente:

WARNING: Autonomous tuning is enabled for the server.

Se l'ottimizzazione autonoma è disabilitata, verrà visualizzato l'output seguente:

WARNING: Autonomous tuning is disabled for the server.

Passaggi per elencare le impostazioni di ottimizzazione autonoma

Portal
CLI

Usare il portale di Azure:

Seleziona il server flessibile di Azure Database per PostgreSQL.
Nel menu delle risorse, in Prestazioni intelligenti, selezionare Ottimizzazione autonoma.
Selezionare Impostazioni di ottimizzazione.

Usare il comando az postgres flexible-server autonomous-tuning show-settings per visualizzare il valore di una singola impostazione di ottimizzazione autonoma in un server esistente.

Ad esempio, per visualizzare il valore dell'impostazione di ottimizzazione autonoma denominata analyze_interval, usare il comando seguente:

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

Il comando restituisce tutte le informazioni sul parametro corrispondente a tale impostazione di ottimizzazione autonoma. L'output è simile al seguente:

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

Usare il comando az postgres flexible-server autonomous-tuning list-settings per visualizzare l'elenco di tutte le impostazioni di ottimizzazione autonoma in un server esistente.

Per elencare tutte le impostazioni di ottimizzazione autonoma, usare il comando seguente:

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

Il comando restituisce tutti i parametri che controllano le diverse impostazioni di ottimizzazione autonoma. L'output è simile al seguente:

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

Passaggi per modificare le impostazioni di ottimizzazione autonoma

Portal
CLI

Usare il portale di Azure:

Seleziona il server flessibile di Azure Database per PostgreSQL.
Nel menu delle risorse, in Prestazioni intelligenti, selezionare Ottimizzazione autonoma.
Selezionare Impostazioni di ottimizzazione.
Modificare i valori di tutte le impostazioni desiderate e selezionare Salva.
Attendere che la distribuzione venga completata correttamente prima di considerare che il valore delle impostazioni viene modificato.

Usare il comando az postgres flexible-server autonomous-tuning set-settings per modificare il valore di una singola impostazione di ottimizzazione autonoma in un server esistente.

Ad esempio, per impostare il valore dell'impostazione di ottimizzazione autonoma denominata su analyze_interval1440, usare il comando seguente:

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

Il comando restituisce tutte le informazioni sul parametro corrispondente a tale impostazione di ottimizzazione autonoma. L'output è simile al seguente:

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

Commenti e suggerimenti

Questa pagina è stata utile?

Last updated on 2026-07-16

Configurare l'ottimizzazione automatica in Server flessibile di Database di Azure per PostgreSQL

Passaggi per abilitare l'ottimizzazione autonoma

Passaggi per disabilitare la sintonizzazione autonoma

I passaggi per verificare lo stato dell'autotuning autonomo

Passaggi per elencare le impostazioni di ottimizzazione autonoma

Passaggi per modificare le impostazioni di ottimizzazione autonoma

Contenuti correlati

Commenti e suggerimenti

Risorse aggiuntive