Delen via


Quickstart: verbinding maken en query's uitvoeren met Azure CLI met Azure Database for PostgreSQL - flexibele server

VAN TOEPASSING OP: Azure Database for PostgreSQL - Flexibele server

In deze quickstart ziet u hoe u verbinding maakt met een exemplaar van een flexibele Azure Database for PostgreSQL-server met behulp van Azure CLI en az postgres flexible-server connect één query of sql-bestand uitvoert met een az postgres flexible-server execute opdracht. Met deze opdracht kunt u de verbinding met uw databaseserver testen en query's uitvoeren. U kunt ook meerdere query's uitvoeren met behulp van de interactieve modus.

Vereisten

  • Een Azure-account met een actief abonnement. Als u geen account hebt, kunt u een gratis proefversie krijgen.
  • Installeer de nieuwste versie van Azure CLI .
  • Meld u aan met behulp van Azure CLI met az login de opdracht.
  • (optioneel) Schakel een experimentele parameterpersistentie in met az config param-persist on. Parameterpersistentie helpt u bij het gebruik van lokale context zonder dat u meerdere argumenten zoals resourcegroep of locatie hoeft te herhalen.

Azure Database for PostgreSQL Flexible Server-exemplaar maken

Het eerste wat u moet maken, is een beheerd exemplaar van een flexibele Azure Database for PostgreSQL-server. Voer in Azure Cloud Shell het volgende script uit en noteer de servernaam, **gebruikersnaam en wachtwoord die zijn gegenereerd op basis van deze opdracht.

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

U kunt meer argumenten opgeven voor deze opdracht om deze aan te passen. Bekijk alle argumenten voor az postgres flexible-server create.

Alle argumenten weergeven

U kunt alle argumenten voor deze opdracht met --help argument weergeven.

az postgres flexible-server connect --help

Verbinding met databaseserver testen

U kunt de verbinding met de database vanuit uw ontwikkelomgeving testen en valideren met behulp van de opdracht az postgres flexible-server connect .

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

Voorbeeld:

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

U ziet vergelijkbare uitvoer als de verbinding is geslaagd.

Successfully connected to server372060240.

Als de verbinding is mislukt, controleert u de volgende punten:

  • als de gebruikersnaam en het wachtwoord van de serverbeheerder juist zijn
  • als u een firewallregel voor uw clientcomputer hebt geconfigureerd
  • als uw server is geconfigureerd met privétoegang met virtuele netwerken, moet u ervoor zorgen dat uw clientcomputer zich in hetzelfde virtuele netwerk bevindt.

Meerdere query's uitvoeren met behulp van de interactieve modus

U kunt meerdere query's uitvoeren met behulp van de interactieve modus. Voer de volgende opdracht uit om de interactieve modus in te schakelen.

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

Voorbeeld:

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

U ziet de psql-shell-ervaring , zoals hier wordt weergegeven:

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>

Enkelvoudige query's uitvoeren

U kunt enkele query's uitvoeren op de Postgres-database met behulp van az postgres flexible-server execute.

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

Voorbeeld:

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

U ziet een uitvoer zoals hier wordt weergegeven:

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

SQL-bestand uitvoeren

U kunt een SQL-bestand uitvoeren met de opdracht az postgres flexible-server execute using --file-path argument, -f.

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

Voorbeeld: Een test.sql bestand voorbereiden. U kunt het volgende testscript gebruiken met eenvoudige SELECT query's:

SELECT 1;
SELECT 2;
SELECT 3;

Sla de inhoud op in het test.sql bestand in de huidige map en voer deze uit met behulp van de volgende opdracht.

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

U ziet een uitvoer zoals hier wordt weergegeven:

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

Volgende stappen