快速入門:使用 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 的名稱。 遵循慣例 {定價層}_{compute generation}_{vCores} 的速記。 預設值為具有 2 個虛擬核心的一般用途 Gen5 伺服器。 如需階層的詳細資訊,請參閱我們的 定價頁面 。 |
backup-retention | 7 | 保留備份的時間長度。 單位為天。 |
異地備援備份 | 停用 | 是否應該為此伺服器啟用異地備援備份。 |
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 服務] 設定為 ON。 此設定會將伺服器的防火牆設定為接受來自所有 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