Szybki start: Łączenie się z usługą Azure Database for PostgreSQL — serwer elastyczny i wykonywanie zapytań przy użyciu interfejsu wiersza polecenia platformy Azure

  • Artykuł

DOTYCZY: Azure Database for PostgreSQL — serwer elastyczny

W tym przewodniku Szybki start pokazano, jak nawiązać połączenie z elastycznym wystąpieniem serwera usługi Azure Database for PostgreSQL przy użyciu interfejsu wiersza polecenia az postgres flexible-server connect platformy Azure i wykonać pojedyncze zapytanie lub plik SQL za az postgres flexible-server execute pomocą polecenia . To polecenie umożliwia testowanie łączności z serwerem bazy danych i uruchamianie zapytań. Można również uruchamiać wiele zapytań przy użyciu trybu interaktywnego.

Wymagania wstępne

  • Konto platformy Azure z aktywną subskrypcją. Jeśli go nie masz, skorzystaj z bezpłatnej wersji próbnej.
  • Zainstaluj najnowszą wersję interfejsu wiersza polecenia platformy Azure.
  • Zaloguj się przy użyciu interfejsu wiersza polecenia platformy Azure za az login pomocą polecenia .
  • (opcjonalnie) Włącz eksperymentalną trwałość parametru za pomocą polecenia az config param-persist on. Trwałość parametrów pomaga używać kontekstu lokalnego bez konieczności powtarzania wielu argumentów, takich jak grupa zasobów lub lokalizacja.

Tworzenie wystąpienia serwera elastycznego usługi Azure Database for PostgreSQL

Pierwszą rzeczą do utworzenia jest zarządzane wystąpienie serwera elastycznego usługi Azure Database for PostgreSQL. W usłudze Azure Cloud Shell uruchom następujący skrypt i zanotuj nazwę serwera, **nazwę użytkownika i hasło wygenerowane na podstawie tego polecenia.

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

Aby dostosować to polecenie, możesz podać więcej argumentów. Zobacz wszystkie argumenty polecenia az postgres flexible-server create.

Wyświetl wszystkie argumenty

Wszystkie argumenty dla tego polecenia można wyświetlić za pomocą --help argumentu .

az postgres flexible-server connect --help

Testowanie połączenia serwera bazy danych

Możesz przetestować i zweryfikować połączenie z bazą danych ze środowiska deweloperskiego przy użyciu polecenia az postgres flexible-server connect .

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

Przykład:

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

Jeśli połączenie zakończyło się pomyślnie, zobaczysz podobne dane wyjściowe.

Successfully connected to server372060240.

Jeśli połączenie nie powiodło się, sprawdź następujące kwestie:

  • jeśli nazwa użytkownika i hasło administratora serwera są poprawne
  • Jeśli skonfigurowano regułę zapory dla maszyny klienckiej
  • Jeśli serwer jest skonfigurowany z dostępem prywatnym z siecią wirtualną, upewnij się, że maszyna kliencka znajduje się w tej samej sieci wirtualnej.

Uruchamianie wielu zapytań przy użyciu trybu interaktywnego

Można uruchomić wiele zapytań przy użyciu trybu interaktywnego. Aby włączyć tryb interaktywny, uruchom następujące polecenie.

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

Przykład:

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

Zobaczysz środowisko powłoki psql , jak pokazano poniżej:

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>

Wykonywanie pojedynczych zapytań

Można uruchamiać pojedyncze zapytania względem bazy danych Postgres przy użyciu polecenia az postgres flexible-server execute.

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

Przykład:

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

Zobaczysz dane wyjściowe, jak pokazano poniżej:

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

Uruchamianie pliku SQL

Plik SQL można wykonać za pomocą polecenia az postgres flexible-server execute przy użyciu --file-path argumentu -f.

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

Przykład: przygotowanie test.sql pliku. Możesz użyć następującego skryptu testowego z prostymi SELECT zapytaniami:

SELECT 1;
SELECT 2;
SELECT 3;

Zapisz zawartość w test.sql pliku w bieżącym katalogu i wykonaj polecenie przy użyciu następującego polecenia.

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

Zobaczysz dane wyjściowe, jak pokazano poniżej:

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

Następne kroki

Zarządzanie serwerem