Snabb start: skapa en Azure Database for PostgreSQL-enskild server med Azure CLIQuickstart: Create an Azure Database for PostgreSQL - Single Server using the Azure CLI

Tips

Överväg att använda det enklare AZ postgres med Azure CLI-kommandot (för närvarande i för hands version).Consider using the simpler az postgres up Azure CLI command (currently in preview). Prova snabbstarten.Try out the quickstart.

Azure Database för PostgreSQL är en hanterad tjänst som låter dig köra, hantera och skala högtillgängliga PostgreSQL-databaser i molnet.Azure Database for PostgreSQL is a managed service that enables you to run, manage, and scale highly available PostgreSQL databases in the cloud. Azure CLI används för att skapa och hantera Azure-resurser från kommandoraden eller i skript.The Azure CLI is used to create and manage Azure resources from the command line or in scripts. Den här snabbstarten visar hur du skapar en Azure Database för PostgreSQL-server i en Azure-resursgrupp med hjälp av Azure-CLI:n.This quickstart shows you how to create an Azure Database for PostgreSQL server in an Azure resource group using the Azure CLI.

Om du inte har en Azure-prenumeration kan du skapa ett kostnadsfritt konto innan du börjar.If you don't have an Azure subscription, create a free account before you begin.

Använda Azure Cloud ShellUse Azure Cloud Shell

Azure-värdar Azure Cloud Shell, en interaktiv gränssnitts miljö som du kan använda via webbläsaren.Azure hosts Azure Cloud Shell, an interactive shell environment that you can use through your browser. Du kan använda antingen bash eller PowerShell med Cloud Shell för att arbeta med Azure-tjänster.You can use either Bash or PowerShell with Cloud Shell to work with Azure services. Du kan använda Cloud Shell förinstallerade kommandona för att köra koden i den här artikeln utan att behöva installera något i din lokala miljö.You can use the Cloud Shell preinstalled commands to run the code in this article without having to install anything on your local environment.

Starta Azure Cloud Shell:To start Azure Cloud Shell:

AlternativOption Exempel/länkExample/Link
Välj Prova i det övre högra hörnet av ett kodblock.Select Try It in the upper-right corner of a code block. Om du väljer testa kopieras inte koden automatiskt till Cloud Shell.Selecting Try It doesn't automatically copy the code to Cloud Shell. Exempel på hur du provar Azure Cloud Shell
Gå till https://shell.azure.com, eller Välj knappen Starta Cloud Shell för att öppna Cloud Shell i webbläsaren.Go to https://shell.azure.com, or select the Launch Cloud Shell button to open Cloud Shell in your browser. starta Cloud Shell i ett nytt fönsterLaunch Cloud Shell in a new window
Välj knappen Cloud Shell i den övre högra meny raden i Azure Portal.Select the Cloud Shell button on the top-right menu bar in the Azure portal. Cloud Shell-knappen i Azure Portal

För att köra koden i den här artikeln i Azure Cloud Shell:To run the code in this article in Azure Cloud Shell:

  1. Starta Cloud Shell.Start Cloud Shell.

  2. Kopiera koden genom att klicka på kopierings knappen på ett kodblock.Select the Copy button on a code block to copy the code.

  3. Klistra in koden i Cloud Shell-sessionen genom att välja Ctrl+Shift+V på Windows och Linux eller genom att välja cmd+Shift+V på MacOS.Paste the code into the Cloud Shell session by selecting Ctrl+Shift+V on Windows and Linux or by selecting Cmd+Shift+V on macOS.

  4. Välj RETUR för att köra koden.Select Enter to run the code.

Om du väljer att installera och använda CLI lokalt måste du köra Azure CLI version 2.0 eller senare.If you choose to install and use the CLI locally, this article requires that you are running the Azure CLI version 2.0 or later. Kör kommandot az --version om du vill se vilken version som är installerad.To see the version installed, run the az --version command. Om du behöver installera eller uppgradera kan du läsa Installera Azure CLI.If you need to install or upgrade, see Install Azure CLI.

Om du kör CLI lokalt måste du logga in på ditt konto med hjälp av kommandot AZ login .If you are running the CLI locally, you need to sign in to your account using the az login command. Observera egenskapen ID från kommandots utdata för motsvarande prenumerations namn.Note the ID property from the command output for the corresponding subscription name.

