Mulai cepat: Menyambungkan dan mengkueri dengan menggunakan Azure CLI dengan server fleksibel Azure Database for PostgreSQL

Panduan mulai cepat ini menjelaskan cara tersambung ke Azure Database for PostgreSQL Flexible Server menggunakan Azure CLI dengan az postgres flexible-server connect. Ini juga menunjukkan cara menjalankan satu kueri atau file SQL dengan menggunakan az postgres flexible-server execute perintah . Perintah ini membantu Anda menguji konektivitas ke server database Anda dan menjalankan kueri. Anda juga dapat menjalankan beberapa kueri dengan menggunakan mode interaktif.

Prasyarat

  • Sebuah akun Azure dengan langganan aktif. Jika Anda tidak memilikinya, dapatkan uji coba gratis.
  • Pasang versi terbaru Azure CLI.
  • Masuk dengan menggunakan perintah az login di Azure CLI.
  • (opsional) Aktifkan persistensi parameter eksperimental dengan menggunakan az config param-persist on. Persistensi parameter membantu Anda menggunakan konteks lokal tanpa harus mengulangi banyak argumen seperti grup sumber daya atau lokasi.

Buat instans Azure Database for PostgreSQL

Pertama, buat server fleksibel Azure Database for PostgreSQL terkelola. Di Azure Cloud Shell, jalankan skrip berikut. Catat nama server, nama pengguna, dan kata sandi yang dihasilkan dari perintah ini.

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

Untuk menyesuaikan perintah, berikan lebih banyak argumen. Lihat semua argumen untuk az postgres flexible-server create.

Menampilkan semua argumen

Anda dapat melihat semua argumen untuk perintah ini dengan menggunakan --help argumen .

az postgres flexible-server connect --help

Menguji koneksi server database

Anda dapat menguji dan memvalidasi koneksi ke database dari lingkungan pengembangan Anda dengan menggunakan perintah 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

Anda akan melihat output serupa jika koneksi berhasil.

Successfully connected to server372060240.

Jika koneksi gagal, periksa poin-poin berikut:

  • Pastikan nama pengguna dan kata sandi administrator server Anda sudah benar.
  • Pastikan Anda mengonfigurasi aturan firewall untuk komputer klien Anda.
  • Jika server Anda dikonfigurasi dengan akses privat dengan menggunakan jaringan virtual, pastikan komputer klien Anda berada di jaringan virtual yang sama.

Menjalankan beberapa kueri dengan menggunakan mode interaktif

Anda dapat menjalankan beberapa kueri dengan menggunakan mode interaktif . Untuk mengaktifkan mode interaktif, jalankan perintah berikut.

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

Anda melihat pengalaman shell psql yang mirip dengan output berikut:

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>

Menjalankan kueri tunggal

Gunakan az postgres flexible-server execute untuk menjalankan kueri tunggal terhadap database 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

Anda melihat output seperti yang ditunjukkan dalam contoh berikut:

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

Jalankan file SQL

Gunakan perintah az postgres flexible-server execute dengan --file-path argumen , -f, untuk menjalankan file SQL.

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

Contoh: Menyiapkan test.sql file. Anda dapat menggunakan skrip pengujian berikut dengan kueri sederhana SELECT :

SELECT 1;
SELECT 2;
SELECT 3;

Simpan isi ke test.sql file di direktori saat ini. Kemudian, jalankan perintah berikut untuk menjalankan file.

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

Anda melihat output seperti yang ditunjukkan dalam contoh berikut:

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