Esercitazione: Progettare un database di Azure per PostgreSQL - Server singolo usando PowerShell
SI APPLICA A:
Database di Azure per PostgreSQL - Server singolo
Importante
Database di Azure per PostgreSQL - Il server singolo è in fase di ritiro. È consigliabile eseguire l'aggiornamento a Database di Azure per PostgreSQL - Server flessibile. Per altre informazioni sulla migrazione a un server flessibile del Database di Azure per PostgreSQL, vedere Che cosa sta succedendo al server singolo del Database di Azure per PostgreSQL?.
Database di Azure per PostgreSQL è un servizio di database relazionale nel cloud Microsoft basato sul motore di database PostgreSQL Community Edition. Questa esercitazione illustra come eseguire le operazioni seguenti usando PowerShell e altre utilità:
- Creare un database di Azure per PostgreSQL
- Configurare il firewall del server
- Usare l'utilità psql per creare un database
- Caricare dati di esempio
- Eseguire query sui dati
- Aggiornamento dei dati
- Ripristinare i dati
Prerequisiti
Se non si ha una sottoscrizione di Azure, creare un account gratuito prima di iniziare.
Se si sceglie di usare PowerShell in locale, per questo articolo è necessario installare il modulo Az PowerShell e connettersi all'account di Azure usando il cmdlet Connect-AzAccount. Per altre informazioni sull'installazione del modulo Az PowerShell, vedere Installare Azure PowerShell.
Importante
Poiché il modulo Az.PostgreSql di PowerShell è in fase di anteprima, è necessario installarlo separatamente dal modulo Az PowerShell usando il comando seguente: Install-Module -Name Az.PostgreSql -AllowPrerelease.
Quando il modulo Az.PostgreSql di PowerShell sarà disponibile a livello generale, diventerà parte delle future versioni del modulo Az PowerShell e sarà disponibile in modo nativo dall'interno di Azure Cloud Shell.
Se è la prima volta che si usa il servizio Database di Azure per PostgreSQL, è necessario registrare il provider di risorse Microsoft.DBforPostgreSQL.
Register-AzResourceProvider -ProviderNamespace Microsoft.DBforPostgreSQL
Azure Cloud Shell
Azure Cloud Shell è un ambiente di shell interattivo ospitato in Azure e usato tramite il browser. È possibile usare Bash o PowerShell con Cloud Shell per usare i servizi di Azure. È possibile usare i comandi preinstallati di Cloud Shell per eseguire il codice contenuto in questo articolo senza dover installare strumenti nell'ambiente locale.
Per avviare Azure Cloud Shell:
| Opzione | Esempio/Collegamento |
|---|---|
| Selezionare Prova nell'angolo superiore destro di un blocco di codice o di comando. Quando si seleziona Prova, il codice o il comando non viene copiato automaticamente in Cloud Shell. |  |
| Passare a https://shell.azure.com o selezionare il pulsante Avvia Cloud Shell per aprire Cloud Shell nel browser. |  |
| Selezionare il pulsante Cloud Shell nella barra dei menu nell'angolo in alto a destra del portale di Azure. |  |
Per usare Azure Cloud Shell:
Avviare Cloud Shell.
Selezionare il pulsante Copia in un blocco di codice (o in un blocco di comando) per copiare il codice o il comando.
Incollare il codice o il comando nella sessione di Cloud Shell selezionando CTRL+MAIUSC+V in Windows e Linux o selezionando CMD+MAIUSC+V in macOS.
Premere Invio per eseguire il codice o il comando.
Se si possiedono più sottoscrizioni di Azure, scegliere quella appropriata in cui verranno fatturate le risorse. Selezionare un ID sottoscrizione specifico usando il cmdlet Set-AzContext.
Set-AzContext -SubscriptionId 00000000-0000-0000-0000-000000000000
Creare un gruppo di risorse
Creare un gruppo di risorse di Azure con il cmdlet New-AzResourceGroup. Un gruppo di risorse è un contenitore logico in cui le risorse di Azure vengono distribuite e gestite come gruppo.
L'esempio seguente crea un gruppo di risorse denominato myResourceGroup nell'area Stati Uniti occidentali.
New-AzResourceGroup -Name myresourcegroup -Location westus
Creare un server di Database di Azure per PostgreSQL
Creare un server di Database di Azure per PostgreSQL con il cmdlet New-AzPostgreSqlServer. Un server può gestire più database. In genere, viene usato un database separato per ogni progetto o per ogni utente.
Nell'esempio seguente nell'area Stati Uniti occidentali viene creato un server PostgreSQL denominato mydemoserver nel gruppo di risorse myresourcegroup con l'account di accesso di amministratore del server myadmin. Si tratta di un server di quinta generazione nel piano tariffario per utilizzo generico con 2 vCore e con i backup con ridondanza geografica abilitati. Prendere nota della password usata nella prima riga dell'esempio, perché si tratta della password per l'account amministratore del server PostgreSQL.
Suggerimento
Il nome del server è associato a un nome DNS e deve essere univoco a livello globale.
$Password = Read-Host -Prompt 'Please enter your password' -AsSecureString
New-AzPostgreSqlServer -Name mydemoserver -ResourceGroupName myresourcegroup -Sku GP_Gen5_2 -GeoRedundantBackup Enabled -Location westus -AdministratorUsername myadmin -AdministratorLoginPassword $Password
Il valore del parametro Sku segue la convenzione pricing-tier_compute-generation_vCores come illustrato negli esempi seguenti.
-Sku B_Gen5_1esegue il mapping a Basic, Gen 5 e 1 vCore. Questa opzione corrisponde allo SKU più piccolo disponibile.-Sku GP_Gen5_32esegue il mapping a utilizzo generico, Gen 5 e 32 vCore.-Sku MO_Gen5_2esegue il mapping a Ottimizzato per la memoria, Gen 5 e 2 vCore.
Per informazioni sui valori di SKU validi per aree e livelli, vedere Piani tariffari di Database di Azure per PostgreSQL.
È consigliabile usare il piano tariffario Basic se le esigenze di calcolo e di prestazioni di I/O sono adeguate per il carico di lavoro.
Importante
Si noti che per i server creati nel piano tariffario Basic non è possibile aumentare le prestazioni in un secondo momento passando a un piano per utilizzo generico o con ottimizzazione della memoria e non è possibile abilitare la replica geografica.
Configurare una regola del firewall
Creare una regola del firewall a livello di server di Database di Azure per PostgreSQL usando il cmdlet New-AzPostgreSqlFirewallRule. Una regola del firewall a livello di server consente a un'applicazione esterna, ad esempio lo strumento della riga di comando psql o PostgreSQL Workbench, di connettersi al server tramite il firewall del servizio Database di Azure per PostgreSQL.
L'esempio seguente crea una regola del firewall denominata AllowMyIP che consente connessioni da un indirizzo IP specifico, 192.168.0.1. Sostituire con un indirizzo IP o un intervallo di indirizzi IP corrispondente alla posizione da cui ci si connette.
New-AzPostgreSqlFirewallRule -Name AllowMyIP -ResourceGroupName myresourcegroup -ServerName mydemoserver -StartIPAddress 192.168.0.1 -EndIPAddress 192.168.0.1
Nota
Le connessioni a Database di Azure per PostgreSQL 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 scenario è possibile connettersi al server solo se il reparto IT apre la porta 5432.
Ottenere le informazioni di connessione
Per connettersi al server, è necessario specificare le informazioni sull'host e le credenziali di accesso. Usare questo esempio per determinare le informazioni di connessione. Prendere nota dei valori per FullyQualifiedDomainName e AdministratorLogin.
Get-AzPostgreSqlServer -Name mydemoserver -ResourceGroupName myresourcegroup |
Select-Object -Property FullyQualifiedDomainName, AdministratorLogin
FullyQualifiedDomainName AdministratorLogin
------------------------ ------------------
mydemoserver.postgresql.database.azure.com myadmin
Connettersi al database PostgreSQL tramite psql
Se nel computer client è installato PostgreSQL, è possibile usare un'istanza locale di psql per connettersi a un server PostgreSQL Azure. È anche possibile accedere a una versione preinstallata dello strumento da riga di comando psql in Azure Cloud Shell selezionando il pulsante Prova in un esempio di codice in questo articolo. In alternativa, per accedere ad Azure Cloud Shell è possibile selezionare il pulsante >_ sulla barra degli strumenti in alto a destra nel portale di Azure oppure visitare la pagina shell.azure.com.
Connettersi al server PostgreSQL di Azure usando l'utilità da riga di comando
psql.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
mydemoserver.postgres.database.azure.comusando le credenziali di accesso. Immettere il valore di<server_admin_password>scelto quando viene chiesta la password.psql --host=mydemoserver.postgres.database.azure.com --port=5432 --username=myadmin@mydemoserver --dbname=postgresSuggerimento
Se si preferisce usare un percorso URL per connettersi a Postgres, l'URL codifica il segno @ nel nome utente con
%40. Ad esempio, la stringa di connessione per psql saràpsql postgresql://myadmin%40mydemoserver@mydemoserver.postgres.database.azure.com:5432/postgresDopo aver eseguito la connessione al server, creare un database vuoto nel prompt.
CREATE DATABASE mypgsqldb;Nel prompt, eseguire il comando seguente per cambiare la connessione nel database appena creato mypgsqldb:
\c mypgsqldb
Creare tabelle nel database
Una volta appreso come connettersi al database del servizio Database di Azure per PostgreSQL, completare alcune attività di base.
In primo luogo, creare una tabella e caricarvi alcuni dati. Creare una tabella che contenga le informazioni riguardanti l'inventario.
CREATE TABLE inventory (
id serial PRIMARY KEY,
name VARCHAR(50),
quantity INTEGER
);
Caricare i dati nelle tabelle
Dopo aver creato una tabella, inserire alcuni dati. Nella finestra del prompt dei comandi aperta, eseguire la query seguente per inserire alcune righe di dati.
INSERT INTO inventory (id, name, quantity) VALUES (1, 'banana', 150);
INSERT INTO inventory (id, name, quantity) VALUES (2, 'orange', 154);
A questo punto, ci sono due righe di dati di esempio nella tabella creata in precedenza.
Eseguire una query e aggiornare i dati nelle tabelle
Eseguire la query seguente per recuperare informazioni dalla tabella del database.
SELECT * FROM inventory;
Si possono anche aggiornare query e aggiornare i dati nelle tabelle.
UPDATE inventory SET quantity = 200 WHERE name = 'banana';
La riga viene aggiornata di conseguenza quando si recuperano dati.
SELECT * FROM inventory;
Ripristinare un database a un momento precedente
È possibile ripristinare il server in base a una temporizzazione precedente. I dati ripristinati vengono copiati in un nuovo server e il server esistente non viene modificato. Se, ad esempio, una tabella è stata eliminata involontariamente, è possibile eseguire il ripristino a un qualsiasi momento prima dell'eliminazione. È possibile quindi recuperare la tabella e i dati mancanti dalla copia ripristinata del server.
Per ripristinare il server, usare il cmdlet Restore-AzPostgreSqlServer di PowerShell.
Eseguire il comando di ripristino
Per ripristinare il server, eseguire l'esempio seguente da PowerShell.
$restorePointInTime = (Get-Date).AddMinutes(-10)
Get-AzPostgreSqlServer -Name mydemoserver -ResourceGroupName myresourcegroup |
Restore-AzPostgreSqlServer -Name mydemoserver-restored -ResourceGroupName myresourcegroup -RestorePointInTime $restorePointInTime -UsePointInTimeRestore
Quando si ripristina un server a una temporizzazione precedente, viene creato un nuovo server. Il server originale e i database della temporizzazione specificata vengono copiati nel nuovo server.
I valori relativi al percorso e al piano tariffario per il server ripristinato sono gli stessi del server di origine.
Al termine del ripristino, individuare il nuovo server creato per verificare che il ripristino dei dati sia avvenuto come previsto. Il nuovo server ha il nome e la password di accesso dell'amministratore del server che erano validi per il server esistente quando è stato avviato il ripristino. È possibile modificare la password dalla pagina Panoramica del nuovo server.
Il nuovo server creato durante un ripristino non include gli endpoint servizio di rete virtuale presenti nel server originale. Queste regole devono essere configurate separatamente per il nuovo server. Vengono ripristinate le regole del firewall del server originale.
Pulire le risorse
Nei passaggi precedenti sono state create risorse di Azure in un gruppo di server. Se non si prevede di avere bisogno di queste risorse in futuro, eliminare il gruppo di server. Fare clic sul pulsante Elimina nella pagina Panoramica per il gruppo di server. Quando viene visualizzata la richiesta in una pagina popup, verificare il nome del gruppo di server e selezionare il pulsante Elimina in basso.