Gestire un server singolo Database di Azure per PostgreSQL usando l'interfaccia della riga di comando di Azure

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?.

Questo articolo illustra come gestire i server singoli distribuiti in Azure. Le attività di gestione includono il ridimensionamento delle risorse di calcolo e archiviazione, la reimpostazione della password amministratore e la visualizzazione dei dettagli del server.

Prerequisiti

Se non si ha una sottoscrizione di Azure, creare un account gratuito prima di iniziare. Per questo articolo è necessario eseguire in locale l'interfaccia della riga di comando di Azure versione 2.0 o successiva. Per vedere la versione installata, eseguire il comando az --version. Se è necessario eseguire l'installazione o l'aggiornamento, vedere Installare l'interfaccia della riga di comando di Azure.

È necessario accedere all'account con il comando az login. Prendere nota della proprietà id che fa riferimento all'ID sottoscrizione per l'account Azure.

az login

Selezionare la sottoscrizione specifica nell'account tramite il comando az account set. Annotare il valore id dall'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>

Se non è già stato creato un server, fare riferimento a questa guida introduttiva per crearne uno.

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 in questo articolo, senza dover installare alcun elemento 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. Screenshot che mostra un esempio di Prova per Azure Cloud Shell.
Passare a https://shell.azure.com o selezionare il pulsante Avvia Cloud Shell per aprire Cloud Shell nel browser. Pulsante per avviare Azure Cloud Shell.
Selezionare il pulsante Cloud Shell nella barra dei menu nell'angolo in alto a destra del portale di Azure. Screenshot che mostra il pulsante Cloud Shell nel portale di Azure

Per usare Azure Cloud Shell:

  1. Avviare Cloud Shell.

  2. Selezionare il pulsante Copia in un blocco di codice (o in un blocco di comando) per copiare il codice o il comando.

  3. 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.

  4. Selezionare INVIO per eseguire il codice o il comando.

Ridimensionare le risorse di calcolo e archiviazione

È possibile aumentare facilmente il piano tariffario, il calcolo e l'archiviazione usando il comando seguente. È possibile visualizzare tutte le operazioni del server che è possibile eseguire az postgres server overview

az postgres server update --resource-group myresourcegroup --name mydemoserver --sku-name GP_Gen5_4 --storage-size 6144

Ecco i dettagli per gli argomenti indicati:

Impostazione Valore di esempio Descrizione
name mydemoserver Immettere un nome univoco per il server Database di Azure per PostgreSQL. Il nome del server può contenere solo lettere minuscole, numeri e il segno meno (-) e deve avere una lunghezza compresa tra 3 e 63 caratteri.
resource-group myresourcegroup Specificare il nome del gruppo di risorse di Azure.
sku-name GP_Gen5_2 Immettere il nome del piano tariffario e della configurazione delle risorse di calcolo. Segue la convenzione {piano tariffario}{generazione di calcolo}{Vcore} in sintassi abbreviata. Per altre informazioni, vedere i piani tariffari.
storage-size 6144 Capacità di archiviazione del server (l'unità è MB). Minimo 5120 e incrementi in incrementi di 1024.

Importante

  • Archiviazione possono essere ridimensionate (tuttavia, non è possibile ridurre le risorse di archiviazione)
  • La scalabilità verticale da Basic a Utilizzo generico o Piano tariffario ottimizzato per la memoria non è supportata. È possibile aumentare manualmente le prestazioni con uno script bash o usando PostgreSQL Workbench

Gestire i database PostgreSQL in un server.

È possibile usare uno di questi comandi per creare, eliminare, elencare e visualizzare le proprietà del database di un database nel server

Cmdlet Utilizzo Descrizione
az postgres db create az postgres db create -g myresourcegroup -s mydemoserver -n mydatabasename Crea un database
az postgres db delete az postgres db delete -g myresourcegroup -s mydemoserver -n mydatabasename Eliminare il database dal server. Questo comando non elimina il server.
az postgres db list az postgres db list -g myresourcegroup -s mydemoserver elenca tutti i database nel server
az postgres db show az postgres db show -g myresourcegroup -s mydemoserver -n mydatabasename Mostra altri dettagli del database

Aggiornare la password amministratore

È possibile modificare la password del ruolo amministratore con questo comando

az postgres server update --resource-group myresourcegroup --name mydemoserver --admin-password <new-password>

Importante

Assicurarsi che la password abbia un minimo di 8 caratteri e un massimo di 128 caratteri. La password deve contenere caratteri di tre delle categorie seguenti: lettere maiuscole, lettere minuscole, numeri e caratteri non alfanumerici.

Eliminare un server

Se si vuole eliminare il server singolo PostgreSQL, è possibile eseguire il comando az postgres server delete .

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

Passaggi successivi