Snabbstart: Skapa en Azure Database for PostgreSQL-server med hjälp av Azure CLI

Den här snabbstarten visar hur du använder Azure CLI-kommandon i Azure Cloud Shell för att skapa en Azure Database for PostgreSQL server på fem minuter. Om du inte har en Azure-prenumeration kan du skapa ett kostnadsfritt konto innan du börjar.

Förutsättningar

  • Använd bash-miljön i Azure Cloud Shell.

    Starta Cloud Shell i ett nytt fönster

  • Om du vill kan du i stället installera Azure CLI för att köra CLI-referenskommandon.

    • Om du använder en lokal installation loggar du in på Azure CLI med hjälp av kommandot az login. Slutför autentiseringsprocessen genom att följa stegen som visas i terminalen. Fler inloggningsalternativ finns i Logga in med Azure CLI.

    • När du uppmanas till det installerar du Azure CLI-tillägg vid första användning. Mer information om tillägg finns i Använda tillägg med Azure CLI.

    • Kör az version om du vill hitta versionen och de beroende bibliotek som är installerade. Om du vill uppgradera till den senaste versionen kör du az upgrade.

  • Den här artikeln kräver version 2.0 eller senare av Azure CLI. Om du Azure Cloud Shell är den senaste versionen redan installerad.

    Tips

    Överväg att använda det enklare az postgres-kommandot för Azure CLI som för närvarande är i förhandsversion. Prova snabbstarten.

  • Välj det specifika prenumerations-ID:t under ditt konto med kommandot az account set.

    • Anteckna ID-värdet från az login-utdata som ska användas som värde för prenumerationsargumentet i kommandot.

      az account set --subscription <subscription id>
      
    • Om du har flera prenumerationer ska du välja lämplig prenumeration där resursen ska debiteras. Om du vill hämta alla dina prenumerationer använder du az account list.

Skapa en Azure Database for PostgreSQL-server

Skapa en Azure-resursgrupp med kommandot az group create och skapa sedan din PostgreSQL-server i den här resursgruppen. Du bör ange ett unikt namn. I följande exempel skapas en resursgrupp med namnet myresourcegroup på platsen westus.

az group create --name myresourcegroup --location westus

Skapa en Azure Database for PostgreSQL server med hjälp av kommandot az postgres server create. En server kan innehålla flera databaser.

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

Här är information om föregående argument:

Inställning Exempelvärde Beskrivning
name mydemoserver Unikt namn som identifierar din Azure Database for PostgreSQL server. Ditt servernamn får bara innehålla gemener, siffror och bindestreck. Det måste innehålla mellan 3 och 63 tecken. Mer information finns i Azure Database for PostgreSQL namngivningsregler.
resource-group myresourcegroup Namnet på Azure-resursgruppen.
location westus Azure-plats för servern.
admin-user myadmin Användarnamn för administratörsinloggningen. Det kan inte azure_superuser, admin, administratör, rot, gäst eller offentlig.
admin-password säkert lösenord Lösenordet för administratörsanvändaren. Det måste innehålla 8 till 128 tecken från tre av följande kategorier: engelska versala bokstäver, engelska gemener, siffror och icke-alfanumeriska tecken.
sku-name GP_Gen5_2 Namnet på prisnivån och beräkningskonfigurationen. Följ konventionen {pricing tier}{compute generation}{vCores} i korthet. Mer information finns i Azure Database for PostgreSQL priser.

Viktigt

Konfigurera en brandväggsregel på servernivå

Som standard är den server som du skapade inte offentligt tillgänglig och skyddas med brandväggsregler. Du kan konfigurera brandväggsreglerna på servern med kommandot az postgres server firewall-rule create för att ge din lokala miljö åtkomst till att ansluta till servern.

I följande exempel skapas en brandväggsregel som kallas AllowMyIP som tillåter anslutningar från den specifika IP-adressen 192.168.0.1. Ersätt IP-adressen eller intervallet med IP-adresser som motsvarar den plats som du ska ansluta från. Om du inte känner till din IP-adress går du till WhatIsMyIPAddress.com hämta den.

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

Anteckning

Kontrollera att nätverkets brandvägg tillåter port 5432 för att undvika anslutningsproblem. Azure Database for PostgreSQL-servrar använder den porten.

Hämta anslutningsinformationen

Ange värdinformation och autentiseringsuppgifter för åtkomst för att ansluta till servern.

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

Resultatet är i JSON-format. Anteckna värdena administratorLogin och 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"
}

Anslut till Azure Database for PostgreSQL-servern med psql

Psql-klienten är ett populärt alternativ för att ansluta till PostgreSQL-servrar. Du kan ansluta till servern med psql med Azure Cloud Shell. Du kan även använda psql i din lokala miljö om du har det tillgängligt. En tom databas, postgres, skapas automatiskt med en ny PostgreSQL-server. Du kan använda databasen för att ansluta med psql, som du ser i följande kod.

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

Tips

Om du föredrar att använda en URL-sökväg för att ansluta till Postgres kodar URL:en @-inloggningen i användarnamnet med %40 . Anslutningssträngen för psql skulle till exempel vara:

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

Rensa resurser

Om du inte behöver dessa resurser för en annan snabbstart eller självstudie kan du ta bort dem genom att köra följande kommando.

az group delete --name myresourcegroup

Om du bara vill ta bort den nyligen skapade servern kan du köra kommandot az postgres server delete.

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

Nästa steg