快速入門：使用 Azure CLI 搭配適用於 PostgreSQL 的 Azure 資料庫 來進行連線和查詢 - 彈性伺服器
適用範圍：
適用於 PostgreSQL 的 Azure 資料庫 - 彈性伺服器
本快速入門示範如何使用 Azure CLI 搭配 az postgres flexible-server connect 連線至適用於 PostgreSQL 的 Azure 資料庫彈性伺服器執行個體，並使用 az postgres flexible-server execute 命令執行單一查詢或 sql 檔案。 此命令可讓您測試資料庫伺服器的連線並執行查詢。 您也可以使用互動式模式執行多個查詢。
必要條件
- 具有有效訂用帳戶的 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 檔案
您可以使用 --file-path 參數 -f，透過 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