Quickstart: Een Azure CLI-opdracht, az postgres van (preview) gebruiken om u te maken van een Azure Database voor PostgreSQL - één ServerQuickstart: Use an Azure CLI command, az postgres up (preview), to create an Azure Database for PostgreSQL - Single Server

Belangrijk

De az postgres van Azure CLI-opdracht is beschikbaar als preview.The az postgres up Azure CLI command is in preview.

Azure Database voor PostgreSQL is een beheerde service waarmee u PostgreSQL-databases met hoge beschikbaarheid in de cloud kunt uitvoeren, beheren en schalen.Azure Database for PostgreSQL is a managed service that enables you to run, manage, and scale highly available PostgreSQL databases in the cloud. De Azure CLI wordt gebruikt voor het maken en beheren van Azure-resources vanaf de opdrachtregel of in scripts.The Azure CLI is used to create and manage Azure resources from the command line or in scripts. Deze snelstartgids leest u hoe u de az postgres van opdracht voor het maken van een Azure Database for PostgreSQL-server met de Azure CLI.This quickstart shows you how to use the az postgres up command to create an Azure Database for PostgreSQL server using the Azure CLI. Naast het maken van de server, de az postgres up opdracht maakt u een voorbeelddatabase, een hoofdgebruiker zijn in de database, opent u de firewall voor Azure-services en maakt standaard firewall-regels voor de clientcomputer.In addition to creating the server, the az postgres up command creates a sample database, a root user in the database, opens the firewall for Azure services, and creates default firewall rules for the client computer. Deze standaardinstellingen te versnellen van het ontwikkelingsproces inbouwt.These defaults help to expedite the development process.

VereistenPrerequisites

Als u nog geen Azure-abonnement hebt, maakt u een gratis account voordat u begint.If you don't have an Azure subscription, create a free account before you begin.

In dit artikel is vereist dat u van Azure CLI versie 2.0 of hoger uitvoert lokaal.This article requires that you're running the Azure CLI version 2.0 or later locally. Voer de opdracht az --version uit om de geïnstalleerde versie te zien.To see the version installed, run the az --version command. Zie Azure CLI installeren als u de CLI wilt installeren of een upgrade wilt uitvoeren.If you need to install or upgrade, see Install Azure CLI.

U moet zich aanmelden bij uw account met de az login opdracht.You'll need to sign in to your account using the az login command. Houd er rekening mee de ID eigenschap uit de uitvoer van de opdracht voor de naam van het desbetreffende abonnement.Note the ID property from the command output for the corresponding subscription name.

az login

Als u meerdere abonnementen hebt, kiest u het juiste abonnement waarin de resource moet worden gefactureerd.If you have multiple subscriptions, choose the appropriate subscription in which the resource should be billed. Selecteer de specifieke abonnements-id in uw account met de opdracht az account set.Select the specific subscription ID under your account using az account set command. Vervang de abonnements-ID eigenschap uit de az login uitvoer voor uw abonnement in de tijdelijke aanduiding voor abonnement-ID.Substitute the subscription ID property from the az login output for your subscription into the subscription ID placeholder.

az account set --subscription <subscription id>

Een Azure-database voor PostgreSQL-server makenCreate an Azure Database for PostgreSQL server

Voor het gebruik van de opdrachten, installeert de db-up extensie.To use the commands, install the db-up extension. Als een fout wordt geretourneerd, controleert u of dat u de nieuwste versie van de Azure CLI hebt geïnstalleerd.If an error is returned, ensure you have installed the latest version of the Azure CLI. Zie Azure CLI installeren.See Install Azure CLI.

az extension add --name db-up

Maak een Azure Database for PostgreSQL-server met de volgende opdracht:Create an Azure Database for PostgreSQL server using the following command:

az postgres up

De server is gemaakt met de volgende standaardwaarden (tenzij u handmatig deze overschrijft):The server is created with the following default values (unless you manually override them):