az login

Om du har flera prenumerationer ska du välja lämplig prenumeration där resursen ska debiteras.If you have multiple subscriptions, choose the appropriate subscription in which the resource should be billed. Välj det specifika prenumerations-ID:t under ditt konto med hjälp av kommandot az account set.Select the specific subscription ID under your account using az account set command. Ersätt ID- egenskapen från AZ inloggnings resultat för din prenumeration i plats hållaren för prenumerations-ID.Substitute the ID property from the az login output for your subscription into the subscription ID placeholder.

az account set --subscription <subscription id>

Skapa en resursgruppCreate a resource group

Skapa en Azure-resursgrupp med kommandot az group create.Create an Azure resource group using the az group create command. En resursgrupp är en logisk container där Azure-resurser distribueras och hanteras som en grupp.A resource group is a logical container into which Azure resources are deployed and managed as a group. Du bör ange ett unikt namn.You should provide a unique name. I följande exempel skapas en resursgrupp med namnet myresourcegroup på platsen westus.The following example creates a resource group named myresourcegroup in the westus location.

az group create --name myresourcegroup --location westus

Skapa en Azure Database för PostgreSQL-serverCreate an Azure Database for PostgreSQL server

Skapa en Azure Database för PostgreSQL-server med kommandot az postgres server create.Create an Azure Database for PostgreSQL server using the az postgres server create command. En server kan innehålla flera databaser.A server can contain multiple databases.

InställningSetting ExempelvärdeSample value BeskrivningDescription
namnname mydemoservermydemoserver Välj ett unikt namn för Azure Database för PostgreSQL-server.Choose a unique name that identifies your Azure Database for PostgreSQL server. Ditt servernamn får bara innehålla gemener, siffror och bindestreck.The server name can contain only lowercase letters, numbers, and the hyphen (-) character. Det måste innehålla mellan 3 och 63 tecken.It must contain from 3 to 63 characters.
resource-groupresource-group myresourcegroupmyresourcegroup Ange namnet på Azure-resursgruppen.Provide the name of the Azure resource group.
sku-namesku-name GP_Gen5_2GP_Gen5_2 Namnet på SKU:n.The name of the sku. Följer konventionen {prisnivå}_{beräkningsgenerering}_{vCores} i snabbformat.Follows the convention {pricing tier}_{compute generation}_{vCores} in shorthand. Se under tabellen för mer information om parametern sku-name.See below this table for more information about the sku-name parameter.
backup-retentionbackup-retention 77 Hur länge en säkerhetskopia ska behållas.How long a backup should be retained. Enheten är dagar.Unit is days. Intervallet är 7–35.Range is 7-35.
geo-redundant-backupgeo-redundant-backup DisabledDisabled Huruvida geo-redundanta säkerhetskopieringar ska aktiveras för den här servern eller inte.Whether geo-redundant backups should be enabled for this server or not. Tillåtna värden: Enabled, Disabled.Allowed values: Enabled, Disabled.
locationlocation westuswestus Azure-platsen för servern.The Azure location for the server.
ssl-enforcementssl-enforcement EnabledEnabled Om ssl ska aktiveras eller inte för den här servern.Whether ssl should be enabled or not for this server. Tillåtna värden: Enabled, Disabled.Allowed values: Enabled, Disabled.
storage-sizestorage-size 5120051200 Serverns lagringskapacitet (enheten är megabyte).The storage capacity of the server (unit is megabytes). En giltig storage-size är minst 5 120 MB och ökar i steg om 1 024 MB.Valid storage-size is minimum 5120MB and increases in 1024MB increments. Se dokumentet med prisnivåer för mer information om storleksgränser för lagring.See the pricing tiers document for more information about storage size limits.
versionversion 9.69.6 Huvudversion för PostgreSQL.The PostgreSQL major version.
admin-useradmin-user myadminmyadmin Användarnamnet för administratörsinloggning.The username for the administrator login. Det kan inte vara azure_superuser, admin, administrator, root, guest eller public.It cannot be azure_superuser, admin, administrator, root, guest, or public.
admin-passwordadmin-password säkert lösenordsecure password Lösenordet för administratörsanvändaren.The password of the administrator user. Det måste innehålla mellan 8 och 128 tecken.It must contain between 8 and 128 characters. Lösenordet måste innehålla tecken från tre av följande kategorier: engelska versala bokstäver, engelska gemena bokstäver, siffror och icke-alfanumeriska tecken.Your password must contain characters from three of the following categories: English uppercase letters, English lowercase letters, numbers, and non-alphanumeric characters.

