Konfigurieren der Indexoptimierung

Die Indexoptimierung kann über eine Reihe von Parametern für die Verhaltenssteuerung aktiviert, deaktiviert und konfiguriert werden. So können Sie beispielsweise festlegen, wie oft eine Optimierungssitzung ausgeführt werden kann.

Die Indexoptimierung hängt vom Abfragespeicher ab. Es wird nicht empfohlen, den Abfragespeicher auf dem Preisniveau "Burstable" zu aktivieren, da dies möglicherweise auswirkungen auf die Leistung hat. Aus demselben Grund wird die Indexoptimierung nicht für Server empfohlen, die Rechenkapazität aus der Burstable-Stufe verwenden.

Die Indexoptimierung ist ein optionales Feature, das auf einem Server standardmäßig nicht aktiviert ist. Sie kann global für alle Datenbanken auf einem bestimmten Server aktiviert oder deaktiviert werden. Die Aktivierung oder Deaktivierung für einzelne Datenbanken ist nicht möglich.

Schritte zum Aktivieren der Indexanpassung

Hinweis

Die Indexoptimierung hängt vom Abfragespeicher ab, der in Azure Database für PostgreSQL, Version 18, nicht unterstützt wird.

Portal

Verwenden des Azure-Portals:

1. Wählen Sie Ihre flexible Azure Database for PostgreSQL-Serverinstanz aus.

2. Wählen Sie im Ressourcenmenü unter "Intelligente Leistung" die Option "Indexoptimierung" aus.

   

3. Wenn entweder pg_qs.query_capture_mode auf NONE oder index_tuning.mode auf OFF festgelegt ist, haben Sie auf der Seite Indexoptimierung die Möglichkeit, die Indexoptimierung zu aktivieren. Wählen Sie eine der beiden Schaltflächen Indexoptimierung aktivieren aus, um das Indexoptimierungsfeature und die erforderliche Abfragespeicherabhängigkeit zu aktivieren, wenn der Abfragespeicher deaktiviert ist.

   

4. Warten Sie, bis die Bereitstellung erfolgreich abgeschlossen wurde, bevor Sie berücksichtigen, dass das Feature aktiviert ist.

   

5. Warten Sie nach dem Aktivieren der Indexoptimierung 12 Stunden, damit die Indexoptimierungs-Engine die vom Abfragespeicher gesammelte Workload analysieren und schließlich indexbezogene Erstellungs- oder Löschempfehlungen generieren kann.

Wichtig

Wenn die Indexoptimierung über die Schaltfläche Indexoptimierung aktivieren aktiviert wird und pg_qs.query_capture_mode auf NONE festgelegt ist, wird er in ALL geändert. Wenn er bereits auf TOP oder ALL festgelegt war, bleibt der aktuelle Zustand unverändert.

CLI

Sie können die Indexoptimierung auf einem vorhandenen Server über den Befehl "az postgres flexible-server index-tuning update" aktivieren.

Verwenden Sie den folgenden Befehl, um die Indexoptimierung zu aktivieren:

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

Wenn der vorherige Befehl erfolgreich ausgeführt wird, sollte die folgende Ausgabe angezeigt werden:

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

Schritte zum Deaktivieren der Indexoptimierung

Portal

Verwenden des Azure-Portals:

1. Wählen Sie Ihre flexible Azure Database for PostgreSQL-Serverinstanz aus.

2. Wählen Sie im Ressourcenmenü unter "Intelligente Leistung" die Option "Indexoptimierung" aus.

   

3. Wählen Sie "Indexoptimierung deaktivieren" aus, um das Feature zu deaktivieren.

   

4. Warten Sie, bis die Bereitstellung erfolgreich abgeschlossen wurde, bevor Sie berücksichtigen, dass das Feature deaktiviert ist.

   

5. Überlegen Sie sich, ob Sie weiterhin die Überwachung der Leistung mit dem Abfragespeicher zur Überwachung der Leistung Ihrer Workload verwenden und den Abfragespeicher aktiviert lassen möchten, oder legen Sie pg_qs.query_capture_mode auf NONE fest, um ihn zu deaktivieren.

Wichtig

Wenn die Indexoptimierung über die Schaltfläche Index-Tuning deaktivieren deaktiviert wird, wird der Serverparameter pg_qs.query_capture_mode nicht auf NONE gesetzt, sondern bleibt wie konfiguriert.

CLI

Sie können die Indexoptimierung auf einem vorhandenen Server über den Befehl "az postgres flexible-server index-tuning update" deaktivieren.

Verwenden Sie den folgenden Befehl, um die Indexoptimierung zu deaktivieren:

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

Wenn der vorherige Befehl erfolgreich ausgeführt wird, sollte die folgende Ausgabe angezeigt werden:

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