InstellingSetting StandaardwaardeDefault value BeschrijvingDescription
servernaamserver-name Door het systeem gegenereerdeSystem generated Een unieke naam ter identificatie van uw Azure Database for PostgreSQL-server.A unique name that identifies your Azure Database for PostgreSQL server.
resource-groupresource-group Door het systeem gegenereerdeSystem generated Een nieuwe Azure-resourcegroep.A new Azure resource group.
sku-namesku-name GP_Gen5_2GP_Gen5_2 De naam van de SKU.The name of the sku. Volgt de verkorte notatie voor conventie {prijscategorie}_{compute-generatie}_{vCores}.Follows the convention {pricing tier}_{compute generation}_{vCores} in shorthand. De standaardwaarde is een Gen5 voor algemeen gebruik-server met 2 vCores.The default is a General Purpose Gen5 server with 2 vCores. Zie onze pagina met prijzen voor meer informatie over de lagen.See our pricing page for more information about the tiers.
backup-retentionbackup-retention 77 Hoe lang een back-up wordt bewaard.How long a backup is retained. De eenheid is dagen.Unit is days.
geo-redundant-backupgeo-redundant-backup UitgeschakeldDisabled Of geografisch redundante back-ups moeten worden ingeschakeld voor deze server.Whether geo-redundant backups should be enabled for this server or not.
locationlocation westus2westus2 De Azure-locatie voor de server.The Azure location for the server.
ssl-enforcementssl-enforcement UitgeschakeldDisabled Of ssl moet worden ingeschakeld voor deze server.Whether ssl should be enabled or not for this server.
storage-sizestorage-size 51205120 De opslagcapaciteit van de server (eenheid is MB).The storage capacity of the server (unit is megabytes).
versieversion 1010 De primaire versie van PostgreSQL.The PostgreSQL major version.
admin-useradmin-user Door het systeem gegenereerdeSystem generated De gebruikersnaam voor de beheerder.The username for the administrator.
admin-passwordadmin-password Door het systeem gegenereerdeSystem generated Het wachtwoord van het beheerdersaccount.The password of the administrator user.

Notitie

Voor meer informatie over de az postgres up opdracht en de aanvullende parameters opgeeft, Zie de documentatie van Azure CLI.For more information about the az postgres up command and its additional parameters, see the Azure CLI documentation.

Als uw server is gemaakt, beschikt u met de volgende instellingen:Once your server is created, it comes with the following settings:

  • Een firewall-regel met de naam 'devbox' wordt gemaakt.A firewall rule called "devbox" is created. De Azure CLI voor het detecteren van het IP-adres van de machine probeert de az postgres up opdracht uitvoeren vanaf en witte lijsten dat IP-adres is.The Azure CLI attempts to detect the IP address of the machine the az postgres up command is run from and whitelists that IP address.
  • 'Toegang tot Azure-services toestaan' is ingesteld op aan."Allow access to Azure services" is set to ON. Deze instelling configureert u de firewall van de server om clientverbindingen van alle Azure-resources, met inbegrip van resources in uw abonnement niet te accepteren.This setting configures the server's firewall to accept connections from all Azure resources, including resources not in your subscription.
  • Een lege database met de naam 'sampledb' wordt gemaaktAn empty database named "sampledb" is created
  • Een nieuwe gebruiker met de naam "root" met machtigingen om 'sampledb' wordt gemaaktA new user named "root" with privileges to "sampledb" is created

Notitie

Azure Database voor PostgreSQL communiceert via poort 5432.Azure Database for PostgreSQL communicates over port 5432. Als u verbinding maakt vanuit een bedrijfsnetwerk, wordt uitgaand verkeer via poort 5432 mogelijk niet toegestaan door de firewall van uw netwerk.When connecting from within a corporate network, outbound traffic over port 5432 may not be allowed by your network's firewall. Uw IT-afdeling poort 5432 verbinding maken met uw server openen hebben.Have your IT department open port 5432 to connect to your server.

De verbindingsgegevens ophalenGet the connection information

Na de az postgres up opdracht is voltooid, wordt een lijst met tekenreeksen voor databaseverbindingen voor populaire programmeertalen geretourneerd naar u.After the az postgres up command is completed, a list of connection strings for popular programming languages is returned to you. Deze tekenreeksen voor databaseverbindingen zijn vooraf geconfigureerd met de specifieke kenmerken van uw zojuist gemaakte Azure Database for PostgreSQL-server.These connection strings are pre-configured with the specific attributes of your newly created Azure Database for PostgreSQL server.

U kunt de az postgres show-connection-string opdracht om deze tekenreeksen voor databaseverbindingen opnieuw weer te geven.You can use the az postgres show-connection-string command to list these connection strings again.

Resources opschonenClean up resources

Opschonen van alle resources die u hebt gemaakt in de Quick Start met de volgende opdracht.Clean up all resources you created in the quickstart using the following command. Met deze opdracht verwijdert u de Azure Database for PostgreSQL-server en de resourcegroep.This command deletes the Azure Database for PostgreSQL server and the resource group.

az postgres down --delete-group

Als u alleen de zojuist gemaakte server verwijderen wilt, kunt u uitvoeren az postgres omlaag opdracht.If you would just like to delete the newly created server, you can run az postgres down command.

az postgres down

Volgende stappenNext steps