Configurar otimização de índice

O ajuste de índice pode ser habilitado, desabilitado e configurado por meio de um conjunto de parâmetros que controlam seu comportamento, como a frequência com que uma sessão de ajuste pode ser executada.

O ajuste do índice depende do armazenamento de consultas. Não recomendamos habilitar o repositório de consultas na camada de preços Burstable devido às implicações de desempenho que possa ter. Pelo mesmo motivo, o ajuste de índice não é recomendado para servidores que usam computação da camada Burstable.

O ajuste de índice é um recurso opcional que não está ativado por defeito num servidor. Ele pode ser habilitado ou desabilitado globalmente para todos os bancos de dados em um determinado servidor e não pode ser ativado ou desativado por banco de dados.

Etapas para habilitar o ajuste de índice

Observação

A otimização do índice depende do Query Store, que não é suportado no Azure Database para PostgreSQL versão 18.

Portais

Usando o portal do Azure:

1. Selecione a sua instância de servidor flexível do Azure Database para PostgreSQL.

2. No menu de recursos, em Desempenho Inteligente, selecione Ajuste de índice.

   

3. Se pg_qs.query_capture_mode estiver definido como NONE ou index_tuning.mode estiver definido como OFF, a página de ajuste de índice oferece a opção de ativar o ajuste de índice. Selecione um dos dois botões Habilitar ajuste de índice para ativar o recurso de ajuste de índice e a sua dependência necessária do repositório de consultas, caso o repositório de consultas esteja desativado.

   

4. Aguarde até que a implantação seja concluída com êxito antes de considerar que o recurso está habilitado.

   

5. Depois de habilitar o ajuste de índice, aguarde 12 horas para que o mecanismo de ajuste de índice analise a carga de trabalho coletada pelo armazenamento de consultas durante esse tempo e, eventualmente, produza recomendações de criação ou descartagem de índice.

Importante

Quando o ajuste de índice é ativado por meio do botão Habilitar ajuste de índice , se pg_qs.query_capture_mode estiver definido como NONE, ele é alterado para ALL. Se ele já estava definido como um TOP ou ALL, ele é deixado em seu estado atual.

CLI

Você pode habilitar o ajuste de índice em um servidor existente por meio do comando az postgres flexible-server index-tuning update .

Para habilitar o ajuste de índice, use este comando:

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

Se o comando anterior for executado com êxito, você verá a seguinte saída:

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

Etapas para desativar a otimização de índice

Portais

Usando o portal do Azure:

1. Selecione a sua instância de servidor flexível do Azure Database para PostgreSQL.

2. No menu de recursos, em Desempenho Inteligente, selecione Ajuste de índice.

   

3. Selecione Desativar ajuste de índice para desativar o recurso.

   

4. Aguarde até que a implantação seja concluída com êxito antes de considerar que o recurso está desativado.

   

5. Avalie se deseja continuar usando o Monitorar o desempenho com o repositório de consultas para monitorar o desempenho da sua carga de trabalho e deixá-la habilitada ou, se quiser desativá-la, definindo pg_qs.query_capture_mode como NONE.

Importante

Quando o ajuste de índice é desabilitado por meio do botão Desabilitar ajuste de índice , o parâmetro pg_qs.query_capture_mode do servidor não é definido como NONE, mas deixado como está configurado.

CLI

Você pode desabilitar o ajuste de índice em um servidor existente por meio do comando az postgres flexible-server index-tuning update .

Para desativar o ajuste de índice, use este comando:

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

Se o comando anterior for executado com êxito, você verá a seguinte saída:

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

Avalie se deseja continuar usando o Monitorar o desempenho com o repositório de consultas para monitorar o desempenho da sua carga de trabalho e deixá-la habilitada ou, se quiser desativá-la, definindo pg_qs.query_capture_mode como NONE.

Importante

Quando o ajuste de índice é desativado por meio do comando CLI, o parâmetro do servidor pg_qs.query_capture_mode não é definido como NONE, mas é mantido conforme está configurado.

Passos para mostrar o estado da otimização do índice

Portais

Usando o portal do Azure:

1. Selecione a sua instância de servidor flexível do Azure Database para PostgreSQL.

2. No menu de recursos, em Desempenho Inteligente, selecione Ajuste de índice.

   

3. Se o ajuste de índice estiver habilitado, a página exibirá o botão Desativar ajuste de índice .

   

4. Se o ajuste de índice estiver desativado, a página exibirá o botão Ativar ajuste de índice .

   

CLI

Você pode mostrar o estado do ajuste de índice em um servidor existente por meio do comando az postgres flexible-server index-tuning show .

Para desativar o ajuste de índice, use este comando:

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

Se a otimização de índices estiver ativada, verá a seguinte saída:

WARNING: Index tuning is enabled for the server.

Se o ajuste de índice estiver desativado, você verá a seguinte saída:

WARNING: Index tuning is disabled for the server.

Passos para listar as configurações de ajuste de índice

Portais

Usando o portal do Azure:

1. Selecione a sua instância de servidor flexível do Azure Database para PostgreSQL.

2. No menu de recursos, em Desempenho Inteligente, selecione Ajuste de índice.

   

3. Selecione Configurações de ajuste.

   

CLI

Você pode mostrar o valor de uma única configuração de ajuste de índice em um servidor existente por meio do comando az postgres flexible-server index-tuning show-settings .

Por exemplo, para mostrar o valor da configuração de ajuste de índice chamada analyze_interval, use este comando:

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

O comando retorna todas as informações sobre o parâmetro do servidor correspondente a essa configuração de ajuste de índice e a saída é semelhante à seguinte:

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

Além disso, você pode mostrar a lista de todas as configurações de ajuste de índice em um servidor existente por meio do comando az postgres flexible-server index-tuning list-settings .

Para listar todas as configurações de ajuste de índice, use este comando:

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

O comando retorna todos os parâmetros do servidor que controlam as diferentes configurações de ajuste de índice e a saída é semelhante à seguinte:

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

Etapas para modificar as configurações de ajuste de índice

Portais

Usando o portal do Azure:

1. Selecione a sua instância de servidor flexível do Azure Database para PostgreSQL.

2. No menu de recursos, em Desempenho Inteligente, selecione Ajuste de índice.

   

3. Selecione Configurações de ajuste.

   

4. Modifique os valores de quantas configurações quiser alterar e selecione Salvar.

   

5. Aguarde até que a implantação seja concluída com êxito antes de considerar que o valor das configurações foi alterado.

   

CLI

Você pode modificar o valor de uma única configuração de ajuste de índice em um servidor existente por meio do comando az postgres flexible-server index-tuning set-settings .

Por exemplo, para definir o valor da configuração de ajuste de índice chamada analyze_interval para 1440, use este comando:

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

O comando retorna todas as informações sobre o parâmetro do servidor correspondente a essa configuração de ajuste de índice e a saída é semelhante à seguinte:

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

Conteúdos relacionados

• Ajuste de índice
• Usando recomendações de índice
• Armazenamento de Consultas