Quickstart: Een Azure Database for PostgreSQL - Flexible Server-exemplaar maken met behulp van Azure CLI
VAN TOEPASSING OP: Azure Database for PostgreSQL - Flexibele server
In deze quickstart ziet u hoe u de Azure CLI-opdrachten in Azure Cloud Shell kunt gebruiken om binnen vijf minuten een exemplaar van een flexibele Azure Database for PostgreSQL-server te maken. Als u geen Azure-abonnement hebt, maakt u een gratis account voordat u begint.
Azure Cloud Shell starten
Azure Cloud Shell is een gratis interactieve shell waarmee u de stappen in dit artikel kunt uitvoeren. In deze shell zijn algemene Azure-hulpprogramma's vooraf geïnstalleerd en geconfigureerd voor gebruik met uw account.
Als u Cloud Shell wilt openen, selecteert u Proberen in de rechterbovenhoek van een codeblok. Als u naar https://shell.azure.com/bash gaat, kunt u Cloud Shell ook openen in een afzonderlijk browsertabblad. Selecteer Kopiëren om de codeblokken te kopiëren, plak deze in Cloud Shell en selecteer vervolgens Enter om de code uit te voeren.
Als u ervoor kiest om de CLI lokaal te installeren en te gebruiken, hebt u voor deze snelstartgids versie 2.0 of hoger van Azure CLI nodig. Voer az --version
uit om de versie te bekijken. Als u Azure CLI 2.0 wilt installeren of upgraden, raadpleegt u Azure CLI 2.0 installeren.
Vereisten
U moet zich aanmelden bij uw account met behulp van de opdracht az login . Noteer de id-eigenschap in de uitvoer, die verwijst naar de abonnements-id voor uw Azure-account.
az login
Selecteer het specifieke abonnement in uw account met de opdracht az account set. Gebruik de id-waarde uit de az login-uitvoer om te gebruiken als de waarde voor het argument abonnement in de opdracht. 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.
az account set --subscription <subscription id>
Een flexibele server maken
Maak een Azure-resourcegroep met behulp van de az group create
opdracht en maak vervolgens uw flexibele Azure Database for PostgreSQL-serverexemplaren in deze resourcegroep. U moet een unieke naam opgeven. In het volgende voorbeeld wordt een resourcegroep met de naam myresourcegroup
gemaakt op de locatie eastus
.
az group create --name myresourcegroup --location eastus
Maak een exemplaar van een flexibele Azure Database for PostgreSQL-server met de az postgres flexible-server create
opdracht. Een server kan meerdere databases bevatten. Met de volgende opdracht maakt u een server in de resourcegroep die u zojuist hebt gemaakt:
az postgres flexible-server create --name mydemoserver --resource-group myresourcegroup
Omdat de standaardverbindingsmethode openbare toegang (toegestane IP-adressen) is, wordt u gevraagd om te bevestigen of u uw IP-adres wilt toevoegen en/of alle IP-adressen (bereik met 0.0.0.0 tot en met 255.255.255.255) aan de lijst met toegestane adressen.
De gemaakte server heeft de volgende kenmerken:
- Dezelfde locatie als uw resourcegroep
- Automatisch gegenereerde gebruikersnaam en beheerderswachtwoord voor beheerders (die u op een veilige plaats moet opslaan)
- Een standaarddatabase met de naam 'flexibleserverdb'
- Servicestandaarden voor resterende serverconfiguraties: rekenlaag (algemeen gebruik), rekengrootte/SKU (
Standard_D2s_v3
- 2 vCore, 8 GB RAM), bewaarperiode voor back-ups (7 dagen) en PostgreSQL-versie (13)
Notitie
De connectiviteitsmethode kan niet worden gewijzigd nadat de server is gemaakt. Als u bijvoorbeeld privétoegang (VNet-integratie) hebt geselecteerd tijdens het maken, kunt u deze niet wijzigen in Openbare toegang (toegestane IP-adressen) na het maken. U kunt het beste een server met privétoegang maken om veilig toegang te krijgen tot uw server met behulp van VNet-integratie. Meer informatie over persoonlijke toegang vindt u in het artikel over concepten.
Als u de standaardinstellingen wilt wijzigen, raadpleegt u de Azure CLI-verwijzing voor az postgres flexible-server create.
Notitie
Verbindingen met flexibele Azure Database for PostgreSQL-server communiceren via poort 5432. Als u verbinding probeert te maken vanuit een bedrijfsnetwerk, wordt uitgaand verkeer via poort 5432 mogelijk niet toegestaan. In dat geval kunt u alleen verbinding maken met uw server als uw IT-afdeling poort 5432 openstelt. Als u PgBouncer inschakelt op uw exemplaar van azure Database for PostgreSQL flexibele server en er verbinding mee wilt maken, omdat deze wordt uitgevoerd op poort 6432, is het dat de poort die uw IT-afdeling moet openen voor uitgaand verkeer.
De verbindingsgegevens ophalen
Als u verbinding met uw server wilt maken, moet u hostgegevens en toegangsreferenties opgeven.
az postgres flexible-server show --name mydemoserver --resource-group myresourcegroup
Het resultaat wordt in JSON-indeling weergegeven. Noteer de fullyQualifiedDomainName en de administratorLogin. U moet het wachtwoord in de vorige stap hebben opgeslagen.
{
"administratorLogin": "myadmin",
"availabilityZone": "3",
"backup": {
"backupRetentionDays": 7,
"earliestRestoreDate": "2022-10-20T18:03:50.989428+00:00",
"geoRedundantBackup": "Disabled"
},
"earliestRestoreDate": null,
"fullyQualifiedDomainName": "mydemoserver.postgres.database.azure.com",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myresourcegroup/providers/Microsoft.DBforPostgreSQL/flexibleServers/mydemoserver",
"location": "eastus",
"name": "mydemoserver",
"network": {
"delegatedSubnetResourceId": null,
"privateDnsZoneArmResourceId": null,
"publicNetworkAccess": "Enabled"
},
"resourceGroup": "myresourcegroup",
"sku": {
"name": "Standard_D2s_v3",
"tier": "GeneralPurpose"
},
"state": "Ready",
"storage": {
"storageSizeGb": 128
},
"tags": null,
"type": "Microsoft.DBforPostgreSQL/flexibleServers",
"version": "13"
}
Verbinding maken met behulp van de PostgreSQL-opdrachtregelclient
Installeer eerst het opdrachtregelprogramma psql .
Maak met psql verbinding met de database 'flexibleserverdb' met behulp van de volgende opdracht. Vervang waarden door de automatisch gegenereerde domeinnaam en gebruikersnaam.
psql -h mydemoserver.postgres.database.azure.com -U myadmin flexibleserverdb
Notitie
Als er een fout The parameter PrivateDnsZoneArguments is required, and must be provided by customer
optreedt, betekent dit dat u mogelijk een oudere versie van Azure CLI gebruikt. Voer de Azure CLI bij en voer de bewerking opnieuw uit.
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 az postgres flexible-server delete
opdracht uitvoeren.
az postgres flexible-server delete --resource-group myresourcegroup --name mydemoserver