Guia de início rápido: como se conectar ao Banco de Dados do Azure para PostgreSQL – Servidor Flexível e executar consultas nele usando a CLI do Azure

  • Artigo

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

Este início rápido demonstra como se conectar a uma instância de servidor flexível do Banco de Dados do Azure para PostgreSQL utilizando a CLI do Azure com az postgres flexible-server connect e executar uma única consulta ou arquivo SQL com o comando az postgres flexible-server execute. Esse comando permitirá testar a conectividade com o servidor de banco de dados e executar consultas. Também será possível executar várias consultas usando um modo interativo.

Pré-requisitos

  • Uma conta do Azure com uma assinatura ativa. Se você não tiver uma, obtenha uma avaliação gratuita.
  • Instale a CLI do Azure na versão mais recente.
  • Entre utilizando a CLI do Azure com o comando az login.
  • (opcional) Ative a persistência de um parâmetro experimental com az config param-persist on. A persistência de parâmetros ajuda você a usar o contexto local sem precisar repetir vários argumentos, como o grupo de recursos ou a localização.

Criar uma instância de servidor flexível do Banco de Dados do Azure para PostgreSQL

A primeira coisa a ser criada é uma instância gerenciada de servidor flexível do Banco de Dados do Azure para PostgreSQL. No Azure Cloud Shell, execute o script a seguir e anote o nome do servidor, **nome de usuário e senha gerados por esse comando.

az postgres flexible-server create --public-access <your-ip-address>

É possível fornecer argumentos adicionais para esse comando a fim de personalizá-lo. Confira todos os argumentos do comando az postgres flexible-server create.

Exibir todos os argumentos

É possível exibir todos os argumentos desse comando usando o argumento --help.

az postgres flexible-server connect --help

Testar a conexão do servidor de banco de dados

Você pode testar e validar a conexão com o banco de dados em seu ambiente de desenvolvimento utilizando o comando az postgres flexible-server connect.

az postgres flexible-server connect \
    -n <servername> -u <username> -p "<password>" -d <databasename>

Exemplo:

az postgres flexible-server connect \
    -n server372060240 -u starchylapwing9 -p "dbpassword" -d postgres

Você verá uma saída semelhante se a conexão for bem-sucedida.

Successfully connected to server372060240.

Se a conexão falhar, verifique os seguintes pontos:

  • Verifique se o nome de usuário e a senha do administrador do servidor estão corretos
  • se você configurou a regra de firewall para o computador cliente
  • se o servidor estiver configurado com acesso privado com rede virtual, verifique se o computador cliente está na mesma rede virtual.

Executar várias consultas usando um modo interativo

É possível executar várias consultas usando um modo interativo. Para habilitar o modo interativo, execute o seguinte comando.

az postgres flexible-server connect \
    -n <servername> -u <username> -p "<password>" -d <databasename> \
    --interactive

Exemplo:

az postgres flexible-server connect \
    -n server372060240 -u starchylapwing9 -p "dbpassword" -d postgres --interactive

Você verá a experiência do shell psql, conforme mostrado aqui:

Password for starchylapwing9:
Server: PostgreSQL 13.14
Version: 4.0.1
Home: http://pgcli.com
postgres> SELECT 1;
+----------+
| ?column? |
|----------|
| 1        |
+----------+
SELECT 1
Time: 0.167s
postgres>

Executar consultas individuais

Você pode executar consultas individuais no banco de dados Postgres utilizando az postgres flexible-server execute.

az postgres flexible-server execute \
    -n <servername> -u <username> -p "<password>" -d <databasename> \
    -q <querytext> --output table

Exemplo:

az postgres flexible-server execute \
    -n server372060240 -u starchylapwing9 -p "dbpassword" -d postgres \
    -q "SELECT 1" --output table

Você verá uma saída como a mostrada aqui:

Successfully connected to server372060240.
Ran Database Query: 'SELECT 1'
Retrieving first 30 rows of query output, if applicable.
Closed the connection to server372060240
?column?
----------
1

Executar arquivo SQL

Você pode executar um arquivo SQL com o comando az postgres flexible-server execute utilizando o argumento --file-path, -f.

az postgres flexible-server execute \
    -n <server-name> -u <username> -p "<password>" -d <database-name> \
    --file-path "<file-path>"

Exemplo: Preparar um arquivo test.sql. Você pode usar o script de teste a seguir com consultas SELECT simples:

SELECT 1;
SELECT 2;
SELECT 3;

Salve o conteúdo no arquivo test.sql no diretório atual e execute-o utilizando o seguinte comando.

az postgres flexible-server execute \
    -n server372060240 -u starchylapwing9 -p "dbpassword" -d postgres \
    -f "test.sql"

Você verá uma saída como a mostrada aqui:

Running sql file 'test.sql'...
Successfully executed the file.
Closed the connection to server372060240

Próximas etapas

Gerenciar o servidor