Configure o ajuste inteligente para o Banco de Dados do Azure para PostgreSQL – Servidor Flexível usando a CLI do Azure

APLICA-SE A: Banco de Dados do Azure para PostgreSQL - Servidor Flexível

Você pode listar, exibir e atualizar os parâmetros de configuração de ajuste inteligente de uma instância do servidor flexível do Banco de Dados do Azure para PostgreSQL usando a CLI do Azure.

Para saber mais sobre o ajuste inteligente, confira a visão geral.

Pré-requisitos

  • Se você não tiver uma assinatura do Azure, crie uma conta gratuita antes de começar.

  • Instale ou atualize a CLI do Azure para a última versão. Confira Instalar a CLI do Azure.

  • Entre na sua conta do Azure usando o comando az login. Observe que a propriedade id se refere à ID da assinatura da conta do Azure.

    az login
    
  • Se você tiver várias assinaturas, escolha a apropriada na qual você deseja criar o servidor usando o comando az account set:

    az account set --subscription <subscription id>
    
  • Se você ainda não criou uma instância de servidor flexível do Banco de Dados do Azure para PostgreSQL, crie uma usando o comando az postgres flexible-server create:

    az postgres flexible-server create --resource-group myresourcegroup --name myservername
    

Verificar as configurações atuais

Use o comando az postgres flexible-server parameter show para confirmar as configurações atuais do recurso de ajuste inteligente.

Você pode verificar se esse recurso está ativado para o servidor mydemoserver.postgres.database.azure.com no grupo de recursos myresourcegroup por meio do comando a seguir:

az postgres flexible-server parameter show --resource-group myresourcegroup --server-name mydemoserver --name intelligent_tuning --query value

Você pode inspecionar a configuração atual do parâmetro de servidor intelligent_tuning.metric_targets usando o seguinte comando:

az postgres flexible-server parameter show --resource-group myresourcegroup --server-name mydemoserver --name intelligent_tuning.metric_targets --query value

Habilitar o ajuste inteligente

Para habilitar ou desabilitar o ajuste inteligente, use o comando az postgres flexible-server parameter set . Você pode escolher entre os seguintes destinos de ajuste: none, Storage-checkpoint_completion_target, Storage-min_wal_size,Storage-max_wal_size, Storage-bgwriter_delay, tuning-autovacuum e all.

Importante

No momento, o ajuste do Vácuo Automático tem suporte nas camadas de computação do servidor de Uso Geral e Otimizado para Memória com quatro ou mais vCores. Não há suporte para a camada de computação do servidor Com capacidade de intermitência.

  1. Ative o recurso de ajuste inteligente usando o seguinte comando:

    az postgres flexible-server parameter set --resource-group myresourcegroup --server-name mydemoserver --name intelligent_tuning --value ON
    
  2. Selecione os destinos de ajuste que você deseja ativar.

    • Para ativar todos os destinos de ajuste, use comando a seguir:

      az postgres flexible-server parameter set --resource-group myresourcegroup --server-name mydemoserver --name intelligent_tuning.metric_targets --value all
      
    • Para habilitar somente o ajuste de vácuo automático, use o comando a seguir:

      az postgres flexible-server parameter set --resource-group myresourcegroup --server-name mydemoserver --name intelligent_tuning.metric_targets --value tuning-autovacuum
      
    • Para ativar dois destinos de ajuste, use comando a seguir:

      az postgres flexible-server parameter set --resource-group myresourcegroup --server-name mydemoserver --name intelligent_tuning.metric_targets --value tuning-autovacuum,Storage-bgwriter_delay
      

    Se você deseja redefinir o valor de um parâmetro para o padrão, basta excluir o parâmetro opcional --value . Em seguida, o serviço aplica o valor padrão. No exemplo anterior, o comando seria semelhante ao seguinte e definiria intelligent_tuning.metric_targets como none:

    az postgres flexible-server parameter set --resource-group myresourcegroup --server-name mydemoserver --name intelligent_tuning.metric_targets
    

Observação

Os parâmetros de servidor intelligent_tuning e intelligent_tuning.metric_targets são dinâmicos, o que significa que nenhuma reinicialização do servidor é necessária quando seus valores são alterados.

Considerações sobre a seleção de valores para metas de ajuste

Ao escolher os valores do parâmetro do servidor intelligent_tuning.metric_targets, leve em conta as seguintes considerações:

  • O valor NONE tem precedência sobre todos os outros valores. Se você escolher NONE junto com qualquer combinação de outros valores, o parâmetro será percebido como definido como NONE. Isso é equivalente a intelligent_tuning = OFF, portanto, nenhum ajuste ocorre.

  • O valor ALL tem precedência sobre todos os outros valores, com exceção de NONE. Se você escolher ALL com qualquer combinação, exceto NONE, todos os parâmetros listados sofrerão ajuste.

  • O valor ALL abrange todos os destinos de métrica existentes. Esse valor também será aplicado automaticamente aos novos destinos de métrica que você possa adicionar no futuro. Isso permite o ajuste abrangente e preparado para o futuro da instância de servidor flexível do Banco de Dados do Azure para PostgreSQL.

  • Se desejar incluir um destino de ajuste adicional, você precisará especificar os destinos de ajuste existentes e novos. Por exemplo, se bgwriter_delay já estiver habilitado e você quiser adicionar o ajuste de vácuo automático, seu comando deve ser parecido com este:

    az postgres flexible-server parameter set --resource-group myresourcegroup --server-name mydemoserver --name intelligent_tuning.metric_targets --value tuning-autovacuum,Storage-bgwriter_delay
    

    Especificar apenas um novo valor substituiria as configurações atuais. Ao adicionar um novo destino de ajuste, certifique-se sempre de incluir os destinos de ajuste existentes em seu comando.

Próximas etapas