Überlegen Sie sich, ob Sie weiterhin die Überwachung der Leistung mit dem Abfragespeicher zur Überwachung der Leistung Ihrer Workload verwenden und den Abfragespeicher aktiviert lassen möchten, oder legen Sie pg_qs.query_capture_mode auf NONE fest, um ihn zu deaktivieren.

Wichtig

Wenn die Indexoptimierung über den CLI-Befehl deaktiviert wird, wird der Serverparameter pg_qs.query_capture_mode nicht auf NONE gesetzt, sondern bleibt unverändert gemäß seiner aktuellen Konfiguration.

Schritte zum Anzeigen des Status der Indexoptimierung

Portal

Verwenden des Azure-Portals:

1. Wählen Sie Ihre flexible Azure Database for PostgreSQL-Serverinstanz aus.

2. Wählen Sie im Ressourcenmenü unter "Intelligente Leistung" die Option "Indexoptimierung" aus.

   

3. Wenn die Indexoptimierung aktiviert ist, zeigt die Seite die Schaltfläche " Indexoptimierung deaktivieren " an.

   

4. Wenn die Indexoptimierung deaktiviert ist, zeigt die Seite die Schaltfläche " Indexoptimierung aktivieren " an.

   

CLI

Sie können den Status der Indexoptimierung auf einem vorhandenen Server über den Befehl "az postgres flexible-server index-tuning show" anzeigen.

Verwenden Sie den folgenden Befehl, um die Indexoptimierung zu deaktivieren:

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

Wenn die Indexanpassung aktiviert ist, sollte folgende Ausgabe angezeigt werden:

WARNING: Index tuning is enabled for the server.

Wenn das Index-Tuning deaktiviert ist, sollte die folgende Ausgabe angezeigt werden:

WARNING: Index tuning is disabled for the server.

Schritte zum Auflisten von Indexoptimierungseinstellungen

Portal

Verwenden des Azure-Portals:

1. Wählen Sie Ihre flexible Azure Database for PostgreSQL-Serverinstanz aus.

2. Wählen Sie im Ressourcenmenü unter "Intelligente Leistung" die Option "Indexoptimierung" aus.

   

3. Wählen Sie "Tuning-Einstellungen" aus.

   

CLI

Sie können den Wert einer einzelnen Indexoptimierungseinstellung auf einem vorhandenen Server über den Befehl "az postgres flexible-server index-tuning show-settings" anzeigen.

Um beispielsweise den Wert der Einstellung für die Indexoptimierung mit dem Namen analyze_interval anzuzeigen, verwenden Sie den folgenden Befehl:

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

Der Befehl gibt alle Informationen zum Serverparameter zurück, der dieser Einstellung der Indexoptimierung entspricht, und die Ausgabe ähnelt den folgenden:

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

Darüber hinaus können Sie die Liste aller Indexoptimierungseinstellungen auf einem vorhandenen Server über den Befehl "az postgres flexible-server index-tuning list-settings" anzeigen.

Verwenden Sie den folgenden Befehl, um alle Indexoptimierungseinstellungen auflisten zu können:

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

Der Befehl gibt alle Serverparameter zurück, die die verschiedenen Einstellungen der Indexoptimierung steuern, und die Ausgabe ähnelt den folgenden:

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

Schritte zum Ändern der Indexoptimierungseinstellungen

Portal

Verwenden des Azure-Portals:

1. Wählen Sie Ihre flexible Azure Database for PostgreSQL-Serverinstanz aus.

2. Wählen Sie im Ressourcenmenü unter "Intelligente Leistung" die Option "Indexoptimierung" aus.

   

3. Wählen Sie "Tuning-Einstellungen" aus.

   

4. Ändern Sie die Werte der beliebig vielen Einstellungen, und wählen Sie "Speichern" aus.

   

5. Warten Sie, bis die Bereitstellung erfolgreich abgeschlossen wurde, bevor Sie berücksichtigen, dass der Wert der Einstellungen geändert wird.

   

CLI

Sie können den Wert einer einzelnen Indexoptimierungseinstellung auf einem vorhandenen Server über den Befehl "az postgres flexible-server index-tuning set-settings" ändern.

Um beispielsweise den Wert der Einstellung für das Indextuning mit dem Namen analyze_interval auf 1440 festzulegen, verwenden Sie diesen Befehl.

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

Der Befehl gibt alle Informationen zum Serverparameter zurück, der dieser Einstellung der Indexoptimierung entspricht, und die Ausgabe ähnelt den folgenden:

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

Verwandte Inhalte

• Indexoptimierung
• Verwenden von Indexempfehlungen
• Abfragespeicher