Criar um Banco de Dados do Azure para PostgreSQL - Servidor único usando a CLI do Azure

APLICA-SE A: Banco de Dados do Azure para PostgreSQL – Servidor Único

Importante

O Banco de Dados do Azure para PostgreSQL – Servidor Único está prestes a ser desativado. Recomendamos fortemente que você atualize para o Banco de Dados do Azure para PostgreSQL – Servidor flexível. Para obter mais informações sobre a migração para o Banco de Dados do Azure para PostgreSQL – Servidor Flexível, veja O que está acontecendo com o Banco de Dados do Azure para PostgreSQL Servidor único?.

Este artigo mostra como gerenciar seus servidores únicos implantados no Azure. As tarefas de gerenciamento incluem o dimensionamento da computação e do armazenamento, a redefinição de senhas do administrador e a visualização de detalhes do servidor.

Pré-requisitos

Se você não tiver uma assinatura do Azure, crie uma conta gratuita antes de começar. Este artigo exige que você esteja executando a CLI do Azure versão 2.0 ou posterior localmente. Para ver a versão instalada, execute o comando az --version. Se você precisa instalar ou atualizar, consulte Instalar a CLI do Azure.

Você precisará fazer logon em sua conta usando o comando az login. Observe a propriedade id, que se refere à ID da Assinatura para sua conta do Azure.

az login

Selecione a assinatura específica em sua conta usando o comando az account set. Anote o valor de id da saída az login para usar como valor para o argumento subscription no comando. Se tiver várias assinaturas, escolha a que for adequada para cobrança do recurso. Para obter todas as suas assinaturas, use az account list.

az account set --subscription <subscription id>

Caso ainda não tenha criado um servidor, crie um seguindo este guia de início rápido.

Azure Cloud Shell

O Azure hospeda o Azure Cloud Shell, um ambiente de shell interativo que pode ser usado por meio do navegador. É possível usar o bash ou o PowerShell com o Cloud Shell para trabalhar com os serviços do Azure. É possível usar os comandos pré-instalados do Cloud Shell para executar o código neste artigo, sem precisar instalar nada no seu ambiente local.

Para iniciar o Azure Cloud Shell:

Opção Exemplo/Link
Selecione Experimentar no canto superior direito de um bloco de código ou de comando. Selecionar Experimentar não copia automaticamente o código nem o comando para o Cloud Shell. Captura de tela que mostra um exemplo de Experimente para o Azure Cloud Shell.
Acesse https://shell.azure.com ou selecione o botão Iniciar o Cloud Shell para abri-lo no navegador. Botão para iniciar o Azure Cloud Shell.
Selecione o botão Cloud Shell na barra de menus no canto superior direito do portal do Azure. Captura de tela que mostra o botão Cloud Shell no portal do Azure

Para usar o Azure Cloud Shell:

  1. Inicie o Cloud Shell.

  2. Selecione o botão Copiar em um bloco de código (ou bloco de comando) para copiar o código ou o comando.

  3. Cole o código ou comando na sessão do Cloud Shell selecionando Ctrl+Shift+V no Windows e no Linux, ou selecionando Cmd+Shift+V no macOS.

  4. Pressione Enter para executar o código ou o comando.

Dimensionar a computação e o armazenamento

É possível dimensionar facilmente o tipo de preço, a computação e o armazenamento seguindo o comando a seguir. Para ver todas as operações do servidor, execute visão geral do servidor az postgres

az postgres server update --resource-group myresourcegroup --name mydemoserver --sku-name GP_Gen5_4 --storage-size 6144

Estes são os detalhes dos argumentos acima:

Configuração Valor de exemplo Descrição
name mydemoserver Insira um nome exclusivo que para o servidor Banco de Dados do Azure para PostgreSQL. O nome do servidor pode conter apenas letras minúsculas, números e o caractere de hífen (-). Ele deve conter de 3 a 63 caracteres.
resource-group myresourcegroup Forneça o nome do grupo de recursos do Azure.
sku-name GP_Gen5_2 Insira o nome do tipo de preço e a configuração de computação. Segue a convenção {tipo de preço} {geração de computação} {vCores} em formato abreviado. Confira os tipos de preço para obter mais informações.
storage-size 6144 A capacidade de armazenamento do servidor (a unidade é megabytes). Mínimo de 5120 e aumentos em incrementos de 1024.

Importante

  • O armazenamento pode ser ampliado (mas não pode ser reduzido)
  • Não há suporte para dimensionar o tipo de preço Básico para Uso geral ou Com otimização de memória. Você pode realizar o dimensionamento manual usando um script bash ou usando o PostgreSQL Workbench

Gerencie bancos de dados PostgreSQL em um servidor.

Você pode usar qualquer um destes comandos para criar, excluir, listar e ver as propriedades de um banco de dados em seu servidor

Cmdlet Uso Descrição
az postgres db create az postgres db create -g myresourcegroup -s mydemoserver -n mydatabasename Cria um banco de dados
az postgres db delete az postgres db delete -g myresourcegroup -s mydemoserver -n mydatabasename Exclua seu banco de dados do servidor. Esse comando não exclui o servidor.
az postgres db list az postgres db list -g myresourcegroup -s mydemoserver Lista todos os bancos de dados no servidor
az postgres db show az postgres db show -g myresourcegroup -s mydemoserver -n mydatabasename Mostra mais detalhes do banco de dados

Atualizar a senha do administrador

Você pode alterar a senha da função de administrador com este comando

az postgres server update --resource-group myresourcegroup --name mydemoserver --admin-password <new-password>

Importante

Verifique se a senha tem no mínimo oito caracteres e no máximo 128. A senha deve conter caracteres de três das categorias a seguir: letras maiúsculas, letras minúsculas, números e caracteres não alfanuméricos.

Excluir um servidor

Se desejar simplesmente excluir o servidor único do PostgreSQL, será possível executar o comando az postgres server delete.

az postgres server delete --resource-group myresourcegroup --name mydemoserver

Próximas etapas