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