Parametervärdet för sku-namn följer namngivningskonventionen {prisnivå}_{compute-generering}_{vCores} som i exemplen nedan:The sku-name parameter value follows the convention {pricing tier}_{compute generation}_{vCores} as in the examples below:

  • --sku-name B_Gen5_1 mappar till Basic, Gen 5 och 1 virtuell kärna.--sku-name B_Gen5_1 maps to Basic, Gen 5, and 1 vCore. Det här alternativet är minsta tillgängliga SKU.This option is the smallest SKU available.
  • --sku-name GP_Gen5_32 mappar till generell användning, Gen 5 och 32 vCores.--sku-name GP_Gen5_32 maps to General Purpose, Gen 5, and 32 vCores.
  • --sku-name MO_Gen5_2 mappar till minnesoptimerad, Gen 5 och 2 vCores.--sku-name MO_Gen5_2 maps to Memory Optimized, Gen 5, and 2 vCores.

Se dokumentationen om prisnivåer för mer information om giltiga värden per region och nivå.Please see the pricing tiers documentation to understand the valid values per region and per tier.

I följande exempel skapas en Postgre SQL 9.6-server i västra USA som heter mydemoserver i din resursgrupp myresourcegroup med serveradministratörsinloggningen myadmin.The following example creates a PostgreSQL 9.6 server in West US named mydemoserver in your resource group myresourcegroup with server admin login myadmin. Det här är en generell användning server med 2 virtuella kärnor.This is a Gen 4 General Purpose server with 2 vCores. Ersätt <server_admin_password> med ditt eget värde.Substitute the <server_admin_password> with your own value.

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

Anteckning

Överväg att använda prisnivån Basic om lätt beräkning och I/O är lämpligt för din arbetsbelastning.Consider using the Basic pricing tier if light compute and I/O are adequate for your workload. Observera att servrar som skapas på prisnivån Basic inte senare kan skalas till Generell användning eller Minnesoptimerad.Note that servers created in the Basic pricing tier cannot later be scaled to General Purpose or Memory Optimized. Mer information finns på sidan med prissättning.See the pricing page for more information.

Konfigurera en brandväggsregel på servernivåConfigure a server-level firewall rule

Skapa en brandväggsregel på Azure PostgreSQL-servernivå med kommandot az postgres server firewall-rule create.Create an Azure PostgreSQL server-level firewall rule with the az postgres server firewall-rule create command. En brandväggsregel på servernivå låter ett externt program som en psql eller en PgAdmin ansluta till din server via Azure PostgreSQL-tjänstens brandvägg.A server-level firewall rule allows an external application, such as psql or PgAdmin to connect to your server through the Azure PostgreSQL service firewall.

Du kan ställa in en brandväggsregel som omfattar ett IP-intervall för att kunna ansluta från ditt nätverk.You can set a firewall rule that covers an IP range to be able to connect from your network. Följande exempel använder az postgres server firewall-rule create för att skapa en brandväggsregel AllowMyIP för en enkel IP-adress.The following example uses az postgres server firewall-rule create to create a firewall rule AllowMyIP for a single IP address.

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

Azure PostgreSQL-servern kommunicerar via port 5432.Azure PostgreSQL server communicates over port 5432. När du ansluter innifrån ett företagsnätverk är det möjligt att utgående trafik via port 5432 inte tillåts av nätverkets brandvägg.When connecting from within a corporate network, outbound traffic over port 5432 may not be allowed by your network's firewall. Be din IT-avdelning öppna port 5432 för att ansluta till din Azure PostgreSQL-server.Have your IT department open port 5432 to connect to your Azure PostgreSQL server.

Hämta anslutningsinformationenGet the connection information

För att ansluta till servern måste du ange värddatorinformationen och autentiseringsuppgifterna.To connect to your server, you need to provide host information and access credentials.

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

