Gerenciar o Banco de Dados do Azure para PostgreSQL - Servidor Flexível usando a CLI do Azure

  • Artigo

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

Este artigo mostra como gerenciar seu Banco de Dados do Azure para instância de servidor flexível PostgreSQL implantada no Azure. As tarefas de gerenciamento incluem dimensionamento de computação e armazenamento, redefinição de senha de administrador e visualização de detalhes do servidor.

Pré-requisitos

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

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

Inicie sessão na sua conta utilizando o comando az login .

az login

Selecione sua assinatura usando o comando az account set . Anote o valor id da saída az login para usar como o valor para o argumento de assinatura no comando a seguir. Se você tiver várias assinaturas, escolha a assinatura para a qual o recurso deve ser cobrado. Para identificar todas as 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.

Dimensione a computação e o armazenamento

Importante

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

Você pode facilmente escalar sua camada de computação, vCores e armazenamento usando o comando a seguir. Para obter uma lista de todas as operações de servidor que você pode executar, consulte a visão geral do 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 para os argumentos no código anterior:

Definição Valor de exemplo Descrição
nome mydemoserver Insira um nome exclusivo para o servidor. O nome do servidor pode conter apenas letras minúsculas, números e o caráter de hífen (-). Deve conter de 3 a 63 caracteres.
resource-group myresourcegroup Indique o nome do grupo de recursos do Azure.
sku-name Standard_D4ds_v3 Insira o nome da camada de computação e o tamanho. O valor segue a convenção Standard_{VM size} em taquigrafia. Consulte os níveis de preços para obter mais informações.
storage-size 6144 Insira a capacidade de armazenamento do servidor em megabytes. O mínimo é de 5120, aumentando em incrementos de 1024.

Importante

Não é possível reduzir o armazenamento.

Gerenciar bancos de dados 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 de servidor flexível do Banco de Dados do Azure para PostgreSQL. Se o seu computador cliente tiver o PostgreSQL instalado, você poderá usar uma instância local do psql. Vamos agora usar a ferramenta de linha de comando psql para se conectar à instância flexível 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 em seu Banco de Dados do Azure para instância de servidor flexível PostgreSQL mydemoserver.postgres.database.azure.com por meio de suas credenciais de acesso. Quando lhe for pedido, introduza a <server_admin_password> opção que escolheu.

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

    Depois de se conectar, a ferramenta psql exibe um prompt postgres onde você pode inserir comandos SQL. Um aviso aparecerá na saída de conexão inicial se a versão do psql que você está usando for diferente da versão na instância flexível do 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=>

    Gorjeta

    Se a firewall não estiver configurada 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 é necessária. Especifique as opções SSL e tente novamente."

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

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

    CREATE DATABASE postgresdb;

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

    \c postgresdb

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

Nesta seção, você se conectou à instância de 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 de administrador

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

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

Importante

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

  • Letras maiúsculas
  • Letras minúsculas
  • Números
  • Caracteres não alfanuméricos

Excluir um servidor

Para excluir a instância do 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óximos passos