Rychlý start: Připojení a dotazování pomocí Azure CLI s flexibilním serverem Azure Database for PostgreSQL

Tento rychlý start ukazuje, jak se připojit k flexibilnímu serveru Azure Database for PostgreSQL pomocí Azure CLI s az postgres flexible-server connect. Také ukazuje, jak pomocí příkazu spustit jeden dotaz nebo soubor az postgres flexible-server execute SQL. Tento příkaz vám pomůže otestovat připojení k databázovému serveru a spouštět dotazy. Pomocí interaktivního režimu můžete také spouštět více dotazů.

Požadavky

  • Účet Azure s aktivním předplatným. Pokud ho nemáte, můžete získat bezplatnou zkušební verzi.
  • Nainstalujte nejnovější verzi Azure CLI.
  • Přihlaste se pomocí Azure CLI pomocí az login příkazu.
  • (volitelné) Zapněte experimentální trvalost parametrů pomocí .az config param-persist on Trvalost parametru pomáhá používat místní kontext, aniž byste museli opakovat mnoho argumentů, jako je skupina prostředků nebo umístění.

Vytvoření instance Azure Database for PostgreSQL

Nejprve vytvořte spravovaný Azure Database for PostgreSQL flexibilní server. V Azure Cloud Shellu spusťte následující skript. Poznamenejte si název serveru, uživatelské jméno a heslo vygenerované z tohoto příkazu.

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

Pokud chcete příkaz přizpůsobit, zadejte další argumenty. Podívejte se na všechny argumenty pro az postgres flexible-server create.

Zobrazení všech argumentů

Pomocí argumentu --help můžete zobrazit všechny argumenty pro tento příkaz.

az postgres flexible-server connect --help

Testování připojení databázového serveru

Připojení k databázi můžete otestovat a ověřit z vývojového prostředí pomocí příkazu az postgres flexible-server connect .

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

Example:

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

Podobný výstup se zobrazí, pokud je připojení úspěšné.

Successfully connected to server372060240.

Pokud připojení selže, zkontrolujte následující body:

  • Ujistěte se, že uživatelské jméno a heslo správce serveru jsou správné.
  • Ujistěte se, že jste nakonfigurovali pravidlo brány firewall pro klientský počítač.
  • Pokud je váš server nakonfigurovaný s privátním přístupem pomocí virtuálních sítí, ujistěte se, že je váš klientský počítač ve stejné virtuální síti.

Spouštění více dotazů pomocí interaktivního režimu

Pomocí interaktivního režimu můžete spouštět více dotazů. Pokud chcete povolit interaktivní režim, spusťte následující příkaz.

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

Example:

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

Uvidíte prostředí příkazového interpretu psql podobné následujícímu výstupu:

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>

Spouštění jednoduchých dotazů

Spuštěním příkazu az postgres flexible-server můžete spouštět jednotlivé dotazy na databázi Postgres.

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

Example:

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

Zobrazí se výstup, jak je znázorněno v následujícím příkladu:

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

Spuštění souboru SQL

Pomocí příkazu az postgres flexible-server execute s argumentem --file-path-fspusťte soubor SQL.

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

Příklad: Připravte test.sql soubor. Následující testovací skript můžete použít s jednoduchými SELECT dotazy:

SELECT 1;
SELECT 2;
SELECT 3;

Uložte obsah do test.sql souboru v aktuálním adresáři. Pak spuštěním následujícího příkazu spusťte soubor.

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

Zobrazí se výstup, jak je znázorněno v následujícím příkladu:

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