快速入門：使用 ARM 範本建立適用於 PostgreSQL 的 Azure 資料庫 - 單一伺服器。

發行項
08/15/2024

適用於：適用於 PostgreSQL 的 Azure 資料庫 - 單一伺服器

重要

適用於 PostgreSQL 的 Azure 資料庫 - 單一伺服器即將淘汰。強烈建議您升級至適用於 PostgreSQL 的 Azure 資料庫 - 彈性伺服器。如需移轉至適用於 PostgreSQL 的 Azure 資料庫 - 彈性伺服器的詳細資訊，請參閱適用於 PostgreSQL 的 Azure 資料庫單一伺服器會發生什麼情況？ (部分機器翻譯)。

Azure Database for PostgreSQL 是一種受控服務，您用來在雲端執行、管理及調整高可用性的 PostgreSQL 資料庫。在本快速入門中，您會使用 Azure Resource Manager 範本 (ARM 範本) 建立適用於 PostgreSQL 的 Azure 資料庫 - Azure 入口網站、PowerShell 或 Azure CLI 中的單一伺服器。

Azure Resource Manager 範本是一個 JavaScript 物件標記法 (JSON) 檔案，會定義專案的基礎結構和設定。範本使用宣告式語法。您可以描述預期的部署，而不需要撰寫程式設計命令順序來建立部署。

如果您的環境符合必要條件，而且您很熟悉 ARM 範本，請選取 [部署至 Azure] 按鈕。範本會在 Azure 入口網站中開啟。

必要條件

適用於：適用於 PostgreSQL 的 Azure 資料庫 - 單一伺服器

重要

具有有效訂用帳戶的 Azure 帳戶。免費建立一個。

檢閱範本

您可以利用一組已設定計算和儲存體資源建立「適用於 PostgreSQL 的 Azure 資料庫」伺服器。如需詳細資訊，請參閱適用於 PostgreSQL 的 Azure 資料庫定價層 - 單一伺服器。您可在 Azure 資源群組內建立伺服器。

