Configurar a configuração inteligente para a Base de Dados Azure para PostgreSQL utilizando o Azure CLI

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

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

Pré-requisitos

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

• Instale ou atualize a CLI do Azure para a versão mais recente. Consulte Instalar a CLI do Azure.

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

  az login
  

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

  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 az postgres flexible-server create comando:

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

Verificar as definiçõ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 myresourcegroup de recursos usando o seguinte comando:

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 server 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

Habilite 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-autovacuume all.

Importante

O ajuste de vácuo automático é atualmente suportado para as camadas de computação de servidor de uso geral e memória otimizada que têm quatro ou mais vCores. A camada de computação do servidor Burstable não é suportada.

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 o seguinte comando:

     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 seguinte comando:

     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 o seguinte comando:

     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ê quiser 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 teria a seguinte aparência e seria definido intelligent_tuning.metric_targets como none:

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

Nota

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

Considerações para selecionar valores para ajustar destinos

Ao escolher valores do intelligent_tuning.metric_targets parâmetro server, leve em consideração as seguintes considerações:

• O NONE valor tem precedência sobre todos os outros valores. Se você escolher NONE ao lado de 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 ALL valor 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 passam por ajustes.

• O ALL valor engloba todos os destinos métricos existentes. Esse valor também se aplica automaticamente a quaisquer novos destinos de métrica que você possa adicionar no futuro. Isso permite um ajuste abrangente e preparado para o futuro do seu Banco de Dados do Azure para a instância flexível do servidor PostgreSQL.

• Se quiser incluir outro destino de ajuste, especifique os destinos de ajuste existentes e novos. Por exemplo, se bgwriter_delay já estiver ativado e pretender adicionar o ajuste de vácuo automático, o comando deverá ter o seguinte aspeto:

  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.

Conteúdos relacionados

• Execute o ajuste inteligente no Banco de Dados do Azure para PostgreSQL.