Compartilhar via

Gerenciar um Servidor flexível do Banco de Dados do Azure para PostgreSQL usando a CLI do Azure

  • Artigo

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

Este artigo mostra como gerenciar sua instância de Servidor flexível do Banco de Dados do Azure para MySQL 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.

Você precisará executar a CLI do Azure versão 2.0 ou posterior, localmente. Para ver a versão instalada, execute o comando az --version. Se você precisar instalar ou atualizar, confira Instalar a CLI do Azure.

Entre na sua conta usando o comando az login.

az login

Selecione uma assinatura usando o comando az account set. Anote o valor de id da saída de az login para usá-lo como o valor para o argumento subscription no comando a seguir. Se tiver várias assinaturas, escolha aquela para cobrança do recurso. Para identificar todas suas assinaturas, use o comando az account list.

az account set --subscription <subscription id>

Importante

Se você ainda não criou a instância de Servidor flexível do Banco de Dados do Azure para PostgreSQL, precisará fazer isso para seguir este guia de instruções.

Dimensionar a computação e o armazenamento

Importante

Para dimensionar o armazenamento ou a computação, você deve ter no mínimo a permissão READ no grupo de recursos proprietário.

Você pode dimensionar sua camada de computação, vCores e armazenamento facilmente usando o comando a seguir. Para obter uma lista de todas as operações de servidor que você pode executar, confira a visão geral de az postgres flexible-server.

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

A seguir estão os detalhes dos argumentos no código anterior:

Configuração Valor de exemplo Descrição
name mydemoserver Insira um nome exclusivo para o seu servidor. O nome do servidor pode conter apenas letras minúsculas, números e o caractere de hífen (-). Ele precisa conter de 3 a 63 caracteres.
resource-group myresourcegroup Forneça o nome do grupo de recursos do Azure.
sku-name Standard_D4ds_v3 Insira o nome do tamanho e da camada de computação. O valor segue a convenção Standard_{VM size} abreviadamente. Confira os tipos de preço para obter mais informações.
storage-size 32768 Insira a capacidade de armazenamento do servidor em megabytes. O tamanho mínimo de armazenamento é 32768,

Importante

Não é possível reduzir verticalmente o armazenamento.

Gerenciar bancos de dados de Servidor flexíveis do Banco de Dados do Azure para PostgreSQL em um servidor

Há vários aplicativos que você pode usar para se conectar à sua instância do servidor flexível do Banco de Dados do Azure para PostgreSQL. Se o computador cliente tiver o PostgreSQL instalado, você poderá usar uma instância local do psql. Usaremos agora o utilitário de linha de comando psql para nos conectarmos à instância do Servidor flexível do Banco de Dados do Azure para PostgreSQL.

  1. Execute o seguinte comando psql:

    psql --host=<servername> --port=<port> --username=<user> --dbname=<dbname>

    Por exemplo, o comando a seguir se conecta ao banco de dados padrão chamado postgres na sua instância do Servidor flexível do Banco de Dados do Azure para PostgreSQL mydemoserver.postgres.database.azure.com usando as credenciais de acesso. Quando for solicitado, insira a <server_admin_password> que você escolheu.

    psql --host=mydemoserver.postgres.database.azure.com --port=5432 --username=myadmin --dbname=postgres

    Depois que você se conectar, a ferramenta psql exibirá um prompt do postgres no qual você digitará os comandos do SQL. Um aviso será exibido na saída de conexão inicial se a versão do psql que você está usando for diferente da versão no Servidor do Banco de Dados do Azure para PostgreSQL.

    Exemplo de saída psql:

    psql (11.3, server 12.1)
WARNING: psql major version 11, server major version 12.
         Some psql features might not work.
SSL connection (protocol: TLSv1.2, cipher: ECDHE-RSA-AES256-GCM-SHA384, bits: 256, compression: off)
Type "help" for help.

postgres=>

    Dica

    Se o firewall não está configurado para permitir o endereço IP do seu cliente, ocorre o seguinte erro:

    "psql: FATAL: nenhuma entrada pg_hba.conf para host <IP address>, usuário "myadmin", banco de dados"postgres", SSL em FATAL: conexão SSL requerida. Especifique as opções de SSL e tente novamente”.

    Confirme se o endereço IP do seu cliente é permitido nas regras de firewall.

  2. Crie um banco de dados chamado postgresdb em branco digitando o seguinte comando no prompt:

    CREATE DATABASE postgresdb;

  3. No prompt, execute o seguinte comando para mudar as conexões para o banco de dados postgresdb recém-criado:

    \c postgresdb

  4. Digite \q e selecione Enter para sair do psql.

Você está conectado à instância do Servidor flexível do Banco de Dados do Azure para PostgreSQL via psql e criou um banco de dados de usuário em branco.

Redefinir a senha do administrador

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

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

Importante

Escolha uma senha que tenha um mínimo de 8 caracteres e um máximo de 128 caracteres. A senha precisa conter caracteres de três das seguintes categorias:

  • Letras maiúsculas do alfabeto inglês
  • Letras minúsculas do alfabeto inglês
  • Números
  • Caractere não alfanumérico

Excluir um servidor

Para excluir o Servidor flexível do Banco de Dados do Azure para PostgreSQL, execute o comando az postgres flexible-server delete.

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

Próximas etapas