本快速入門中使用的範本是來自 Azure 快速入門範本。

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "metadata": {
    "_generator": {
      "name": "bicep",
      "version": "0.26.54.24096",
      "templateHash": "16694921643873529380"
    }
  },
  "parameters": {
    "serverName": {
      "type": "string",
      "metadata": {
        "description": "Server Name for Azure Database for PostgreSQL"
      }
    },
    "administratorLogin": {
      "type": "string",
      "minLength": 1,
      "metadata": {
        "description": "Database administrator login name"
      }
    },
    "administratorLoginPassword": {
      "type": "securestring",
      "minLength": 8,
      "metadata": {
        "description": "Database administrator password"
      }
    },
    "skuCapacity": {
      "type": "int",
      "defaultValue": 2,
      "metadata": {
        "description": "Azure Database for PostgreSQL compute capacity in vCores (2,4,8,16,32)"
      }
    },
    "skuName": {
      "type": "string",
      "defaultValue": "GP_Gen5_2",
      "metadata": {
        "description": "Azure Database for PostgreSQL sku name "
      }
    },
    "skuSizeMB": {
      "type": "int",
      "defaultValue": 51200,
      "metadata": {
        "description": "Azure Database for PostgreSQL Sku Size "
      }
    },
    "skuTier": {
      "type": "string",
      "defaultValue": "GeneralPurpose",
      "allowedValues": [
        "Basic",
        "GeneralPurpose",
        "MemoryOptimized"
      ],
      "metadata": {
        "description": "Azure Database for PostgreSQL pricing tier"
      }
    },
    "skuFamily": {
      "type": "string",
      "defaultValue": "Gen5",
      "metadata": {
        "description": "Azure Database for PostgreSQL sku family"
      }
    },
    "postgresqlVersion": {
      "type": "string",
      "defaultValue": "11",
      "allowedValues": [
        "9.5",
        "9.6",
        "10",
        "10.0",
        "10.2",
        "11"
      ],
      "metadata": {
        "description": "PostgreSQL version"
      }
    },
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]",
      "metadata": {
        "description": "Location for all resources."
      }
    },
    "backupRetentionDays": {
      "type": "int",
      "defaultValue": 7,
      "metadata": {
        "description": "PostgreSQL Server backup retention days"
      }
    },
    "geoRedundantBackup": {
      "type": "string",
      "defaultValue": "Disabled",
      "metadata": {
        "description": "Geo-Redundant Backup setting"
      }
    },
    "virtualNetworkName": {
      "type": "string",
      "defaultValue": "azure_postgresql_vnet",
      "metadata": {
        "description": "Virtual Network Name"
      }
    },
    "subnetName": {
      "type": "string",
      "defaultValue": "azure_postgresql_subnet",
      "metadata": {
        "description": "Subnet Name"
      }
    },
    "virtualNetworkRuleName": {
      "type": "string",
      "defaultValue": "AllowSubnet",
      "metadata": {
        "description": "Virtual Network RuleName"
      }
    },
    "vnetAddressPrefix": {
      "type": "string",
      "defaultValue": "10.0.0.0/16",
      "metadata": {
        "description": "Virtual Network Address Prefix"
      }
    },
    "subnetPrefix": {
      "type": "string",
      "defaultValue": "10.0.0.0/16",
      "metadata": {
        "description": "Subnet Address Prefix"
      }
    }
  },
  "variables": {
    "firewallrules": [
      {
        "Name": "rule1",
        "StartIpAddress": "0.0.0.0",
        "EndIpAddress": "255.255.255.255"
      },
      {
        "Name": "rule2",
        "StartIpAddress": "0.0.0.0",
        "EndIpAddress": "255.255.255.255"
      }
    ]
  },
  "resources": [
    {
      "type": "Microsoft.DBforPostgreSQL/servers/virtualNetworkRules",
      "apiVersion": "2017-12-01",
      "name": "[format('{0}/{1}', parameters('serverName'), parameters('virtualNetworkRuleName'))]",
      "properties": {
        "virtualNetworkSubnetId": "[resourceId('Microsoft.Network/virtualNetworks/subnets', parameters('virtualNetworkName'), parameters('subnetName'))]",
        "ignoreMissingVnetServiceEndpoint": true
      },
      "dependsOn": [
        "[resourceId('Microsoft.DBforPostgreSQL/servers', parameters('serverName'))]",
        "[resourceId('Microsoft.Network/virtualNetworks/subnets', parameters('virtualNetworkName'), parameters('subnetName'))]"
      ]
    },
    {
      "type": "Microsoft.Network/virtualNetworks",
      "apiVersion": "2023-09-01",
      "name": "[parameters('virtualNetworkName')]",
      "location": "[parameters('location')]",
      "properties": {
        "addressSpace": {
          "addressPrefixes": [
            "[parameters('vnetAddressPrefix')]"
          ]
        }
      }
    },
    {
      "type": "Microsoft.Network/virtualNetworks/subnets",
      "apiVersion": "2023-09-01",
      "name": "[format('{0}/{1}', parameters('virtualNetworkName'), parameters('subnetName'))]",
      "properties": {
        "addressPrefix": "[parameters('subnetPrefix')]"
      },
      "dependsOn": [
        "[resourceId('Microsoft.Network/virtualNetworks', parameters('virtualNetworkName'))]"
      ]
    },
    {
      "type": "Microsoft.DBforPostgreSQL/servers",
      "apiVersion": "2017-12-01",
      "name": "[parameters('serverName')]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "[parameters('skuName')]",
        "tier": "[parameters('skuTier')]",
        "capacity": "[parameters('skuCapacity')]",
        "size": "[format('{0}', parameters('skuSizeMB'))]",
        "family": "[parameters('skuFamily')]"
      },
      "properties": {
        "createMode": "Default",
        "version": "[parameters('postgresqlVersion')]",
        "administratorLogin": "[parameters('administratorLogin')]",
        "administratorLoginPassword": "[parameters('administratorLoginPassword')]",
        "storageProfile": {
          "storageMB": "[parameters('skuSizeMB')]",
          "backupRetentionDays": "[parameters('backupRetentionDays')]",
          "geoRedundantBackup": "[parameters('geoRedundantBackup')]"
        },
        "sslEnforcement": "Enabled",
        "minimalTlsVersion": "TLS1_2"
      }
    },
    {
      "copy": {
        "name": "firewallRules",
        "count": "[length(variables('firewallrules'))]",
        "mode": "serial",
        "batchSize": 1
      },
      "type": "Microsoft.DBforPostgreSQL/servers/firewallRules",
      "apiVersion": "2017-12-01",
      "name": "[format('{0}/{1}', parameters('serverName'), variables('firewallrules')[copyIndex()].Name)]",
      "properties": {
        "startIpAddress": "[variables('firewallrules')[copyIndex()].StartIpAddress]",
        "endIpAddress": "[variables('firewallrules')[copyIndex()].EndIpAddress]"
      },
      "dependsOn": [
        "[resourceId('Microsoft.DBforPostgreSQL/servers', parameters('serverName'))]"
      ]
    }
  ],
  "outputs": {
    "name": {
      "type": "string",
      "value": "[parameters('serverName')]"
    },
    "resourceId": {
      "type": "string",
      "value": "[resourceId('Microsoft.DBforPostgreSQL/servers', parameters('serverName'))]"
    },
    "resourceGroupName": {
      "type": "string",
      "value": "[resourceGroup().name]"
    },
    "location": {
      "type": "string",
      "value": "[parameters('location')]"
    }
  }
}

