Guida introduttiva: Creare un'istanza del server flessibile Database di Azure per PostgreSQL usando l'interfaccia della riga di comando di Azure
SI APPLICA A: Database di Azure per PostgreSQL - Server flessibile
Questa guida introduttiva illustra come usare i comandi dell'interfaccia della riga di comando di Azure in Azure Cloud Shell per creare un'istanza del server flessibile Database di Azure per PostgreSQL in cinque minuti. Se non si ha una sottoscrizione di Azure, creare un account gratuito prima di iniziare.
Avviare Azure Cloud Shell
Azure Cloud Shell è una shell interattiva gratuita che può essere usata per eseguire la procedura di questo articolo. Include strumenti comuni di Azure preinstallati e configurati per l'uso con l'account.
Per aprire Cloud Shell, basta selezionare Prova nell'angolo superiore destro di un blocco di codice. È anche possibile aprire Cloud Shell in una scheda separata del browser visitando https://shell.azure.com/bash. Selezionare Copia per copiare i blocchi di codice, incollarli in Cloud Shell e premere INVIO per eseguirli.
Se si preferisce installare e usare l'interfaccia della riga di comando in locale, per questo argomento di avvio rapido è necessaria l'interfaccia della riga di comando di Azure versione 2.0 o successiva. Eseguire az --version
per trovare la versione. Se è necessario eseguire l'installazione o l'aggiornamento, vedere Installare l'interfaccia della riga di comando di Azure.
Prerequisiti
È necessario accedere all'account usando il comando az login . Si noti la proprietà id nell'output, che fa riferimento all'ID sottoscrizione per l'account Azure.
az login
Selezionare la sottoscrizione specifica nell'account tramite il comando az account set. Usare il valore id dell'output az login da usare come valore per l'argomento subscription nel comando . Se si possiedono più sottoscrizioni, scegliere quella appropriata in cui verrà fatturata la risorsa. Per ottenere tutte le sottoscrizioni, usare az account list.
az account set --subscription <subscription id>
Creare un server flessibile
Creare un gruppo di risorse di Azure usando il comando e quindi creare l'istanza az group create
del server flessibile Database di Azure per PostgreSQL all'interno di questo gruppo di risorse. È necessario specificare un nome univoco. L'esempio seguente consente di creare un gruppo di risorse denominato myresourcegroup
nell'area eastus
.
az group create --name myresourcegroup --location eastus
Creare un'istanza del server flessibile Database di Azure per PostgreSQL con il az postgres flexible-server create
comando . Un server può contenere più database. Il comando seguente crea un server nel gruppo di risorse appena creato:
az postgres flexible-server create --name mydemoserver --resource-group myresourcegroup
Poiché il metodo di connettività predefinito è Accesso pubblico (indirizzi IP consentiti), il comando chiederà di confermare se si vuole aggiungere l'indirizzo IP e/o tutti gli indirizzi IP (intervallo compreso tra 0.0.0.0 e 255.255.255.255) all'elenco degli indirizzi consentiti.
Il server creato ha gli attributi seguenti:
- La stessa posizione del gruppo di risorse
- Nome utente amministratore generato automaticamente e password amministratore (che è necessario salvare in un luogo sicuro)
- Un database predefinito denominato "flexibleserverdb"
- Impostazioni predefinite del servizio per le configurazioni server rimanenti: livello di calcolo (utilizzo generico), dimensioni di calcolo/SKU (
Standard_D2s_v3
- 2 vCore, 8 GB di RAM), periodo di conservazione dei backup (7 giorni) e versione postgreSQL (13)
Nota
Il metodo di connettività non può essere modificato dopo la creazione del server. Ad esempio, se è stato selezionato Accesso privato (integrazione rete virtuale) durante la creazione, non è possibile modificarlo in Accesso pubblico (indirizzi IP consentiti) dopo la creazione. È consigliabile creare un server con accesso privato per accedere in modo sicuro al server tramite l'integrazione rete virtuale. Altre informazioni sull'accesso privato sono disponibili nell'articolo sui concetti.
Per modificare le impostazioni predefinite, vedere le informazioni di riferimento sull'interfaccia della riga di comando di Azure per az postgres flexible-server create.
Nota
Le connessioni a Database di Azure per PostgreSQL server flessibile comunicano sulla porta 5432. Se si prova a connettersi da una rete aziendale, il traffico in uscita sulla porta 5432 potrebbe non essere consentito. In questo caso, non è possibile connettersi al server a meno che il reparto IT non apra la porta 5432. Si noti che se si abilita PgBouncer nell'istanza di Database di Azure per PostgreSQL server flessibile e si vuole connetterlo, perché viene eseguito sulla porta 6432, è che la porta che il reparto IT deve aprire per il traffico in uscita.
Ottenere le informazioni di connessione
Per connettersi al server, è necessario specificare le informazioni sull'host e le credenziali di accesso.
az postgres flexible-server show --name mydemoserver --resource-group myresourcegroup
Il risultato è in formato JSON. Annotare il fullyQualifiedDomainName e l'administratorLogin. La password dovrebbe essere stata salvata nel passaggio precedente.
{
"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"
}
Connettersi tramite il client della riga di comando PostgreSQL
Installare prima di tutto lo strumento da riga di comando psql .
Con psql connettersi al database "flexibleserverdb" usando il comando seguente. Sostituire i valori con il nome di dominio e il nome utente generati automaticamente.
psql -h mydemoserver.postgres.database.azure.com -U myadmin flexibleserverdb
Nota
Se viene visualizzato un errore The parameter PrivateDnsZoneArguments is required, and must be provided by customer
, questo significa che potrebbe essere in esecuzione una versione precedente dell'interfaccia della riga di comando di Azure. Aggiornare l'interfaccia della riga di comando di Azure e ripetere l'operazione.
Pulire le risorse
Se queste risorse non sono necessarie per un'altra guida introduttiva/esercitazione, è possibile eliminarle eseguendo il comando seguente:
az group delete --name myresourcegroup
Se si vuole eliminare solo il server appena creato, è possibile eseguire il az postgres flexible-server delete
comando .
az postgres flexible-server delete --resource-group myresourcegroup --name mydemoserver