Resultatet är i JSON-format.The result is in JSON format. Anteckna administratorLogin och fullyQualifiedDomainName.Make a note of the administratorLogin and 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 PostgreSQL-databasen med psqlConnect to PostgreSQL database using psql

Om din klientdator har PostgreSQL installerat, kan du använda en lokal instans av psql för att ansluta till en Azure PostgreSQL-server.If your client computer has PostgreSQL installed, you can use a local instance of psql to connect to an Azure PostgreSQL server. Nu använder vi psql-kommandoradsverktyget för att ansluta till Azure PostgreSQL-servern.Let's now use the psql command-line utility to connect to the Azure PostgreSQL server.

  1. Kör följande psql-kommando för att ansluta till en Azure Database för PostgreSQL-serverRun the following psql command to connect to an Azure Database for PostgreSQL server

    psql --host=<servername> --port=<port> --username=<user@servername> --dbname=<dbname>
    

    Följande kommando ansluter exempelvis till standarddatabasen som heter postgres på din PostgreSQL-server mydemoserver.postgres.database.azure.com med hjälp av autentiseringsuppgifter.For example, the following command connects to the default database called postgres on your PostgreSQL server mydemoserver.postgres.database.azure.com using access credentials. Ange den <server_admin_password> som du valde när du uppmanades att ange lösenordet.Enter the <server_admin_password> you chose when prompted for password.

    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 @-tecknet i användar namnet med %40.If you prefer to use a URL path to connect to Postgres, URL encode the @ sign in the username with %40. Anslutnings strängen för psql skulle exempelvis vara,For example the connection string for psql would be,

    psql postgresql://myadmin%40mydemoserver@mydemoserver.postgres.database.azure.com:5432/postgres
    
  2. När du är ansluten till servern, skapar du en blank databas i prompten.Once you are connected to the server, create a blank database at the prompt.

    CREATE DATABASE mypgsqldb;
    
  3. I prompten, kör du följande kommando för att växla anslutning till den nyligen skapade databasen mypgsqldb:At the prompt, execute the following command to switch connection to the newly created database mypgsqldb:

    \c mypgsqldb
    

Ansluta till PostgreSQL-servern med hjälp av pgAdminConnect to the PostgreSQL Server using pgAdmin