範本會定義五個 Azure 資源：

在 Azure 快速入門範本中，可找到更多「適用於 PostgreSQL 的 Azure 資料庫」範本範例。

部署範本

適用於：適用於 PostgreSQL 的 Azure 資料庫 - 單一伺服器

重要

選取下列連結，以在 Azure 入口網站中部署「適用於 PostgreSQL 的 Azure 資料庫」伺服器範本：

在使用 VNet 部署適用於 PostgreSQL 的 Azure 資料庫頁面：

針對 [資源群組]，選取 [新建]，然後輸入新資源群組的名稱並選取 [確認]。
如果您已建立新的資源群組，請選取資源群組和新伺服器的位置。
輸入伺服器名稱、管理員登入，以及管理員登入密碼。
如有需要，請變更其他預設設定：
- 訂用帳戶：選取您要讓伺服器使用的 Azure 訂用帳戶。
- SKU 容量：虛擬核心容量，可以是 2 (預設值)、4、8、16、32或 64。
- SKU 名稱：SKU 層前置詞、SKU 系列和 SKU 容量 (以底線連在一起)，例如 B_Gen5_1、GP_Gen5_2 (預設值) 或 MO_Gen5_32。
- SKU 大小 MB：適用於 PostgreSQL 的 Azure 資料庫儲存體大小 (以 MB 為單位，預設為 51200)。
- SKU 層：部署層，例如基本、GeneralPurpose (預設值) 或 MemoryOptimized。
- Sku 系列：Gen4 或 Gen5 (預設值)，表示伺服器部署的硬體生成。
- PostgreSQL 版本：要部署的 PostgreSQL 版本，例如 9.5、9.6、10 或 11 (預設值)。
- 備份保留天數：異地備援備份保留的所需期間 (以天為單位，預設值為 7)。
- 異地備援備份：已啟用或停用 (預設值)，取決於異地災害復原 (Geo-DR) 需求。
- 虛擬網路名稱：虛擬網路的名稱 (預設為 azure_postgresql_vnet)。
- 子網路名稱：子網路的名稱 (預設為 azure_postgresql_subnet)。
- 虛擬網路規則名稱：允許子網路的虛擬網路規則名稱 (預設為 AllowSubnet)。
- VNet 位址前置詞：虛擬網路的位址前置詞 (預設為 10.0.0.0/16)。
- 子網路前置詞：子網路的位址前置詞 (預設為 10.0.0.0/16)。
讀取條款及條件，然後選取 [我同意上方所述的條款及條件]。
選取 [購買] 。

適用於：適用於 PostgreSQL 的 Azure 資料庫 - 單一伺服器

重要

透過下列互動式程式碼，使用範本建立適用於 PostgreSQL 的新 Azure 資料庫伺服器。程式碼會提示您輸入新的伺服器名稱、新資源群組的名稱和位置，以及管理帳戶名稱和密碼。

若要在 Azure Cloud Shell 中執行程式碼，請在任何程式碼區塊的右上角選取 [試用]。

$serverName = Read-Host -Prompt "Enter a name for the new Azure Database for PostgreSQL server"
$resourceGroupName = Read-Host -Prompt "Enter a name for the new resource group where the server will exist"
$location = Read-Host -Prompt "Enter an Azure region (for example, centralus) for the resource group"
$adminUser = Read-Host -Prompt "Enter the Azure Database for PostgreSQL server's administrator account name"
$adminPassword = Read-Host -Prompt "Enter the administrator password" -AsSecureString

New-AzResourceGroup -Name $resourceGroupName -Location $location # Use this command when you need to create a new resource group for your deployment
New-AzResourceGroupDeployment -ResourceGroupName $resourceGroupName `
    -TemplateUri https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.dbforpostgresql/managed-postgresql-with-vnet/azuredeploy.json `
    -serverName $serverName `
    -administratorLogin $adminUser `
    -administratorLoginPassword $adminPassword

Read-Host -Prompt "Press [ENTER] to continue: "

適用於：適用於 PostgreSQL 的 Azure 資料庫 - 單一伺服器

重要

若要在 Azure Cloud Shell 中執行程式碼，請在任何程式碼區塊的右上角選取 [試用]。

read -p "Enter a name for the new Azure Database for PostgreSQL server:" serverName &&
read -p "Enter a name for the new resource group where the server will exist:" resourceGroupName &&
read -p "Enter an Azure region (for example, centralus) for the resource group:" location &&
read -p "Enter the Azure Database for PostgreSQL server's administrator account name:" adminUser &&
read -p "Enter the administrator password:" adminPassword &&
params='serverName='$serverName' administratorLogin='$adminUser' administratorLoginPassword='$adminPassword &&
az group create --name $resourceGroupName --location $location &&
az deployment group create --resource-group $resourceGroupName --parameters $params --template-uri https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.dbforpostgresql/managed-postgresql-with-vnet/azuredeploy.json &&
read -p "Press [ENTER] to continue: "

