Início Rápido: Ligar e consultar com a CLI do Azure com a Base de Dados do Azure para PostgreSQL – Servidor Flexível

  • Artigo

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

Este guia de início rápido demonstra como se conectar a uma instância de servidor flexível do Banco de Dados do Azure para PostgreSQL usando a CLI do Azure com az postgres flexible-server connect e executar uma única consulta ou arquivo sql com az postgres flexible-server execute comando. Este comando permite testar a conectividade com o servidor de banco de dados e executar consultas. Você também pode executar várias consultas usando o modo interativo.

Pré-requisitos

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

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

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

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

Você pode fornecer mais argumentos para esse comando personalizá-lo. Veja todos os argumentos para az postgres flexible-server create.

Ver todos os argumentos

Você pode exibir todos os argumentos para este comando com --help argument.

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 a partir do seu ambiente de desenvolvimento usando 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 tiver sido bem-sucedida.

Successfully connected to server372060240.

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

  • Se o nome de usuário e a senha do administrador do servidor estiverem corretos
  • Se você configurou a regra de firewall para sua máquina cliente
  • Se o servidor estiver configurado com acesso privado com rede virtual, certifique-se de que a máquina cliente está na mesma rede virtual.

Executar várias consultas usando o modo interativo

Você pode executar várias consultas usando o modo interativo . Para ativar 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ê vê a experiência do shell psql como 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 únicas

Você pode executar consultas únicas no banco de dados Postgres usando 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ê vê uma saída como mostrado 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 usando --file-path argument, -f.

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

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

SELECT 1;
SELECT 2;
SELECT 3;

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

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

Você vê uma saída como mostrado aqui:

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

Passos Seguintes

Gerenciar o servidor