Guida introduttiva: Creare un'istanza di Database di Azure per PostgreSQL con l'interfaccia della riga di comando di AzureQuickstart: Create an Azure Database for PostgreSQL using the Azure CLI

Il database di Azure per PostgreSQL è un servizio gestito che consente di eseguire, gestire e ridimensionare database PostgreSQL a disponibilità elevata nel cloud.Azure Database for PostgreSQL is a managed service that enables you to run, manage, and scale highly available PostgreSQL databases in the 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.The Azure CLI is used to create and manage Azure resources from the command line or in scripts. Questa guida di avvio rapido mostra come creare un database di Azure per il server PostgreSQL in un gruppo di risorse di Azure tramite l'interfaccia della riga di comando di Azure.This quickstart shows you how to create an Azure Database for PostgreSQL server in an Azure resource group using the Azure CLI.

Se non si ha una sottoscrizione di Azure, creare un account gratuito prima di iniziare.If you don't have an Azure subscription, create a free account before you begin.

Aprire Azure Cloud ShellOpen Azure Cloud Shell

Azure Cloud Shell è una shell interattiva gratuita che può essere usata per eseguire la procedura di questo articolo.Azure Cloud Shell is a free, interactive shell that you can use to run the steps in this article. Gli strumenti comuni di Azure sono preinstallati e configurati in Cloud Shell per l'uso con l'account.Common Azure tools are preinstalled and configured in Cloud Shell for you to use with your account. È sufficiente selezionare il pulsante Copia per copiare il codice, incollarlo in Cloud Shell e quindi premere INVIO per eseguirlo.Just select the Copy button to copy the code, paste it in Cloud Shell, and then press Enter to run it. Esistono alcuni modi per aprire Cloud Shell:There are a few ways to open Cloud Shell:

Selezionare Prova nell'angolo superiore destro di un blocco di codice.Select Try It in the upper-right corner of a code block. Cloud Shell in questo articolo
Aprire Cloud Shell nel browser.Open Cloud Shell in your browser. https://shell.azure.com/bash
Selezionare il pulsante Cloud Shell nel menu nell'angolo superiore destro del portale di Azure.Select the Cloud Shell button on the menu in the upper-right corner of the Azure portal. Cloud Shell nel portale

Se si sceglie di installare e usare l'interfaccia della riga di comando in locale, per questo articolo è necessario eseguire la versione 2.0 o successiva dell'interfaccia della riga di comando di Azure.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. Per vedere la versione installata, eseguire il comando az --version.To see the version installed, run the az --version command. Se è necessario eseguire l'installazione o l'aggiornamento, vedere Installare l'interfaccia della riga di comando di Azure 2.0.If you need to install or upgrade, see Install Azure CLI 2.0.

Se si esegue l'interfaccia della riga di comando in locale, è necessario accedere al proprio account con il comando az login.If you are running the CLI locally, you need to log in to your account using the az login command. Si noti la proprietà id dell'output del comando per il nome della sottoscrizione corrispondente.Note the id property from the command output for the corresponding subscription name.

az login

Se si possiedono più sottoscrizioni, scegliere quella appropriata in cui verrà fatturata la risorsa.If you have multiple subscriptions, choose the appropriate subscription in which the resource should be billed. Selezionare l'ID sottoscrizione specifico sotto l'account tramite il comando az account set.Select the specific subscription ID under your account using az account set command. Sostituire la proprietà id dell'output az login per la sottoscrizione nel segnaposto dell'ID sottoscrizione.Substitute the id property from the az login output for your subscription into the subscription id placeholder.

az account set --subscription <subscription id>

Creare un gruppo di risorseCreate a resource group

Creare un gruppo di risorse di Azure con il comando az group create.Create an Azure resource group using the az group create command. Un gruppo di risorse è un contenitore logico in cui le risorse di Azure vengono distribuite e gestite come gruppo.A resource group is a logical container into which Azure resources are deployed and managed as a group. È necessario specificare un nome univoco.You should provide a unique name. Nell'esempio seguente viene creato un gruppo di risorse denominato myresourcegroup nella posizione westus.The following example creates a resource group named myresourcegroup in the westus location.