檢閱已部署的資源

適用於：適用於 PostgreSQL 的 Azure 資料庫 - 單一伺服器

重要

請遵循這些步驟，查看新適用於 PostgreSQL 的 Azure 資料庫伺服器的概觀：

在 Azure 入口網站中，搜尋並選取 [適用於 PostgreSQL 的 Azure 資料庫伺服器]。
在資料庫清單中，選取您的新伺服器。新適用於 PostgreSQL 的 Azure 資料庫伺服器的 [概觀] 頁面隨即出現。

適用於：適用於 PostgreSQL 的 Azure 資料庫 - 單一伺服器

重要

執行下列互動式程式碼以檢視適用於 PostgreSQL 的 Azure 資料庫伺服器詳細資料。您必須輸入新伺服器的名稱。

$serverName = Read-Host -Prompt "Enter the name of your Azure Database for PostgreSQL server"
Get-AzResource -ResourceType "Microsoft.DbForPostgreSQL/servers" -Name $serverName | ft
Read-Host -Prompt "Press [ENTER] to continue: "

適用於：適用於 PostgreSQL 的 Azure 資料庫 - 單一伺服器

重要

執行下列互動式程式碼以檢視適用於 PostgreSQL 的 Azure 資料庫伺服器詳細資料。您必須輸入新伺服器的名稱和資源群組。

read -p "Enter your Azure Database for PostgreSQL server name: " serverName &&
read -p "Enter the resource group where the Azure Database for PostgreSQL server exists: " resourcegroupName &&
az resource show --resource-group $resourcegroupName --name $serverName --resource-type "Microsoft.DbForPostgreSQL/servers" &&
read -p "Press [ENTER] to continue: "

從入口網站匯出 ARM 範本

您可以從 Azure 入口網站匯出 ARM 範本。有兩種方式可以匯出範本：

從資源群組或資源匯出。此選項會從現有資源產生新範本。匯出的範本是資源群組目前狀態的「快照集」。您可以匯出整個資源群組或該資源群組內的特定資源。
部署前匯出或從歷程記錄匯出。此選項會擷取用於部署範本的完整複本。

匯出範本時，在 PostgreSQL 伺服器資源的 "properties":{ } 區段中，您會發現基於安全性理由，不會包含 administratorLogin 和 administratorLoginPassword。您必須在部署範本之前將這些參數新增至範本，否則範本將會失敗。

"resources": [
    {
      "type": "Microsoft.DBforPostgreSQL/servers",
      "apiVersion": "2017-12-01",
      "name": "[parameters('servers_name')]",
      "location": "southcentralus",
      "sku": {
                "name": "B_Gen5_1",
                "tier": "Basic",
                "family": "Gen5",
                "capacity": 1
            },
      "properties": {
        "administratorLogin": "[parameters('administratorLogin')]",
        "administratorLoginPassword": "[parameters('administratorLoginPassword')]",

清除資源

如果不再需要，請刪除資源群組，這會刪除資源群組中的資源。

適用於：適用於 PostgreSQL 的 Azure 資料庫 - 單一伺服器

重要

在 Azure 入口網站中，搜尋並選取 [資源群組]。
在 [資源群組] 清單中，選擇資源群組的名稱。
在資源群組的 [概觀] 頁面中，選取 [刪除資源群組]。
在確認對話方塊凹輸入您的資源群組名稱，然後選取 [刪除]。

適用於：適用於 PostgreSQL 的 Azure 資料庫 - 單一伺服器

重要

$resourceGroupName = Read-Host -Prompt "Enter the Resource Group name"
Remove-AzResourceGroup -Name $resourceGroupName
Read-Host -Prompt "Press [ENTER] to continue: "

適用於：適用於 PostgreSQL 的 Azure 資料庫 - 單一伺服器

重要

read -p "Enter the Resource Group name: " resourceGroupName &&
az group delete --name $resourceGroupName &&
read -p "Press [ENTER] to continue: "

下一步

如需逐步教學課程，以引導您完成建立範本的流程，請參閱：

建立及部署您的第一個 ARM 範本

共用方式為

快速入門：使用 ARM 範本建立適用於 PostgreSQL 的 Azure 資料庫 - 單一伺服器。

必要條件

檢閱範本

部署範本

檢閱已部署的資源

從入口網站匯出 ARM 範本

清除資源

下一步

意見反應

其他資源