Nakonfigurujte ladění indexu

Ladění indexu je možné povolit, zakázat a nakonfigurovat prostřednictvím sady parametrů , které řídí jeho chování, jako je například četnost spuštění relace ladění.

Ladění indexu závisí na úložišti dotazů. Nedoporučujeme povolit úložiště dotazů na cenovou úroveň Burstable, protože to může mít vliv na výkon. Z stejného důvodu se ladění indexu nedoporučuje pro servery používající výpočetní prostředky z vrstvy Burstable.

Ladění indexu je funkce výslovného souhlasu, která není na serveru ve výchozím nastavení povolená. U všech databází na daném serveru je možné ji povolit nebo zakázat globálně a není možné ji pro každou databázi zapnout ani vypnout.

Postup povolení ladění indexu

Poznámka:

Ladění indexu závisí na úložišti dotazů, které není ve službě Azure Database for PostgreSQL verze 18 podporované.

Portál

Pomocí webu Azure Portal:

1. Vyberte instanci flexibilního serveru Azure Database for PostgreSQL.

2. V nabídce prostředků v části Inteligentní výkon vyberte Ladění indexu.

   

3. pg_qs.query_capture_mode Pokud je nastavená hodnota nebo NONE je nastavenáindex_tuning.modeOFF, stránka ladění indexu vám poskytne možnost povolit ladění indexu. Vyberte jednu ze dvou tlačítek Povolit ladění indexu , pokud chcete povolit funkci ladění indexu a požadovanou závislost úložiště dotazů, pokud je úložiště dotazů zakázané.

   

4. Počkejte, až se nasazení úspěšně dokončí, a teprve potom zvažte, že je tato funkce povolená.

   

5. Po povolení ladění indexu počkejte 12 hodin, než modul ladění indexů analyzuje úlohu shromážděnou úložištěm dotazů a nakonec vytvoří doporučení k vytvoření nebo vyřazení indexu.

Důležité

Pokud je ladění indexu povolené pomocí tlačítka Povolit ladění indexu , pokud pg_qs.query_capture_mode je nastaveno na NONE, změní se na ALL. Pokud už byla nastavená na hodnotu TOP nebo ALL, zůstane v aktuálním stavu.

CLI

Ladění indexu můžete povolit na existujícím serveru pomocí příkazu az postgres flexible-server index-tuning update .

Pokud chcete povolit ladění indexu, použijte tento příkaz:

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

Pokud se předchozí příkaz úspěšně spustí, měl by se zobrazit následující výstup:

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

Postup zakázání optimalizace indexu

Portál

Pomocí webu Azure Portal:

1. Vyberte instanci flexibilního serveru Azure Database for PostgreSQL.

2. V nabídce prostředků v části Inteligentní výkon vyberte Ladění indexu.

   

3. Pokud chcete tuto funkci zakázat, vyberte Zakázat ladění indexu .

   

4. Než považujete funkci za zakázanou, počkejte, než se nasazení úspěšně dokončí.

   

5. Vyhodnoťte, jestli chcete dál používat monitorování výkonu s úložištěm dotazů, abyste mohli monitorovat výkon úlohy, a ponechat ho povolenou, nebo pokud ho chcete zakázat, nastavením na pg_qs.query_capture_mode.NONE

Důležité

Pokud je ladění indexu zakázané pomocí tlačítka Zakázat ladění indexu , parametr pg_qs.query_capture_mode serveru není nastavený na NONE, ale ponechá se tak, jak je nakonfigurovaný.

CLI

Ladění indexů na existujícím serveru můžete zakázat pomocí příkazu az postgres flexible-server index-tuning update .

Pokud chcete ladění indexu zakázat, použijte tento příkaz:

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

Pokud se předchozí příkaz úspěšně spustí, měl by se zobrazit následující výstup:

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

Vyhodnoťte, jestli chcete dál používat monitorování výkonu s úložištěm dotazů, abyste mohli monitorovat výkon úlohy, a ponechat ho povolenou, nebo pokud ho chcete zakázat, nastavením na pg_qs.query_capture_mode.NONE

Důležité

Při zakázání ladění indexu pomocí příkazu CLI není parametr pg_qs.query_capture_mode serveru nastaven na NONE, ale ponechá se tak, jak je nastavený.

Postup zobrazení stavu ladění indexu

Portál

Pomocí webu Azure Portal:

1. Vyberte instanci flexibilního serveru Azure Database for PostgreSQL.

2. V nabídce prostředků v části Inteligentní výkon vyberte Ladění indexu.

   

3. Pokud je povolené ladění indexu, zobrazí se na stránce tlačítko Zakázat ladění indexu .

   

4. Pokud je ladění indexu zakázané, zobrazí se na stránce tlačítko Povolit ladění indexu .

   

CLI

Stav ladění indexu můžete zobrazit na existujícím serveru pomocí příkazu az postgres flexible-server index-tuning show .

Pokud chcete ladění indexu zakázat, použijte tento příkaz:

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

Pokud je povolené ladění indexu, měl by se zobrazit následující výstup:

WARNING: Index tuning is enabled for the server.

Pokud je ladění indexu zakázané, měli byste vidět následující výstup:

WARNING: Index tuning is disabled for the server.

Postup pro zobrazení seznamu nastavení ladění indexu

Portál

Pomocí webu Azure Portal:

1. Vyberte instanci flexibilního serveru Azure Database for PostgreSQL.

2. V nabídce prostředků v části Inteligentní výkon vyberte Ladění indexu.

   

3. Vyberte Nastavení ladění.

   

CLI

Hodnotu nastavení ladění jednoho indexu můžete zobrazit na existujícím serveru pomocí příkazu az postgres flexible-server index-tuning show-settings .

Pokud chcete například zobrazit hodnotu nastavení ladění indexu s názvem analyze_interval, použijte tento příkaz:

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

Příkaz vrátí všechny informace o parametru serveru odpovídající tomuto nastavení ladění indexu a výstup je podobný následujícímu:

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

Seznam všech nastavení ladění indexu můžete také zobrazit na existujícím serveru pomocí příkazu az postgres flexible-server index-tuning list-settings .

Pokud chcete zobrazit seznam všech nastavení ladění indexu, použijte tento příkaz:

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

Příkaz vrátí všechny parametry serveru, které řídí různá nastavení ladění indexu, a výstup je podobný následujícímu:

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

Postup úpravy nastavení ladění indexu

Portál

Pomocí webu Azure Portal:

1. Vyberte instanci flexibilního serveru Azure Database for PostgreSQL.

2. V nabídce prostředků v části Inteligentní výkon vyberte Ladění indexu.

   

3. Vyberte Nastavení ladění.

   

4. Upravte hodnoty tolik nastavení, kolik chcete změnit, a vyberte Uložit.

   

5. Počkejte, až se nasazení úspěšně dokončí, a teprve pak zvažte, že se změní hodnota nastavení.

   

CLI

Hodnotu nastavení ladění jednoho indexu na existujícím serveru můžete upravit pomocí příkazu az postgres flexible-server index-tuning set-settings .

Pokud například chcete nastavit hodnotu nastavení ladění indexu, které se nazývá analyze_interval, na 1440, použijte tento příkaz:

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

Příkaz vrátí všechny informace o parametru serveru odpovídající tomuto nastavení ladění indexu a výstup je podobný následujícímu:

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

Související obsah

• Ladění indexu
• Použití doporučení indexu
• Úložiště dotazů