Creare un database di Azure per PostgreSQL tramite l'interfaccia della riga di comando di AzureCreate 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.

Avviare Azure Cloud ShellLaunch Azure Cloud Shell

Azure Cloud Shell è una shell Bash gratuita che può essere eseguita direttamente nel portale di Azure.The Azure Cloud Shell is a free Bash shell that you can run directly within the Azure portal. Include l'interfaccia della riga di comando di Azure preinstallata e configurata per l'uso con l'account.It has the Azure CLI preinstalled and configured to use with your account. Fare clic sul pulsante Cloud Shell nel menu nel riquadro in alto a destra nel portale di Azure.Click the Cloud Shell button on the menu in the upper-right of the Azure portal.

Cloud ShellCloud Shell

Il pulsante avvia una shell interattiva che è possibile usare per eseguire i passaggi di questo argomento:The button launches an interactive shell that you can use to run the steps in this topic:

Screenshot che mostra la finestra di Cloud Shell nel portaleScreenshot showing the Cloud Shell window in the portal

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. Eseguire az --version per trovare la versione.Run az --version to find the version. 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.

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 un ID di sottoscrizione specifico sotto l'account tramite il comando az account set.Select a specific subscription ID under your account using az account set command.

az account set --subscription 00000000-0000-0000-0000-000000000000

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. 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 un server chiamato mypgserver-20170401 nel gruppo di risorse myresourcegroup con account di accesso dell'amministratore del server mylogin.The following example creates a server named mypgserver-20170401 in your resource group myresourcegroup with server admin login mylogin. 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 valore desiderato.Substitute the <server_admin_password> with your own value.

az postgres server create --resource-group myresourcegroup --name mypgserver-20170401  --location westus --admin-user mylogin --admin-password <server_admin_password> --performance-tier Basic --compute-units 50 --version 9.6

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 introduttiva.The server admin login and password that you specify here are required to log in to the server and its databases later in this quick start. 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 relativa a un intervallo IP per consentire la connessione dalla rete.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 AllowAllIps per un intervallo di indirizzi IP.The following example uses az postgres server firewall-rule create to create a firewall rule AllowAllIps for an IP address range. Per aprire tutti gli indirizzi IP, usare 0.0.0.0 come indirizzo IP iniziale e 255.255.255.255 come indirizzo finale.To open all IP addresses, use 0.0.0.0 as the starting IP address and 255.255.255.255 as the ending address.

az postgres server firewall-rule create --resource-group myresourcegroup --server mypgserver-20170401 --name AllowAllIps --start-ip-address 0.0.0.0 --end-ip-address 255.255.255.255

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 di database SQL di Azure.Have your IT department open port 5432 to connect to your Azure SQL Database 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 mypgserver-20170401

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": "mylogin",
  "fullyQualifiedDomainName": "mypgserver-20170401.postgres.database.azure.com",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myresourcegroup/providers/Microsoft.DBforPostgreSQL/servers/mypgserver-20170401",
  "location": "westus",
  "name": "mypgserver-20170401",
  "resourceGroup": "myresourcegroup",
  "sku": {
    "capacity": 50,
    "family": null,
    "name": "PGSQLS2M50",
    "size": null,
    "tier": "Basic"
  },
  "sslEnforcement": null,
  "storageMb": 51200,
  "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 permette di connettersi al database predefinito chiamato postgres nel server PostgreSQL mypgserver-20170401.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 mypgserver-20170401.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=mypgserver-20170401.postgres.database.azure.com --port=5432 --username=mylogin@mypgserver-20170401 --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 e connettersi al nuovo database mypgsqldb appena creato:At the prompt, execute the following command to switch connection to the newly created database mypgsqldb:

    \c mypgsqldb
    

Connettersi al database PostgreSQL tramite pgAdminConnect to PostgreSQL database using pgAdmin

Per connettersi al server PostgreSQL Azure tramite lo strumento dell'interfaccia utente grafica pgAdminTo connect to Azure PostgreSQL server using the GUI tool pgAdmin

  1. Avviare l'applicazione pgAdmin nel computer client.Launch the pgAdmin application on your client computer. È possibile installare pgAdmin da http://www.pgadmin.org/.You can install pgAdmin from http://www.pgadmin.org/.
  2. Scegliere Add New Server (Aggiungi nuovo server) dal menu Quick Links (Collegamenti rapidi).Choose Add New Server from the Quick Links menu.
  3. Nella finestra di dialogo Create - Server (Creazione server), nella scheda General (Generale), immettere un nome descrittivo univoco per il server.In the Create - Server dialog box General tab, enter a unique friendly Name for the server. Ad esempio, Azure PostgreSQL Server.Say Azure PostgreSQL Server. Strumento pgAdmin - Finestra di creazione del serverpgAdmin tool - create - server
  4. Nella finestra di dialogo Create - Server (Creazione server) fare clic sulla scheda Connection (Connessione):In the Create - Server dialog box, Connection tab:

    • Immettere il nome del server completo, ad esempio mypgserver-20170401.postgres.database.azure.com, nella casella Host Name/ Address (Nome host/Indirizzo).Enter the fully qualified server name (for example, mypgserver-20170401.postgres.database.azure.com) in the Host Name/ Address box.
    • Immettere la porta 5432 nella casella Port (Porta).Enter port 5432 into the Port box.
    • Immettere l'account di accesso dell'amministratore del server (user@mypgserver) ottenuto in precedenza in questa guida di avvio rapido e la password immessa alla creazione del server rispettivamente nelle caselle Username (Nome utente) e Password.Enter the Server admin login (user@mypgserver) obtained earlier in this quickstart and password you entered when you created the server into the Username and Password boxes, respectively.
    • Selezionare SSL Mode (Modalità SSL) e impostare Require (Richiedi).Select SSL Mode as Require. Per impostazione predefinita, tutti i server PostgreSQL Azure vengono creati con l'opzione di applicazione del protocollo SSL attivata.By default, all Azure PostgreSQL servers are created with SSL enforcing turned ON. Per disattivare questa opzione, vedere le informazioni dettagliate in Enforcing SSL (Applicazione di SSL).To turn OFF SSL enforcing, see details in Enforcing SSL.

    pgAdmin - Finestra di creazione del server

  5. Fare clic su Salva.Click Save.
  6. Nel riquadro sinistro Browser espandere i gruppi Server.In the Browser left pane, expand the Server Groups. Scegliere il server Azure PostgreSQL Server.Choose your server Azure PostgreSQL Server.
  7. In Server scegliere il server a cui si è connessi e quindi scegliere Databases (Database) sotto il server.Choose the Server you connected to, and then choose Databases under it.
  8. Fare clic con il pulsante destro del mouse su Databases (Database) per creare un database.Right-click on Databases to Create a Database.
  9. Scegliere il nome di database mypgsqldb e il proprietario, rappresentato dall'account di accesso dell'amministratore del server mylogin.Choose a database name mypgsqldb and the owner for it as server admin login mylogin.
  10. Fare clic su Save (Salva) per creare un database vuoto.Click Save to create a blank database.
  11. In Browser espandere il gruppo Servers (Server).In the Browser, expand the Servers group. Espandere il server creato e visualizzare il database mypgsqldb al di sotto.Expand the server you created, and see the database mypgsqldb under it. pgAdmin - Finestra di creazione del databasepgAdmin - Create - Database

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 mypgserver-20170401

Passaggi successiviNext steps