az group create --name myresourcegroup --location westus

Creare un database di Azure per il server PostgreSQLCreate an Azure Database for PostgreSQL server

Creare un database di Azure per il server PostgreSQL tramite il comando az postgres server create.Create an Azure Database for PostgreSQL server using the az postgres server create command. Un server contiene un gruppo di database gestiti come gruppo.A server contains a group of databases managed as a group.

L'esempio seguente crea negli Stati Uniti occidentali un server denominato mydemoserver nel gruppo di risorse myresourcegroup con l'account di accesso amministratore server myadmin.The following example creates a server in West US named mydemoserver in your resource group myresourcegroup with server admin login myadmin. Questo è un server per utilizzo generico di generazione 4 con 2 vCore.This is a Gen 4 General Purpose server with 2 vCores. Poiché viene eseguito il mapping del nome di un server a un nome DNS, il nome deve essere univoco a livello globale in Azure.The name of a server maps to DNS name and is thus required to be globally unique in Azure. Sostituire <server_admin_password> con il proprio valore.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

Il valore del parametro sku-name segue la convenzione {piano tariffario}_{generazione calcolo}_{vCore} come illustrato nell'esempio seguente:The sku-name parameter value follows the convention {pricing tier}_{compute generation}_{vCores} as in the examples below:

  • --sku-name B_Gen4_4 esegue il mapping a Basic, Gen 4 e 4 vCore.--sku-name B_Gen4_4 maps to Basic, Gen 4, and 4 vCores.
  • --sku-name GP_Gen5_32 esegue il mapping a utilizzo generico, Gen 5 e 32 vCore.--sku-name GP_Gen5_32 maps to General Purpose, Gen 5, and 32 vCores.
  • --sku-name MO_Gen5_2 esegue il mapping a ottimizzazione per la memoria, Gen 5 e 2 vCore.--sku-name MO_Gen5_2 maps to Memory Optimized, Gen 5, and 2 vCores.

Vedere la documentazione dei piani tariffari per comprendere i valori validi per area e livello.Please see the pricing tiers documentation to understand the valid values per region and per tier.

Importante

L'account di accesso amministratore server e la password qui specificati sono necessari per accedere al server e ai relativi database più avanti in questa guida di avvio rapido.The server admin login and password that you specify here are required to log in to the server and its databases later in this quickstart. Prendere nota di queste informazioni per usarle in seguito.Remember or record this information for later use.

Per impostazione predefinita, il database postgres viene creato al di sotto del server.By default, postgres database gets created under your server. Il database postgres è un database predefinito che può essere usato da utenti, utilità e applicazioni di terze parti.The postgres database is a default database meant for use by users, utilities, and third-party applications.

Configurare una regola del firewall a livello di serverConfigure a server-level firewall rule

Creare una regola del firewall a livello di server per PostgreSQL Azure tramite il comando az postgres server firewall-rule create.Create an Azure PostgreSQL server-level firewall rule with the az postgres server firewall-rule create command. Una regola del firewall a livello di server consente a un'applicazione esterna, ad esempio psql o PgAdmin, di connettersi al server tramite il firewall del servizio PostgreSQL Azure.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.

È possibile impostare una regola del firewall che copra un intervallo di indirizzi IP per consentire la connessione dalla rete in uso.You can set a firewall rule that covers an IP range to be able to connect from your network. L'esempio seguente usa az postgres server firewall-rule create per creare una regola del firewall AllowMyIP per un singolo indirizzo IP.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

Nota

Il server PostgreSQL Azure comunica sulla porta 5432.Azure PostgreSQL server communicates over port 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.When connecting from within a corporate network, outbound traffic over port 5432 may not be allowed by your network's firewall. Richiedere al reparto IT di aprire la porta 5432 per connettersi al server Azure PostgreSQL.Have your IT department open port 5432 to connect to your Azure PostgreSQL server.

Ottenere le informazioni di connessioneGet the connection information

Per connettersi al server, è necessario specificare le informazioni sull'host e le credenziali di accesso.To connect to your server, you need to provide host information and access credentials.

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

