Настроить настройку индекса

Настройка индекса может быть включена, отключена и настроена с помощью набора параметров , которые управляют его поведением, например частоту запуска сеанса настройки.

Настройка индекса зависит от хранилища запросов. Мы не рекомендуем активировать хранилище запросов на Burstable ценовой категории вследствие потенциального влияния на производительность. По этой же причине настройка индекса не рекомендуется для серверов, использующих вычисления уровня Burstable.

Настройка индекса — это функция согласия, которая по умолчанию не включена на сервере. Она может быть включена или отключена глобально для всех баз данных на данном сервере и не может быть включена или отключена для каждой базы данных.

Шаги для активации настройки индекса

Замечание

Настройка индекса зависит от хранилища запросов, которое не поддерживается в Базе данных Azure для PostgreSQL версии 18.

Портал

Использование портала Azure:

1. Выберите гибкий экземпляр сервера Базы данных Azure для PostgreSQL.

2. В меню ресурсов в разделе "Интеллектуальная производительность" выберите "Настройка индекса".

   

3. pg_qs.query_capture_mode Если какой-либо параметр задан как NONE или index_tuning.mode, или OFF, страница оптимизации индекса предоставляет возможность включить настройку индекса. Выберите один из двух кнопок включения настройки индекса , чтобы включить функцию настройки индекса и ее необходимую зависимость хранилища запросов, если хранилище запросов отключено.

   

4. Дождитесь успешного завершения развертывания, прежде чем учитывать, что эта функция включена.

   

5. После включения настройки индекса разрешите 12 часов подсистеме настройки индекса проанализировать рабочую нагрузку, собранную хранилищем запросов в течение этого времени, и в конечном итоге создать или удалить рекомендации по индексу.

Important

Если настройка индекса включена с помощью кнопки "Включить настройку индекса", если pg_qs.query_capture_mode задано значение NONE, оно изменится на ALL. Если оно уже задано TOP или ALLоно осталось в текущем состоянии.

CLI

Вы можете включить настройку индекса на существующем сервере с помощью команды az postgres flexible-server index-tuning update .

Чтобы включить настройку индекса, используйте следующую команду:

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

Если предыдущая команда успешно выполняется, вы увидите следующие выходные данные:

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

Действия по отключению оптимизации индекса

Портал

Использование портала Azure:

1. Выберите гибкий экземпляр сервера Базы данных Azure для PostgreSQL.

2. В меню ресурсов в разделе "Интеллектуальная производительность" выберите "Настройка индекса".

   

3. Выберите "Отключить настройку индекса", чтобы отключить функцию.

   

4. Дождитесь успешного завершения развертывания, прежде чем учитывать, что эта функция отключена.

   

5. Оцените, хотите ли вы продолжать использовать мониторинг производительности с хранилищем запросов для мониторинга производительности рабочей нагрузки и оставьте его включено или, если вы хотите отключить его, задав значение pg_qs.query_capture_modeNONE.

Important

Если настройка индекса отключена с помощью кнопки «Отключить настройку индекса», параметр pg_qs.query_capture_mode сервера не задаётся в NONE, но остаётся в текущей конфигурации.

CLI

Вы можете отключить настройку индекса на существующем сервере с помощью команды az postgres flexible-server index-tuning update .

Чтобы отключить оптимизацию индекса, используйте следующую команду:

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

Если предыдущая команда успешно выполняется, вы увидите следующие выходные данные:

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

Оцените, хотите ли вы продолжать использовать мониторинг производительности с хранилищем запросов для мониторинга производительности рабочей нагрузки и оставьте его включено или, если вы хотите отключить его, задав значение pg_qs.query_capture_modeNONE.

Important

Если настройка индекса отключена с помощью команды CLI, параметр pg_qs.query_capture_mode сервера не устанавливается в NONE, а остаётся в текущей конфигурации.

Шаги для отображения состояния настройки индекса

Портал

Использование портала Azure:

1. Выберите гибкий экземпляр сервера Базы данных Azure для PostgreSQL.

2. В меню ресурсов в разделе "Интеллектуальная производительность" выберите "Настройка индекса".

   

3. Если настройка индекса включена, на странице отображается кнопка "Отключить настройку индекса ".

   

4. Если настройка индекса отключена, на странице отображается кнопка "Включить настройку индекса ".

   

CLI

Вы можете показать состояние настройки индекса на существующем сервере с помощью команды az postgres flexible-server index-tuning show .

Чтобы отключить оптимизацию индекса, используйте следующую команду:

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

Если настройка индекса включена, вы увидите следующие выходные данные:

WARNING: Index tuning is enabled for the server.

Если настройка индекса отключена, вы увидите следующие выходные данные:

WARNING: Index tuning is disabled for the server.

Шаги для указания настроек настройки индекса

Портал

Использование портала Azure:

1. Выберите гибкий экземпляр сервера Базы данных Azure для PostgreSQL.

2. В меню ресурсов в разделе "Интеллектуальная производительность" выберите "Настройка индекса".

   

3. Выберите параметры настройки.

   

CLI

Вы можете отобразить значение одного параметра настройки индекса на существующем сервере с помощью команды az postgres flexible-server index-settings show-settings .

Например, чтобы отобразить значение вызываемого analyze_intervalпараметра настройки индекса, используйте следующую команду:

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

Команда возвращает все сведения о параметре сервера, соответствующем этому параметру настройки индекса, и выходные данные похожи на следующие:

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

Кроме того, можно отобразить список всех параметров настройки индекса на существующем сервере с помощью команды az postgres flexible-server index-settings list-settings .

Чтобы получить список всех параметров настройки индекса, используйте следующую команду:

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

Команда возвращает все параметры сервера, которые управляют различными параметрами настройки индекса, а выходные данные похожи на следующие:

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

Действия по изменению параметров настройки индекса

Портал

Использование портала Azure:

1. Выберите гибкий экземпляр сервера Базы данных Azure для PostgreSQL.

2. В меню ресурсов в разделе "Интеллектуальная производительность" выберите "Настройка индекса".

   

3. Выберите параметры настройки.

   

4. Измените значения любых настроек, которые вы хотите изменить, и выберите Сохранить.

   

5. Дождитесь успешного завершения развертывания, прежде чем учитывать, что значение параметров изменено.

   

CLI

Можно изменить значение одного параметра настройки индекса на существующем сервере с помощью команды az postgres flexible-server index-settings .

Например, чтобы задать значение параметра настройки индекса, вызываемого analyze_interval1440, используйте следующую команду:

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

Команда возвращает все сведения о параметре сервера, соответствующем этому параметру настройки индекса, и выходные данные похожи на следующие:

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

Связанный контент

• Настройка индекса
• Использование рекомендаций по индексу
• Хранилище запросов