Quickstart: Een flexibele Azure Database for PostgreSQL-server maken

Azure Database for PostgreSQL is een beheerde service die u kunt gebruiken om PostgreSQL-databases met hoge beschikbaarheid in de cloud uit te voeren, te beheren en te schalen.

In deze quickstart ziet u hoe u een exemplaar van een flexibele Azure Database for PostgreSQL-server maakt met behulp van azure Portal, Azure CLI of ARM-sjablonen (Azure Resource Manager).

Vereiste voorwaarden

Zorg ervoor dat u voordat u begint de volgende zaken paraat hebt:

• Een Azure-abonnement. Als u er nog geen hebt, maakt u een gratis Azure-account.
• Juiste machtigingen voor het maken van resources in uw abonnement.

Begrijpen wat u maakt

Een exemplaar van een flexibele Azure Database for PostgreSQL-server omvat:

• Een geconfigureerde set reken- en opslagresources.
• Implementatie binnen een Azure-resourcegroep.
• Een postgres database die standaard is gemaakt.
• Een azure_maintenance database voor beheerde serviceprocessen.
• Een azure_sys database voor queryopslag en indexafstemmingsfuncties.

Server maken met behulp van Azure Portal

Navigeer naar de maak-wizard

1. Meld u aan bij het Azure-portaal.
2. Selecteer Een resource maken in de linkerbovenhoek.
3. Selecteer Databases onder Categorieën.
4. Zoek en selecteer Azure Database voor PostgreSQL flexibele server.
5. Klik op Creëren.

Basisinstellingen configureren

Projectgegevens

Serverdetails

Hoge beschikbaarheid

Authenticatie

Rekenkracht en opslag configureren

Selecteer Server configureren om aan te passen:

Rekenlaag

Opslaginstellingen

Back-upinstellingen

Netwerken configureren

Kies uw connectiviteitsmethode (kan niet worden gewijzigd na het maken):

Openbare toegang (toegestane IP-adressen)

Verbinding maken via een openbaar eindpunt met behulp van firewallregels.

Instellingen:

Privétoegang (integratie van virtueel netwerk)

Maak verbinding via een privé-eindpunt in een virtueel netwerk. Zie Netwerk met privétoegang voor Azure Database for PostgreSQL voor meer informatie.

Beveiliging configureren

Resourcetags toevoegen (optioneel)

Resources organiseren met naam-waardeparen:

Beoordelen en creëren

1. Kies Beoordelen + creëren.
2. Controleer alle configuraties.
3. Selecteer Maken om te implementeren.

De implementatie duurt doorgaans 5-10 minuten. Wanneer u klaar bent, selecteert u Ga naar de resource om toegang te krijgen tot uw server.

Server maken met behulp van Azure CLI

Vereisten voor CLI

Voor dit script gebruikt u Azure CLI lokaal omdat het te lang duurt om uit te voeren in Cloud Shell.

Aanmelden bij Azure

Gebruik het volgende script om u aan te melden met een specifiek abonnement.

subscription="<subscriptionId>" # add subscription here

az account set -s $subscription # ...or use 'az login'

Zie voor meer informatie actief abonnement instellen of u interactief aanmelden

Als u Azure Cloud Shell gebruikt, bent u al aangemeld.

Server maken met CLI

Maak een server met één opdracht:

az postgres flexible-server create \
  --resource-group myresourcegroup \
  --name mydemoserver-pgsql \
  --location eastus \
  --admin-user myadmin \
  --admin-password <password> \
  --sku-name Standard_D4ds_v5 \
  --tier GeneralPurpose \
  --public-access 0.0.0.0 \
  --storage-size 128 \
  --tags "Environment=Development"

CLI-parameters referentie

Geavanceerd CLI-voorbeeld

Maak een zone-redundante hoog beschikbare server.

az postgres flexible-server create \
  --resource-group myresourcegroup \
  --name mydemoserver-pgsql-ha \
  --location eastus \
  --admin-user myadmin \
  --admin-password <password> \
  --sku-name Standard_D4ds_v5 \
  --tier GeneralPurpose \
  --storage-size 256 \
  --storage-type PremiumV2_LRS \
  --high-availability ZoneRedundant \
  --zone 1 \
  --standby-zone 2 \
  --backup-retention 14 \
  --public-access 0.0.0.0

Een server maken met behulp van een ARM-sjabloon

Overzicht van ARM-sjablonen

Met ARM-sjablonen (Azure Resource Manager) kunt u infrastructuur definiëren als code. Sjablonen gebruiken voor herhaalbare implementaties.

Minimale ARM-sjabloon

