Quickstart: Een Azure Database for PostgreSQL-server maken met behulp van Azure CLI

In deze quickstart wordt beschreven hoe u Azure CLI-opdrachten in Azure Cloud Shell gebruikt om binnen ongeveer vijf minuten één Azure Database for PostgreSQL-server te maken. Als u nog geen Azure-abonnement hebt, maakt u een gratis account voordat u begint.

Vereisten

• Gebruik de bash-omgeving in Azure Cloud shell.

  

• Installeer de Azure CLI, indien gewenst, om CLI-referentieopdrachten uit te voeren.

  • Als u een lokale installatie gebruikt, meldt u zich aan bij Azure CLI met behulp van de opdracht AZ login. Volg de stappen die worden weergegeven in de terminal, om het verificatieproces te voltooien. Raadpleeg Aanmelden bij de Azure CLI voor aanvullende aanmeldingsopties.

  • Installeer de Azure CLI-extensie bij het eerste gebruik, wanneer u hierom wordt gevraagd. Raadpleeg Extensies gebruiken met Azure CLI voor meer informatie over extensies.

  • Voer az version uit om de geïnstalleerde versie en afhankelijke bibliotheken te vinden. Voer az upgrade uit om te upgraden naar de nieuwste versie.

• Voor dit artikel is versie 2.0 of hoger van Azure CLI vereist. Als u Azure Cloud Shell gebruikt, is de nieuwste versie al geïnstalleerd.

  Tip

  Overweeg het gebruik van de eenvoudigere Azure CLI-opdracht az postgres up, die momenteel als preview-versie beschikbaar is. Probeer de quickstart.

• Selecteer de specifieke abonnements-id in uw account met de opdracht az account set.

  • Noteer de id-waarde uit de uitvoer van az login en gebruik deze als de waarde voor het argument abonnement in de opdracht.

    az account set --subscription <subscription id>
    

  • Als u meerdere abonnementen hebt, kiest u het juiste abonnement waarin de resource moet worden gefactureerd. U kunt al uw abonnementen ophalen met de opdracht az account list.

Een Azure-database voor PostgreSQL-server maken

Maak een Azure-resourcegroep met behulp van de opdracht az group create en maak vervolgens de PostgreSQL-server in deze resourcegroep. U moet een unieke naam opgeven. In het volgende voorbeeld wordt een resourcegroep met de naam myresourcegroup gemaakt op de locatie westus.

az group create --name myresourcegroup --location westus

Maak een Azure Database for PostgreSQL-server met behulp van de opdracht az postgres server create. Een server kan meerdere databases bevatten.

az postgres server create --resource-group myresourcegroup --name mydemoserver  --location westus --admin-user myadmin --admin-password <server_admin_password> --sku-name GP_Gen5_2 

Dit zijn de gegevens van de voorgaande argumenten:

Een serverfirewallregel configureren

De door u gemaakte server is standaard beveiligd met firewallregels en is niet openbaar toegankelijk. U kunt de firewallregels op uw server configureren met behulp van de opdracht az postgres server firewall-rule create, zodat uw lokale omgeving toegang tot de server krijgt en verbinding kan maken.

In het volgende voorbeeld wordt een firewallregel met de naam AllowMyIP gemaakt, die verbindingen van een specifiek IP-adres, 192.168.0.1, toestaat. Vervang dit adres door het IP-adres of de reeks IP-adressen die overeenkomen met het IP-adres waarmee u verbinding gaat maken. Als u uw IP-adres niet weet, gaat u naar WhatIsMyIPAddress.com om het te zoeken.

az postgres server firewall-rule create --resource-group myresourcegroup --server mydemoserver --name AllowMyIP --start-ip-address 192.168.0.1 --end-ip-address 192.168.0.1

De verbindingsgegevens ophalen

Als u verbinding met uw server wilt maken, geeft u hostgegevens en toegangsreferenties op.

az postgres server show --resource-group myresourcegroup --name mydemoserver

Het resultaat wordt in JSON-indeling weergegeven. Noteer de waarden voor administratorLogin en fullyQualifiedDomainName.

{
  "administratorLogin": "myadmin",
  "earliestRestoreDate": null,
  "fullyQualifiedDomainName": "mydemoserver.postgres.database.azure.com",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myresourcegroup/providers/Microsoft.DBforPostgreSQL/servers/mydemoserver",
  "location": "westus",
  "name": "mydemoserver",
  "resourceGroup": "myresourcegroup",
  "sku": {
    "capacity": 2,
    "family": "Gen5",
    "name": "GP_Gen5_2",
    "size": null,
    "tier": "GeneralPurpose"
  },
  "sslEnforcement": "Enabled",
  "storageProfile": {
    "backupRetentionDays": 7,
    "geoRedundantBackup": "Disabled",
    "storageMb": 5120
  },
  "tags": null,
  "type": "Microsoft.DBforPostgreSQL/servers",
  "userVisibleState": "Ready",
  "version": "9.6"
}

Verbinding maken met de Azure Database for PostgreSQL-server met behulp van psql

De psql-client is een populaire keuze voor het verbinding maken met PostgreSQL-servers. U kunt verbinding met uw server maken door psql met Azure Cloud Shell te gebruiken. U kunt psql ook in uw lokale omgeving gebruiken, indien beschikbaar. Er wordt automatisch een lege database, postgres, gemaakt met een nieuwe PostgreSQL-server. U kunt deze database gebruiken om verbinding te maken met psql, zoals wordt weergegeven in de volgende code.

psql --host=mydemoserver.postgres.database.azure.com --port=5432 --username=myadmin@mydemoserver --dbname=postgres

psql postgresql://myadmin%40mydemoserver@mydemoserver.postgres.database.azure.com:5432/postgres

Resources opschonen

Als u deze resources niet voor een andere quickstart of zelfstudie nodig hebt, kunt u ze verwijderen met de volgende opdracht.

az group delete --name myresourcegroup

Als u alleen de zojuist gemaakte server wilt verwijderen, kunt u de opdracht az postgres server delete uitvoeren.

az postgres server delete --resource-group myresourcegroup --name mydemoserver

Volgende stappen