Il risultato è in formato JSON.The result is in JSON format. Annotare i valori di administratorLogin e 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": "Gen4",
    "name": "GP_Gen4_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"
}

Connettersi al database PostgreSQL tramite psqlConnect to PostgreSQL database using psql

Se nel computer client è installato PostgreSQL, è possibile usare un'istanza locale di psql per connettersi a un server PostgreSQL Azure.If your client computer has PostgreSQL installed, you can use a local instance of psql to connect to an Azure PostgreSQL server. È ora possibile usare l'utilità della riga di comando psql per connettersi al server PostgreSQL Azure.Let's now use the psql command-line utility to connect to the Azure PostgreSQL server.

  1. Eseguire il comando psql seguente per connettersi a un database di Azure per il server PostgreSQLRun the following psql command to connect to an Azure Database for PostgreSQL server

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

    Ad esempio, il comando seguente consente di connettersi al database predefinito denominato postgres nel server PostgreSQL mydemoserver.postgres.database.azure.com usando le credenziali di accesso.For example, the following command connects to the default database called postgres on your PostgreSQL server mydemoserver.postgres.database.azure.com using access credentials. Immettere il valore di <server_admin_password> scelto quando viene chiesta la password.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
    
  2. Dopo aver eseguito la connessione al server, creare un database vuoto nel prompt.Once you are connected to the server, create a blank database at the prompt.

    CREATE DATABASE mypgsqldb;
    
  3. Nel prompt, eseguire il comando seguente per cambiare la connessione nel database appena creato mypgsqldb:At the prompt, execute the following command to switch connection to the newly created database mypgsqldb:

    \c mypgsqldb
    

Connettersi al server PostgreSQL usando pgAdminConnect to the PostgreSQL Server using pgAdmin