Sla dit bestand op als postgres-server-template.json:

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "serverName": {
      "type": "string",
      "metadata": {
        "description": "Server name must be globally unique"
      }
    },
    "administratorLogin": {
      "type": "string",
      "minLength": 1,
      "maxLength": 63,
      "metadata": {
        "description": "Administrator username"
      }
    },
    "administratorLoginPassword": {
      "type": "securestring",
      "minLength": 8,
      "metadata": {
        "description": "Administrator password"
      }
    },
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]",
      "metadata": {
        "description": "Server location"
      }
    }
  },
  "resources": [
    {
      "type": "Microsoft.DBforPostgreSQL/flexibleServers",
      "apiVersion": "2024-08-01",
      "name": "[parameters('serverName')]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "Standard_D4ds_v5",
        "tier": "GeneralPurpose"
      },
      "properties": {
        "administratorLogin": "[parameters('administratorLogin')]",
        "administratorLoginPassword": "[parameters('administratorLoginPassword')]",
        "version": "16",
        "storage": {
          "storageSizeGB": 128,
          "type": "Premium_LRS",
          "autoGrow": "Enabled"
        },
        "backup": {
          "backupRetentionDays": 7,
          "geoRedundantBackup": "Disabled"
        },
        "network": {
          "publicNetworkAccess": "Enabled"
        },
        "highAvailability": {
          "mode": "Disabled"
        }
      }
    }
  ],
  "outputs": {
    "serverFQDN": {
      "type": "string",
      "value": "[reference(parameters('serverName')).fullyQualifiedDomainName]"
    }
  }
}

De ARM-sjabloon implementeren

az group create --name myresourcegroup --location eastus

az deployment group create \
  --resource-group myresourcegroup \
  --template-file postgres-server-template.json \
  --parameters \
    serverName=mydemoserver-pgsql \
    administratorLogin=myadmin \
    administratorLoginPassword=<password>

Verbindingsgegevens ophalen

Nadat u de server hebt gemaakt, haalt u de verbindingsgegevens op:

Azure-portal gebruiken

1. Ga naar uw server in Azure Portal.
2. Open de pagina Overzicht.
3. Kopieer deze waarden:
   • Servernaam (eindpunt): mydemoserver-pgsql.postgres.database.azure.com
   • Beheerdersaanmelding: myadmin

Azure CLI gebruiken

az postgres flexible-server show \
  --resource-group myresourcegroup \
  --name mydemoserver-pgsql \
  --query "{serverName:fullyQualifiedDomainName, adminUser:administratorLogin}" \
  --output table

Verbinding maken met behulp van psql

psql installeren

Als u geen PostgreSQL-clienthulpprogramma's hebt, downloadt u PostgreSQL voor uw platform.

Verbinding maken met uw server

psql "host=mydemoserver-pgsql.postgres.database.azure.com port=5432 dbname=postgres user=myadmin sslmode=require"

Wanneer u hierom wordt gevraagd, voert u het beheerderswachtwoord in dat u hebt ingesteld tijdens het maken van de server.

Indeling van verbindingstekenreeks

host=<server-name>.postgres.database.azure.com port=5432 dbname=<database-name> user=<admin-user> password=<password> sslmode=require

Verbinding controleren

Nadat u verbinding hebt gemaakt, ziet u het volgende:

psql (14.13, server 16.4)
WARNING: psql major version 14, server major version 16.
         Some psql features might not work.
SSL connection (protocol: TLSv1.3, cipher: TLS_AES_256_GCM_SHA384, bits: 256, compression: off)
Type "help" for help.

postgres=>

Een database maken

CREATE DATABASE user_database;
\c user_database
\q

Verbindingsproblemen oplossen

Firewall blokkeert de verbinding

Als u het volgende ziet:

connection to server at "mydemoserver-pgsql.postgres.database.azure.com" (###.###.###.###), port 5432 failed: Connection timed out

Oplossing: Voeg uw IP-adres toe aan de firewallregels:

az postgres flexible-server firewall-rule create \
  --resource-group myresourcegroup \
  --name mydemoserver-pgsql \
  --rule-name AllowMyIP \
  --start-ip-address <your-ip> \
  --end-ip-address <your-ip>

SSL vereist, maar niet geconfigureerd

Zorg ervoor dat uw verbindingsreeks sslmode=require bevat.

De hulpbronnen opschonen

Wanneer u klaar bent met de quickstart, verwijdert u de resources om kosten te voorkomen.

De hele resourcegroep verwijderen

az group delete --name myresourcegroup --yes

Alleen de server verwijderen

az postgres flexible-server delete \
  --resource-group myresourcegroup \
  --name mydemoserver-pgsql \
  --yes

Verwante inhoud

• Firewallregels in Azure Database voor PostgreSQL
• Overzicht van verbinding maken en query's uitvoeren voor Azure Database for PostgreSQL