pgAdmin är ett verktyg med öppen källkod som används med PostgreSQL.pgAdmin is an open-source tool used with PostgreSQL. Du kan installera pgAdmin från pgAdmin-webbplatsen.You can install pgAdmin from the pgAdmin website. Den pgAdmin-version som du använder kan skilja sig från vad som används i den här snabbstarten.The pgAdmin version you're using may be different from what is used in this Quickstart. Läs dokumentationen för pgAdmin om du behöver ytterligare hjälp.Read the pgAdmin documentation if you need additional guidance.

  1. Öppna pgAdmin-programmet på klientdatorn.Open the pgAdmin application on your client computer.

  2. Från verktygsfältet går du till Objekt, hovrar över Skapa och väljer Server.From the toolbar go to Object, hover over Create, and select Server.

  3. I dialogrutan Skapa – Server på fliken Allmänt anger du ett unikt eget namn för servern, t.ex. mydemoserver.In the Create - Server dialog box, on the General tab, enter a unique friendly name for the server, such as mydemoserver.

    Fliken ”Allmänt”

  4. Fyll i inställningstabellen i dialogrutan Skapa – Server på fliken Anslutning.In the Create - Server dialog box, on the Connection tab, fill in the settings table.

    Fliken ”Anslutning”

    pgAdmin-parameterpgAdmin parameter VärdeValue BeskrivningDescription
    Värdnamn/-adressHost name/address servernamnServer name Det värde för servernamn som du använde tidigare när du skapade Azure Database för PostgreSQL-server.The server name value that you used when you created the Azure Database for PostgreSQL server earlier. Vår exempelserver är mydemoserver.postgres.database.azure.com.Our example server is mydemoserver.postgres.database.azure.com. Använd det fullständiga domännamnet ( *.postgres.database.azure.com) som i det här exemplet.Use the fully qualified domain name (*.postgres.database.azure.com) as shown in the example. Om du inte kommer ihåg namnet på servern följer du anvisningarna i föregående avsnitt för att hitta anslutningsinformation.If you don't remember your server name, follow the steps in the previous section to get the connection information.
    PortPort 54325432 Porten som ska användas när du ansluter till Azure Database för PostgreSQL-servern.The port to use when you connect to the Azure Database for PostgreSQL server.
    UnderhållsdatabasMaintenance database postgrespostgres Systemgenererat standardnamn för databasen.The default system-generated database name.
    AnvändarnamnUsername Inloggningsnamn för serveradministratörServer admin login name Ange det användarnamn för serveradministratörsinloggning som du angav tidigare när du skapade Azure Database för PostgreSQL-server.The server admin login username that you supplied when you created the Azure Database for PostgreSQL server earlier. Om du inte kommer ihåg användarnamnet följer du anvisningarna i föregående avsnitt för att hitta anslutningsinformation.If you don't remember the username, follow the steps in the previous section to get the connection information. Formatet är användar namn@servername.The format is username@servername.
    lösenordPassword Ditt administratörslösenordYour admin password Det lösenord du angav när du skapade servern tidigare i den här snabbstarten.The password you chose when you created the server earlier in this Quickstart.
    RollRole Lämna tomtLeave blank Du behöver inte ange ett rollnamn nu.There's no need to provide a role name at this point. Lämna fältet tomt.Leave the field blank.
    SSL-lägeSSL mode KrävRequire Du kan ställa in SSL-läget på pgAdmin SSL-fliken. Som standard skapas alla Azure Database for PostgreSQL-servrar med tvingande SSL aktiverat.You can set the SSL mode in pgAdmin's SSL tab. By default, all Azure Database for PostgreSQL servers are created with SSL enforcing turned on. Om du vill inaktivera tvingande SSL kan läsa informationen om tvingande SSL.To turn off SSL enforcing, see SSL Enforcing.
  5. Välj Spara.Select Save.

  6. I fönstret Webbläsare till vänster expanderar du noden Servrar.In the Browser pane on the left, expand the Servers node. Välj din server, till exempel mydemoserver.Select your server, for example, mydemoserver. Klicka för att ansluta till den.Click to connect to it.

  7. Expandera servernoden och expandera sedan Databaser under den.Expand the server node, and then expand Databases under it. Listan bör innehålla din befintliga postgres-databas och eventuella andra databaser som du har skapat.The list should include your existing postgres database and any other databases you've created. Du kan skapa flera databaser per server med Azure Database for PostgreSQL.You can create multiple databases per server with Azure Database for PostgreSQL.

  8. Högerklicka på Databaser, välj menyn Skapa och välj sedan Databas.Right-click Databases, choose the Create menu, and then select Database.

  9. Ange valfritt databasnamn i fältet Databas, till exempel mypgsqldb2.Type a database name of your choice in the Database field, such as mypgsqldb2.

  10. Välj Ägare för databasen från den nedrullningsbara listan.Select the Owner for the database from the list box. Välj ditt inloggningsnamn som serveradministratör, förslagsvis som i vårt exempel: my admin.Choose your server admin login name, such as the example, my admin.

    Skapa en databas i pgAdmin

  11. Välj Spara för att skapa en tom databas.Select Save to create a new blank database.

  12. I fönstret Webbläsare ser du den databas som du skapade i listan med databaser under servernamnet.In the Browser pane, you can see the database that you created in the list of databases under your server name.

Rensa resurserClean up resources

Rensa upp alla resurser du skapade i snabbstarten genom att ta bort Azure-resursgruppen.Clean up all resources you created in the quickstart by deleting the Azure resource group.

Tips

De andra snabbstarterna i den här samlingen bygger på den här snabbstarten.Other quickstarts in this collection build upon this quickstart. Om du planerar att fortsätta arbeta med efterföljande snabbstarter ska du inte rensa upp resurserna som du skapade i den här snabbstarten.If you plan to continue to work with subsequent quickstarts, do not clean up the resources created in this quickstart. Om du inte planerar att fortsätta, kan du använda följande steg för att ta bort alla resurser som skapades av den här snabbstarten i Azure-CLI:n.If you do not plan to continue, use the following steps to delete all resources created by this quickstart in the Azure CLI.

az group delete --name myresourcegroup

Om du endast vill ta bort den nyss skapade servern kan du köra kommandot az postgres server delete.If you would just like to delete the one newly created server, you can run az postgres server delete command.

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

Nästa stegNext steps