pgAdmin è uno strumento open source usato con PostgreSQL.pgAdmin is an open-source tool used with PostgreSQL. È possibile installare pgAdmin dal sito Web pgadmin.You can install pgAdmin from the pgAdmin website. La versione di pgAdmin può essere diversa da quella usata in questa guida introduttiva.The pgAdmin version you're using may be different from what is used in this Quickstart. Se è necessario altro materiale sussidiario, vedere la documentazione di pgAdmin.Read the pgAdmin documentation if you need additional guidance.

  1. Aprire l'applicazione pgAdmin nel computer client.Open the pgAdmin application on your client computer.

  2. Dalla barra degli strumenti passare a Object (Oggetto), passare il puntatore del mouse su Create (Crea) e selezionare Server.From the toolbar go to Object, hover over Create, and select Server.

  3. Nella finestra di dialogo Create - Server (Creazione server) immettere un nome descrittivo univoco per il server nella scheda General (Generale), ad esempio mydemoserver.In the Create - Server dialog box, on the General tab, enter a unique friendly name for the server, such as mydemoserver.

    Scheda "General" (Generale)

  4. Nella finestra di dialogo Create - Server (Creazione server) compilare la tabella delle impostazioni nella scheda Connection (Connessione).In the Create - Server dialog box, on the Connection tab, fill in the settings table.

    Scheda "Connection" (Connessione)

    Parametro di pgAdminpgAdmin parameter ValoreValue DESCRIZIONEDescription
    Host name/address (Nome host/indirizzo)Host name/address Nome serverServer name Nome del server usato in precedenza al momento della creazione del database di Azure per il server PostgreSQL.The server name value that you used when you created the Azure Database for PostgreSQL server earlier. Il server di esempio è mydemoserver.postgres.database.azure.com.Our example server is mydemoserver.postgres.database.azure.com. Usare il nome di dominio completo (*.postgres.database.azure.com) come nell'esempio.Use the fully qualified domain name (*.postgres.database.azure.com) as shown in the example. Se non si ricorda il nome del server, seguire la procedura descritta nella sezione precedente per ottenere le informazioni di connessione.If you don't remember your server name, follow the steps in the previous section to get the connection information.
    PortaPort 54325432 Porta da usare quando ci si connette al database di Azure per il server PostgreSQL.The port to use when you connect to the Azure Database for PostgreSQL server.
    Maintenance Database (Database manutenzione)Maintenance database postgrespostgres Nome del database predefinito generato dal sistema.The default system-generated database name.
    UsernameUsername Nome di accesso amministratore serverServer admin login name Nome utente di accesso amministratore del server specificato in precedenza al momento della creazione del database di Azure per il server PostgreSQL.The server admin login username that you supplied when you created the Azure Database for PostgreSQL server earlier. Se non si ricorda il nome utente, seguire la procedura descritta nella sezione precedente per ottenere le informazioni di connessione.If you don't remember the username, follow the steps in the previous section to get the connection information. Il formato è username@servername.The format is username@servername.
    PasswordPassword Password amministratore dell'utenteYour admin password Password scelta in precedenza in questa guida introduttiva durante la creazione del server.The password you chose when you created the server earlier in this Quickstart.
    RuoloRole Lasciare vuotoLeave blank Non è necessario specificare un nome di ruolo in questa fase.There's no need to provide a role name at this point. Lasciare vuoto questo campo.Leave the field blank.
    SSL Mode (Modalità SSL)SSL mode Require (Richiedi)Require La modalità SSL può essere impostata nella scheda SSL di pgAdmin. Per impostazione predefinita, tutti i server Database di Azure per PostgreSQL vengono creati con l'opzione di applicazione del protocollo SSL attivata.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. Per disattivare l'applicazione del protocollo SSL, vedere Applicazione delle connessioni SSL.To turn off SSL enforcing, see SSL Enforcing.
  5. Selezionare Salva.Select Save.

  6. Nel riquadro Browser a sinistra espandere il nodo Servers (Server).In the Browser pane on the left, expand the Servers node. Selezionare il server, ad esempio mydemoserver.Select your server, for example, mydemoserver. Fare clic per connettersi.Click to connect to it.

  7. Espandere il nodo del server e quindi il nodo Databases (Database) sottostante.Expand the server node, and then expand Databases under it. L'elenco includerà il database postgres esistente e qualsiasi altro database creato.The list should include your existing postgres database and any other databases you've created. Con Database di Azure per PostgreSQL è possibile creare più database per ogni server.You can create multiple databases per server with Azure Database for PostgreSQL.

  8. Fare clic con il pulsante destro del mouse su Databases (Database), scegliere il menu Create (Crea) e quindi selezionare Database.Right-click Databases, choose the Create menu, and then select Database.

  9. Digitare un nome di database a scelta nel campo Database, ad esempio mypgsqldb2.Type a database name of your choice in the Database field, such as mypgsqldb2.

  10. Selezionare il proprietario del database nella casella di riepilogo.Select the Owner for the database from the list box. Scegliere il nome di accesso amministratore server, ad esempio myadmin.Choose your server admin login name, such as the example, my admin.

    Creare un database in pgAdmin

  11. Selezionare Save (Salva) per creare un nuovo database vuoto.Select Save to create a new blank database.

  12. Il database creato verrà visualizzato nel riquadro Browser nell'elenco dei database sotto il nome del server.In the Browser pane, you can see the database that you created in the list of databases under your server name.

Pulire le risorseClean up resources

Pulire tutte le risorse create nella guida di avvio rapido eliminando il gruppo di risorse di Azure.Clean up all resources you created in the quickstart by deleting the Azure resource group.

Suggerimento

Altre guide di avvio rapido di questa raccolta si basano sulla presente guida di avvio rapido.Other quickstarts in this collection build upon this quickstart. Se si prevede di continuare a usare le guide di avvio rapido successive, non pulire le risorse create in questa guida di avvio rapido.If you plan to continue to work with subsequent quickstarts, do not clean up the resources created in this quickstart. Se non si prevede di continuare, seguire questa procedura per eliminare tutte le risorse create da questa guida di avvio rapido nell'interfaccia della riga di comando di Azure.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

Se si vuole eliminare solo il server appena creato, è possibile eseguire il comando 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

Passaggi successiviNext steps