Guida introduttiva: Usare il comando az postgres up per creare un Database di Azure per PostgreSQL - Server singolo
SI APPLICA A:
Database di Azure per PostgreSQL - Server singolo
Importante
Database di Azure per PostgreSQL - Server singolo si trova nel percorso di ritiro. È consigliabile eseguire l'aggiornamento a Database di Azure per PostgreSQL - Server flessibile. Per altre informazioni sulla migrazione a Database di Azure per PostgreSQL - Server flessibile, vedere What's happening to Database di Azure per PostgreSQL Single Server?.
Il database di Azure per PostgreSQL è un servizio gestito che consente di eseguire, gestire e ridimensionare database PostgreSQL a disponibilità elevata nel cloud. L'interfaccia della riga di comando di Azure viene usata per creare e gestire le risorse di Azure dalla riga di comando o negli script. Questa guida di avvio rapido illustra come usare il comando az postgres up per creare un server Database di Azure per PostgreSQL con l'interfaccia della riga di comando di Azure. Oltre a creare il server, il comando az postgres up crea un database di esempio e un utente root nel database, apre il firewall per i servizi di Azure e crea regole del firewall predefinite per il computer client. Con queste impostazione predefinite il processo di sviluppo risulta più rapido.
Se non si ha una sottoscrizione di Azure, creare un account Azure gratuito prima di iniziare.
Creare un server di Database di Azure per PostgreSQL
Prerequisiti
Usare l'ambiente Bash in Azure Cloud Shell. Per altre informazioni, vedere la Avvio rapido di Bash in Azure Cloud Shell.
Se si preferisce eseguire i comandi di riferimento dell'interfaccia della riga di comando in locale, installare l'interfaccia della riga di comando di Azure. Per l'esecuzione in Windows o macOS, è consigliabile eseguire l'interfaccia della riga di comando di Azure in un contenitore Docker. Per altre informazioni, vedere Come eseguire l'interfaccia della riga di comando di Azure in un contenitore Docker.
Se si usa un'installazione locale, accedere all'interfaccia della riga di comando di Azure con il comando az login. Per completare il processo di autenticazione, seguire la procedura visualizzata nel terminale. Per altre opzioni di accesso, vedere Accedere tramite l'interfaccia della riga di comando di Azure.
Quando richiesto, al primo utilizzo installare l'estensione dell'interfaccia della riga di comando di Azure. Per altre informazioni sulle estensioni, vedere Usare le estensioni con l'interfaccia della riga di comando di Azure.
Eseguire az version per trovare la versione e le librerie dipendenti installate. Per eseguire l'aggiornamento alla versione più recente, eseguire az upgrade.
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 avviare Cloud Shell in una scheda separata del browser visitando https://shell.azure.com.
Quando si apre Cloud Shell, verificare che sia selezionato Bash per l'ambiente. Le sessioni successive useranno l'interfaccia della riga di comando di Azure in un ambiente Bash. Selezionare Copia per copiare i blocchi di codice, incollarli in Cloud Shell e premere Invio per eseguirli.
Accedere ad Azure
Cloud Shell viene autenticato automaticamente con l'account iniziale con cui è stato eseguito l'accesso. Usare lo script seguente per accedere usando una sottoscrizione diversa, sostituendo <Subscription ID> con l'ID sottoscrizione di Azure. Se non si ha una sottoscrizione di Azure, creare un account Azure gratuito prima di iniziare.
subscription="<subscriptionId>" # add subscription here
az account set -s $subscription # ...or use 'az login'
Per altre informazioni, vedere Impostare la sottoscrizione attiva oppure Accedere in modo interattivo
Installare l'estensione db-up . Se viene restituito un errore, verificare di aver installato l'ultima versione dell'interfaccia della riga di comando di Azure. Vedere Installare l'interfaccia della riga di comando di Azure.
az extension add --name db-up
Creare un server Database di Azure per PostgreSQL con il comando seguente:
az postgres up
Il server viene creato con i valori predefiniti seguenti, a meno che non si sostituiscano manualmente:
| Impostazione | Valore predefinito | Descrizione |
|---|---|---|
| server-name | Generato dal sistema | Nome univoco per identificare il database di Azure per il server PostgreSQL. |
| resource-group | Generato dal sistema | Nuovo gruppo di risorse di Azure. |
| sku-name | GP_Gen5_2 | Il nome dello SKU. Segue la convenzione {piano tariffario}_{generazione di calcolo}_{vCores} in abbreviato. L'impostazione predefinita è un server per utilizzo generico di quinta generazione con 2 vCore. Per altre informazioni sui livelli, vedere la pagina dei prezzi. |
| backup-retention | 7 | Per quanto tempo viene conservata una copia di backup. L'unità è giorni. |
| geo-redundant-backup | Disabled | Indica se abilitare i backup con ridondanza geografica per questo server. |
| posizione | westus2 | Località di Azure per il server. |
| ssl-enforcement | Disabled | Indica se TLS/SSL deve essere abilitato o meno per questo server. |
| storage-size | 5120 | Capacità di archiviazione del server (l'unità è MB). |
| versione | 10 | La versione principale di PostgreSQL. |
| admin-user | Generato dal sistema | Nome utente per l'amministratore. |
| admin-password | Generato dal sistema | Password dell'utente amministratore. |
Nota
Per altre informazioni sul comando az postgres up e i relativi parametri aggiuntivi, vedere la documentazione dell'interfaccia della riga di comando di Azure.
Dopo la creazione del server, vengono applicate le impostazioni seguenti:
- Viene creata una regola del firewall denominata "devbox". L'interfaccia della riga di comando di Azure prova a rilevare l'indirizzo IP del computer da cui viene eseguito il comando
az postgres upe consente tale indirizzo IP. - Viene attivata l'opzione "Consenti l'accesso a Servizi di Azure". Questa impostazione configura il firewall del server in modo da accettare connessioni da tutte le risorse di Azure, incluse le risorse non incluse nella sottoscrizione dell'utente.
- Viene creato un database vuoto denominato "sampledb".
- Viene creato un nuovo utente denominato "root" con privilegi per "sampledb".
Nota
Database di Azure per PostgreSQL comunica sulla porta 5432. Quando si esegue la connessione da una rete aziendale, il traffico in uscita sulla porta 5432 potrebbe non essere consentito dal firewall della rete. Richiedere al reparto IT di aprire la porta 5432 per la connessione al server.
Ottenere le informazioni di connessione
Al termine del comando az postgres up, viene restituito un elenco di stringhe di connessione per i linguaggi di programmazione più diffusi. Queste stringhe di connessione sono preconfigurate con gli attributi specifici del server Database di Azure per PostgreSQL appena creato.
È possibile visualizzare di nuovo l'elenco di queste stringhe di connessione usando il comando az postgres show-connection-string.
Pulire le risorse
Eseguire la pulizia di tutte le risorse create nell'avvio rapido con il comando seguente. Questo comando elimina il server Database di Azure per PostgreSQL e il gruppo di risorse.
az postgres down --delete-group
Se si vuole eliminare solo il server appena creato, è possibile eseguire az postgres down.
az postgres down