快速入門:使用 Azure CLI 搭配適用於 PostgreSQL 的 Azure 資料庫 來進行連線和查詢 - 彈性伺服器
適用範圍:適用於 PostgreSQL 的 Azure 資料庫 - 彈性伺服器
本快速入門示範如何使用 Azure CLI 搭配使用 Azure CLI 連線az postgres flexible-server connect
到 適用於 PostgreSQL 的 Azure 資料庫 彈性伺服器實例,並使用 命令執行單一查詢或 sql 檔案az postgres flexible-server execute
。 此命令可讓您測試資料庫伺服器的連線並執行查詢。 您也可以使用互動式模式執行多個查詢。
必要條件
- 具有有效訂用帳戶的 Azure 帳戶。 如果您沒有帳戶,請取得免費試用帳戶。
- 安裝 Azure CLI 最新版本。
- 使用 Azure CLI 搭配
az login
命令登入。 - (選擇性)使用
az config param-persist on
開啟實驗性參數持續性。 參數持續性可協助您使用本地內容,而不需要重複許多引數,例如資源群組或位置。
建立 適用於 PostgreSQL 的 Azure 資料庫 彈性伺服器實例
建立的第一件事是受控 適用於 PostgreSQL 的 Azure 資料庫 彈性伺服器實例。 在 Azure Cloud Shell 中,執行下列腳本,並記下從此命令產生的伺服器名稱、**使用者名稱和密碼。
az postgres flexible-server create --public-access <your-ip-address>
您可以為此命令提供更多引數以進行自訂。 請參閱 az postgres flexible-server create 的所有自變數。
檢視所有引數
您可以使用 --help
引數來檢視此命令的所有引數。
az postgres flexible-server connect --help
測試資料庫伺服器連線
您可以使用 az postgres flexible-server connect 命令,從開發環境測試及驗證資料庫的連線。
az postgres flexible-server connect \
-n <servername> -u <username> -p "<password>" -d <databasename>
範例:
az postgres flexible-server connect \
-n server372060240 -u starchylapwing9 -p "dbpassword" -d postgres
如果連線成功,您會看到類似的輸出。
Successfully connected to server372060240.
如果連線失敗,請檢查下列幾點:
- 如果您的伺服器管理員使用者名稱和密碼正確
- 如果您為用戶端電腦設定防火牆規則
- 如果您的伺服器是使用虛擬網路設定私人存取,請確定您的用戶端電腦位於相同的虛擬網路中。
使用互動式模式執行多個查詢
您可以使用互動式模式來執行多個查詢。 若要啟用互動式模式,請執行下列命令。
az postgres flexible-server connect \
-n <servername> -u <username> -p "<password>" -d <databasename> \
--interactive
範例:
az postgres flexible-server connect \
-n server372060240 -u starchylapwing9 -p "dbpassword" -d postgres --interactive
您會看到 psql 殼層體驗,如下所示:
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>
執行單一查詢
您可以使用 az postgres flexible-server execute 對 Postgres 資料庫 執行單一查詢。
az postgres flexible-server execute \
-n <servername> -u <username> -p "<password>" -d <databasename> \
-q <querytext> --output table
範例:
az postgres flexible-server execute \
-n server372060240 -u starchylapwing9 -p "dbpassword" -d postgres \
-q "SELECT 1" --output table
您會看到如下所示的輸出:
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 檔案
您可以使用自變數 -f
,使用 --file-path
az postgres flexible-server execute 命令來執行 sql 檔案。
az postgres flexible-server execute \
-n <server-name> -u <username> -p "<password>" -d <database-name> \
--file-path "<file-path>"
範例: 準備 test.sql
檔案。 您可以使用下列測試文稿搭配簡單的 SELECT
查詢:
SELECT 1;
SELECT 2;
SELECT 3;
將內容儲存至目前目錄中的檔案, test.sql
並使用下列命令執行。
az postgres flexible-server execute \
-n server372060240 -u starchylapwing9 -p "dbpassword" -d postgres \
-f "test.sql"
您會看到如下所示的輸出:
Running sql file 'test.sql'...
Successfully executed the file.
Closed the connection to server372060240