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
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