快速入門:使用 az postgres up 命令,建立適用於 PostgreSQL 的 Azure 資料庫 - 單一伺服器
適用於:適用於 PostgreSQL 的 Azure 資料庫 - 單一伺服器
重要
適用於 PostgreSQL 的 Azure 資料庫 - 單一伺服器即將淘汰。 強烈建議您升級至適用於 PostgreSQL 的 Azure 資料庫 - 彈性伺服器。 如需移轉至適用於 PostgreSQL 的 Azure 資料庫 - 彈性伺服器的詳細資訊,請參閱適用於 PostgreSQL 的 Azure 資料庫單一伺服器會發生什麼情況? (部分機器翻譯)。
「適用於 PostgreSQL 的 Azure 資料庫」是一個受控服務,可讓您在雲端執行、管理及調整高可用性 PostgreSQL 資料庫。 Azure CLI 用來從命令列或在指令碼中建立和管理 Azure 資源。 本快速入門說明如何使用 az postgres up 命令,使用 Azure CLI 建立適用於 PostgreSQL 的 Azure 資料庫。 除了建立伺服器,az postgres up
命令還會建立範例資料庫、資料庫中的根使用者、開啟 Azure 服務的防火牆,以及建立用戶端電腦的預設防火牆規則。 這些預設值有助於加速開發程序。
如果您沒有 Azure 訂閱,請在開始之前,先建立 Azure 免費帳戶。
建立適用於 PostgreSQL 的 Azure 資料庫伺服器
必要條件
在 Azure Cloud Shell 中使用 Bash 環境。 如需詳細資訊,請參閱 Azure Cloud Shell 中的 Bash 快速入門。
若要在本地執行 CLI 參考命令,請安裝 Azure CLI。 若您在 Windows 或 macOS 上執行,請考慮在 Docker 容器中執行 Azure CLI。 如需詳細資訊,請參閱〈如何在 Docker 容器中執行 Azure CLI〉。
如果您使用的是本機安裝,請使用 az login 命令,透過 Azure CLI 來登入。 請遵循您終端機上顯示的步驟,完成驗證程序。 如需其他登入選項,請參閱使用 Azure CLI 登入。
出現提示時,請在第一次使用時安裝 Azure CLI 延伸模組。 如需擴充功能詳細資訊,請參閱使用 Azure CLI 擴充功能。
執行 az version 以尋找已安裝的版本和相依程式庫。 若要升級至最新版本,請執行 az upgrade。
啟動 Azure Cloud Shell
Azure Cloud Shell 是免費的互動式 Shell,可讓您用來執行本文中的步驟。 它具有預先安裝和設定的共用 Azure 工具,可與您的帳戶搭配使用。
若要開啟 Cloud Shell,只要選取程式碼區塊右上角的 [試試看] 即可。 您也可以移至 https://shell.azure.com ,從另一個瀏覽器索引標籤啟動 Cloud Shell。
當開啟 Cloud Shell 時,請確認已為您的環境選取 Bash。 後續的工作階段將會在 Bash 環境中使用 Azure CLI,請選取 [複製] 以複製程式碼區塊,並將其貼到 Cloud Shell 中,然後按 Enter 鍵加以執行。
登入 Azure
系統會在登入的初始帳戶下自動驗證 Cloud Shell。 使用下列指令碼透過不同的訂閱登入,並將 <Subscription ID>
取代為您的 Azure 訂用帳戶識別碼。 如果您沒有 Azure 訂用帳戶,請在開始之前先建立 Azure 免費帳戶。
subscription="<subscriptionId>" # add subscription here
az account set -s $subscription # ...or use 'az login'
安裝 db-up 延伸模組。 如果傳回錯誤,請確定您已安裝最新版的 Azure CLI。 請參閱安裝 Azure CLI。
az extension add --name db-up
使用下列命令建立適用於 PostgreSQL 的 Azure 資料庫伺服器:
az postgres up
伺服器會以下列預設值來建立 (除非您手動覆寫它們):
設定 | 預設值 | 說明 |
---|---|---|
server-name | 由系統產生 | 可識別 Azure Database for PostgreSQL 伺服器的唯一名稱。 |
資源群組 | 由系統產生 | 新的 Azure 資源群組。 |
sku-name | GP_Gen5_2 | SKU 的名稱。 遵循速記的慣例 {pricing tier}_{compute generation}_{vCores}。 預設是一部一般用途、具有 2 個 vCore 的第 5 代伺服器。 如需關於價格的詳細資訊,請參閱定價頁面。 |
backup-retention | 7 | 保留備份的時間長度。 單位為天。 |
geo-redundant-backup | 停用 | 是否應針對此伺服器啟用異地備援備份。 |
location | westus2 | 伺服器的 Azure 位置。 |
ssl-enforcement | 已停用 | 是否應針對此伺服器啟用 TLS/SSL。 |
storage-size | 5120 | 伺服器的儲存體容量 (單位為 MB)。 |
version | 10 | PostgreSQL 主要版本。 |
admin-user | 由系統產生 | 系統管理員的使用者名稱。 |
admin-password | 由系統產生 | 系統管理員使用者的密碼。 |
注意
如需有關 az postgres up
命令及其額外參數的詳細資訊,請參閱 Azure CLI 文件。
您的伺服器建立好之後,它會隨附下列設定:
- 會建立名為 "devbox" 的防火牆規則。 Azure CLI 會嘗試偵測
az postgres up
命令執行來源的電腦 IP 位址並允許該 IP 位址。 - [允許存取 Azure 服務] 設為 [開啟]。 此設定會將伺服器的防火牆設定為接受來自所有 Azure 資源的連線,其中也包括您未訂閱的資源。
- 建立名為 "sampledb" 的空白資料庫
- 建立名為 "root",且具有 "sampledb" 權限的新使用者
注意
適用於 PostgreSQL 的 Azure 資料庫會透過連接埠 5432 進行通訊。 當您從公司網路內進行連線時,網路的防火牆可能不允許透過連接埠 5432 的輸出流量。 請要求您的 IT 部門開放連接埠 5432,以連線至您的伺服器。
取得連線資訊
完成 az postgres up
命令之後,熱門程式語言的連接字串清單就會傳回給您。 這些連接字串是使用您新建立的適用於 PostgreSQL 的 Azure 資料庫伺服器的特定屬性預先設定的。
您可以使用 az postgres show-connection-string 命令,再次列出這些連接字串。
清除資源
使用下列命令清除您在快速入門中建立的所有資源。 此命令會刪除適用於 PostgreSQL 的 Azure 資料庫伺服器和資源群組。
az postgres down --delete-group
如果您只想要刪除新建立的伺服器,可以執行 az postgres down 命令。
az postgres down