Configuración del ajuste de índice

SE APLICA A: Azure Database for PostgreSQL: servidor flexible

El ajuste de índices se puede habilitar, deshabilitar y configurar mediante un conjunto de parámetros que controlan su comportamiento, como la frecuencia con la que se puede ejecutar una sesión de ajuste.

El ajuste del índice depende del almacén de consultas. No se recomienda habilitar el almacén de consultas en el plan de tarifa ampliable, debido a las implicaciones de rendimiento que puede tener. Por el mismo motivo, no se recomienda el ajuste de índices para los servidores que usan el proceso desde el nivel Ampliable.

El ajuste de índices es una funcionalidad opcional que no está habilitada por defecto en un servidor. Se puede habilitar o deshabilitar globalmente para todas las bases de datos de un servidor determinado y no se puede activar ni desactivar por base de datos.

Pasos para habilitar el ajuste de índices

Portal

Mediante Azure Portal:

1. Seleccione su servidor flexible de Azure Database for PostgreSQL.

2. En el menú de recursos, en Rendimiento inteligente, seleccione Ajuste de índices.

   

3. Si pg_qs.query_capture_mode se establece en NONE o index_tuning.mode se establece en OFF, la página de Ajuste del índice le proporciona la opción de habilitar el ajuste de índices. Seleccione uno de los dos botones Habilitar ajuste de índices para habilitar la característica de ajuste de índices y su dependencia necesaria del Almacén de consultas, si el Almacén de consultas está deshabilitado.

   

4. Espere a que la implementación se complete correctamente antes de considerar que la característica está habilitada.

   

5. Después de habilitar el ajuste de índices, permita 12 horas para que el motor de optimización de índices analice la carga de trabajo recopilada por el Almacén de consultas durante ese tiempo y, finalmente, genere recomendaciones de creación o eliminación de índices.

Importante

Cuando el ajuste de índices está habilitado a través del botón Habilitar ajuste de índices, si pg_qs.query_capture_mode está establecido en NONE, se cambia a ALL. Si ya se estableció en TOP o ALL, se deja en su estado actual.

CLI

Puede habilitar el ajuste de índices en un servidor existente mediante el comando az postgres flexible-server index-tuning update .

Para habilitar el ajuste de índices, use este comando:

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

Si el comando anterior se ejecuta correctamente, debería ver la siguiente salida:

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

Pasos para deshabilitar el ajuste de índices

Portal

Mediante Azure Portal:

1. Seleccione su servidor flexible de Azure Database for PostgreSQL.

2. En el menú de recursos, en Rendimiento inteligente, seleccione Ajuste de índices.

   

3. Seleccione Deshabilitar ajuste de índice para deshabilitar la característica.

   

4. Espere a que la implementación se complete correctamente antes de considerar que la característica está deshabilitada.

   

5. Evalúe si desea seguir usando Monitor de rendimiento con el almacén de consultas para supervisar el rendimiento de su carga de trabajo y dejarlo habilitado o, si quiere deshabilitarlo, configurando pg_qs.query_capture_mode en NONE.

Importante

Cuando la optimización de índices está deshabilitada a través del botón Deshabilitar optimización de índices, el parámetro del servidor pg_qs.query_capture_mode no se establece en NONE, sino que se deja tal como está configurado.

CLI

Puede deshabilitar el ajuste de índices en un servidor existente mediante el comando az postgres flexible-server index-tuning update .

Para deshabilitar el ajuste de índices, use este comando:

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

Si el comando anterior se ejecuta correctamente, debería ver la siguiente salida:

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

Evalúe si desea seguir usando Monitorear el rendimiento con el almacén de consultas para supervisar el rendimiento de su carga de trabajo y dejarlo habilitado o, si quiere deshabilitarlo, estableciendo pg_qs.query_capture_mode a NONE.

Importante

Cuando se deshabilita el ajuste de índices mediante el comando de la CLI, el parámetro pg_qs.query_capture_mode de servidor no se establece en NONE, pero se deja tal como está configurado.

Pasos para mostrar el estado del ajuste del índice

Portal

Mediante Azure Portal:

1. Seleccione su servidor flexible de Azure Database for PostgreSQL.

2. En el menú de recursos, en Rendimiento inteligente, seleccione Ajuste de índices.

   

3. Si el ajuste de índices está habilitado, la página muestra el botón Deshabilitar optimización de índices .

   

4. Si el ajuste de índices está deshabilitado, la página muestra el botón Habilitar ajuste de índice .

   

CLI

Puede mostrar el estado del ajuste de índices en un servidor existente mediante el comando az postgres flexible-server index-tuning show .

Para deshabilitar el ajuste de índices, use este comando:

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

Si la optimización de índices está habilitada, deberías ver la siguiente salida:

WARNING: Index tuning is enabled for the server.

Si el ajuste de índices está deshabilitado, verá la siguiente salida:

WARNING: Index tuning is disabled for the server.

Pasos para enumerar la configuración de optimización de índices

Portal

Mediante Azure Portal:

1. Seleccione su servidor flexible de Azure Database for PostgreSQL.

2. En el menú de recursos, en Rendimiento inteligente, seleccione Ajuste de índices.

   

3. Seleccione Configuración de optimización.

   

CLI

Puede mostrar el valor de una configuración de ajuste de índice único en un servidor existente a través del comando az postgres flexible-server index-tuning show-settings .

Por ejemplo, para mostrar el valor de la configuración de optimización de índices denominada analyze_interval, use este comando:

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

El comando devuelve toda la información sobre el parámetro de servidor correspondiente a esa configuración de ajuste de índice y la salida es similar a la siguiente:

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

Además, puede mostrar la lista de todas las opciones de ajuste de índice en un servidor existente mediante el comando az postgres flexible-server index-tuning list-settings .

Para enumerar todas las opciones de optimización de índices, use este comando:

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

El comando devuelve todos los parámetros de servidor que controlan la configuración diferente del ajuste del índice y la salida es similar a la siguiente:

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

Pasos para modificar la configuración de optimización del índice

Portal

Mediante Azure Portal:

1. Seleccione su servidor flexible de Azure Database for PostgreSQL.

2. En el menú de recursos, en Rendimiento inteligente, seleccione Ajuste de índices.

   

3. Seleccione Configuración de optimización.

   

4. Modifique los valores de tanta configuración como desee cambiar y seleccione Guardar.

   

5. Espere a que la implementación se complete correctamente antes de considerar que se cambia el valor de la configuración.

   

CLI

Puede modificar el valor de una configuración de ajuste de índice único en un servidor existente mediante el comando az postgres flexible-server index-tuning set-settings .

Por ejemplo, para establecer el valor de la configuración de optimización de índices llamada analyze_interval a 1440, use este comando:

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

El comando devuelve toda la información sobre el parámetro de servidor correspondiente a esa configuración de ajuste de índice y la salida es similar a la siguiente:

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

Contenido relacionado

• Optimización de índices
• Uso de recomendaciones de índice
• Almacén de consultas