Creare un server PostgreSQL

L'estensione PostgreSQL per Visual Studio Code consente di creare nuovi server PostgreSQL senza uscire dall'editor. È possibile creare un contenitore Docker locale per lo sviluppo e il test, effettuare il provisioning di un server flessibile Database di Azure per PostgreSQL completamente gestito per i carichi di lavoro di produzione o creare un cluster Azure HorizonDB (anteprima) per scenari su larga scala.

Prerequisiti

  • Visual Studio Code con l'estensione installata.
  • Per un server Docker locale:Docker Desktop è installato e il daemon Docker è in esecuzione. Verificare eseguendo docker info in un terminale.
  • Per un server Azure: un account Azure con una sottoscrizione attiva. Se non ne hai uno, crea gratuitamente un account.
  • Per un cluster Azure HorizonDB (anteprima): un account Azure con una sottoscrizione attiva e l'accesso a Azure HorizonDB (anteprima).

Aprire l'hub Crea nuovo server

  1. Nel contenitore Barra attività PostgreSQL individuare l'albero Connessioni .

  2. Selezionare il pulsante Crea nuovo server nella parte superiore dell'albero Connessioni oppure eseguire pgsql.createNewServer dal riquadro comandi.

    È anche possibile fare clic con il pulsante destro del mouse su un gruppo di server nell'albero Connessioni e scegliere Crea nuovo server.

L'hub Crea nuovo server PostgreSQL viene aperto in una nuova scheda dell'editor. Presenta tre opzioni:

Opzione Descrizione
Creare un server PostgreSQL Docker locale Crea un server PostgreSQL in un contenitore Docker locale. Ideale per lo sviluppo, il test e l'apprendimento.
Creazione di un'istanza di Server flessibile di Database di Azure per PostgreSQL Effettua il provisioning di un server PostgreSQL completamente gestito in Azure. Adatto a carichi di lavoro in produzione e ambienti di team.
Creare un'istanza di HorizonDB Azure (anteprima) Effettua il provisioning di un cluster PostgreSQL nativo del cloud altamente scalabile in Azure.

Selezionare la scheda corrispondente allo scenario.

Creare un server locale con Docker

I contenitori Docker offrono un'istanza PostgreSQL leggera e isolata che viene eseguita nel computer. Usare questa opzione per lo sviluppo locale, la creazione di prototipi o quando è necessario un ambiente di database eliminabile.

Passaggio 1: Esaminare l'introduzione

Dopo aver selezionato la scheda Crea un server Docker PostgreSQL locale , l'estensione mostra una pagina di destinazione denominata Seamless PostgreSQL Server on Docker, Right in VS Code!. La pagina evidenzia le funzionalità principali:

  • Creazione del server con un clic: Crea un server PostgreSQL in pochi secondi senza alcuna configurazione manuale.
  • Installazione completamente automatizzata: l'estensione esegue il pull, la configurazione e l'esecuzione di PostgreSQL in un ambiente isolato.
  • Gestione semplice: avviare, arrestare o rimuovere il contenitore PostgreSQL in qualsiasi momento.

Selezionare Inizia per continuare.

Passaggio 2: Passare il controllo dei prerequisiti

L'estensione verifica che Docker sia installato e in esecuzione. La schermata Verifica dei prerequisiti mostra lo stato di ogni controllo:

  • Verifica che Docker sia installato: verifica che la CLI di Docker sia disponibile sul tuo PATH.
  • Verifica se Docker è in esecuzione in background: conferma che il daemon Docker è attivo.

Se un controllo non riesce, seguire il collegamento sullo schermo per installare o avviare Docker, quindi tornare a questa pagina. L'estensione esegue nuovamente i controlli automaticamente.

Passaggio 3: Configurare la connessione

Dopo aver superato i prerequisiti, viene visualizzato il modulo Configura la connessione . Compilare i campi seguenti:

Impostazione Obbligatorio Descrizione
Nome connessione No Un nome visualizzato intuitivo per il profilo di connessione. Funge anche da nome del contenitore predefinito (gli spazi vengono sostituiti con caratteri di sottolineatura).
Nome contenitore Yes Nome del contenitore Docker. Caratteri consentiti: a-zA-Z0-9_.-.
Nome utente Yes Nome utente con privilegi avanzati per l'istanza di PostgreSQL. Di default è postgres.
Password Yes Password per l'account con privilegi avanzati.
Salva password No Se questa opzione è selezionata, archivia la password in modo che non sia necessario immetterla in ogni connessione.
Nome del database No Nome del database iniziale. Di default è postgres.

Selezionare Opzioni avanzate per espandere impostazioni aggiuntive:

Impostazione Descrizione
Porta associata Porta dell'host associata alla porta PostgreSQL del contenitore (porta del contenitore 5432). Se lasciato vuoto, l'estensione assegna automaticamente una porta libera nell'intervallo 54500-55000. Intervallo valido: 1-65535.
Versione dell'immagine Tag dell'immagine Docker da scaricare. Di default è latest.
Registro immagini URL del registro contenitori (ad esempio, myregistry.azurecr.io). L'impostazione predefinita è Docker Hub.
Nome immagine Nome dell'immagine Docker. Di default è postgres.
Piattaforma immagini Destinazione della piattaforma per ambienti con più architetture ( ad esempio , linux/amd64).

Passaggio 4: Creare e connettersi

Selezionare Crea per avviare il provisioning. L’estensione:

  1. Esegue il pull dell'immagine postgres Docker (se non è già memorizzata nella cache).
  2. Crea e avvia il contenitore con le impostazioni specificate.
  3. Attende che PostgreSQL diventi pronto (usando pg_isready).
  4. Crea un profilo di connessione e si connette automaticamente.

Durante l'inizializzazione del contenitore viene visualizzato un indicatore di stato denominato Creazione di un server Docker locale . Quando il contenitore è pronto, il server viene visualizzato nell'albero Connessioni ed è possibile iniziare immediatamente a eseguire query.

Tip

Il contenitore Docker rimane disponibile anche dopo il riavvio di Visual Studio Code. Per arrestare, avviare, rimuovere o controllare il contenitore all'esterno dell'estensione, usare l'interfaccia della riga di comando di Docker o Docker Desktop.

Creare un server flessibile di Database di Azure per PostgreSQL

Database di Azure per PostgreSQL server flessibile è un servizio di database completamente gestito che offre disponibilità elevata, backup automatizzati e ottimizzazione intelligente delle prestazioni. L'estensione illustra una procedura guidata in più passaggi per effettuare il provisioning di un nuovo server direttamente da Visual Studio Code.

Passaggio 1: Esaminare l'introduzione

Dopo aver selezionato la scheda Crea un'istanza del server flessibile di Database di Azure per PostgreSQL, una pagina di destinazione descrive le funzionalità del servizio:

  • Integrazione Azure facile: effettuare il provisioning dei server direttamente in Visual Studio Code con supporto per l'autenticazione Entra ID.
  • Calcolo flessibile e archiviazione: scegliere tra livelli di calcolo preconfigurati e opzioni di archiviazione.
  • Gestione semplificata dei server: gestire il ciclo di vita, le prestazioni e la configurazione senza uscire dall'editor.
  • Creato per gli sviluppatori: concentrarsi sull'applicazione mentre Azure gestisce l'infrastruttura.

Selezionare Inizia per continuare. Facoltativamente, selezionare Non visualizzare di nuovo questa pagina per ignorare questa pagina in futuro.

Passaggio 2: Accedere a Azure

L'estensione apre una pagina di accesso con il messaggio "Accedere all'account Azure con Entra ID per creare un'istanza del server flessibile Database di Azure per PostgreSQL".

  • Se si dispone già di un account Azure connesso a Visual Studio Code, l'estensione usa automaticamente tali credenziali.
  • Se sono presenti più account o tenant Azure, usare il selettore di account e il selettore tenant per scegliere l'identità corretta.

Passaggio 3: Configurare le impostazioni del server

Dopo l'autenticazione, l'estensione visualizza un modulo di configurazione organizzato in sezioni. Un pannello di stima dei costi sulla destra si aggiorna man mano che si effettuano le selezioni.

Dettagli del progetto

Impostazione Descrizione
Subscription Selezionare la sottoscrizione Azure che gestisce la fatturazione e l'accesso. Sono elencate tutte le sottoscrizioni per l'account e il tenant connessi.
Gruppo di risorse Selezionare un gruppo di risorse esistente o selezionare Crea nuovo per crearne uno. Il nuovo gruppo di risorse viene distribuito nella stessa area del server.

Nozioni di base

Impostazione Descrizione
Nome server Nome univoco globale per il server. L'estensione verifica la disponibilità in modo asincrono e mostra un errore se il nome è già in uso. Il nome del server diventa parte del nome host della connessione (<server-name>.postgres.database.azure.com).
Area geografica Area Azure in cui viene distribuito il server. L'estensione verifica che la sottoscrizione consenta il provisioning nell'area selezionata.
Calcolo e archiviazione Selezionare un livello di calcolo e archiviazione preconfigurato. Le aggregazioni disponibili sono:
Bundle vCores Storage SKU
Dev/Test (impostazione predefinita) 2 128 GB Standard_D2ds_v4
Standard 4 256 GB Standard_D4ds_v4
Prestazioni 8 512 gigabyte Standard_D8ds_v4

Tip

È possibile personalizzare ulteriormente le risorse di calcolo e archiviazione usando il pulsante Crea in portale di Azure nella parte inferiore del modulo, che apre l'esperienza completa di creazione Azure portal.

Impostazione Descrizione
Versione di PostgreSQL Versione principale di PostgreSQL da distribuire. Versioni disponibili: 18, 17, 16, 15 e 14. Il valore predefinito è 18. Le versioni disponibili possono variare in base all'area.

Authentication

Il modulo mostra una sezione ADMINISTRATOR ACCESS . È necessario abilitare almeno un metodo di autenticazione.

Impostazione Descrizione
Usa il mio Entra ID: <email> Casella di controllo che configura l'identità Entra ID dell'utente connesso come amministratore del server. Il messaggio di posta elettronica viene popolato automaticamente dall'account di accesso Azure.
Creare un utente e una password postgreSQL Casella di controllo che abilita l'autenticazione postgreSQL tradizionale. Se selezionata, vengono visualizzati tre campi aggiuntivi.

Quando si seleziona Crea utente e password PostgreSQL, specificare quanto segue:

Impostazione Descrizione
Nome utente amministratore Nome di accesso per l'account amministratore postgreSQL , ad esempio pgadmin. Deve iniziare con una lettera e contenere solo lettere, numeri e caratteri di sottolineatura. Non è possibile usare nomi riservati, adminad esempio , rootguest, o nomi che iniziano con pg_.
Password amministratore Password per l'account amministratore. Deve essere composto da 8 a 128 caratteri e includere almeno tre lettere maiuscole, lettere minuscole, numeri e simboli.
Confermare la password dell'amministratore Immettere nuovamente la password dell'amministratore.

Note

È possibile abilitare entrambi i metodi di autenticazione contemporaneamente. Ad esempio, Entra ID per i membri del team e l'autenticazione PostgreSQL per le stringhe di connessione dell'applicazione.

Stima dei costi

Il pannello Costi stimati a destra del modulo suddivide i prezzi mensili:

  • Calcolo: in base allo SKU e al numero di vCore selezionati.
  • Archiviazione: in base al livello di archiviazione selezionato.
  • Backup: costo del backup incluso.
  • Larghezza di banda: il trasferimento dei dati in uscita tra aree comporta costi aggiuntivi; il trasferimento in ingresso è gratuito.

Il pannello mostra un totale stimato e collegamenti al calcolatore prezzi Azure per informazioni dettagliate sui prezzi.

Passaggio 4: Accettare termini e distribuire

Nella parte inferiore del modulo:

  1. Selezionare la casella di controllo Conferma che la creazione di questo server potrebbe comportare addebiti .
  2. Esaminare le Condizioni per l'utilizzo e l'informativa sulla privacy collegate.
  3. Selezionare Crea per iniziare il provisioning.

L'estensione passa a una pagina di stato che tiene traccia di ogni fase della distribuzione:

Stage Valori di stato
Provisioning del server In sospeso, In corso, Completato, Non riuscito
Assegnazione di regole del firewall In sospeso, In corso, Completato, Ignorato
Assegnazione amministratore Entra In sospeso, In corso, Completato, Ignorato

Un riepilogo della distribuzione mostra il nome del server, la sottoscrizione, il gruppo di risorse, l'area e la configurazione selezionati.

Durante la distribuzione, è possibile continuare a lavorare in Visual Studio Code. La distribuzione continua a essere eseguita in background anche se si chiude la pagina di avanzamento.

Al termine di tutte le fasi, l'intestazione viene aggiornata al server creata correttamente e viene visualizzato il messaggio "Il server flessibile PostgreSQL è pronto". L'estensione crea automaticamente un profilo di connessione per il nuovo server. Selezionare Fine per chiudere la pagina di stato.

Note

Se una fase viene completata con avvisi, lo stato viene visualizzato Completato con avvisi. Esaminare i dettagli prima della connessione.

Tenere traccia delle distribuzioni di Azure

La visualizzazione distribuzioni Azure nella barra delle attività di PostgreSQL mostra tutte le distribuzioni di server in corso e completate Azure. Ogni voce visualizza il nome del server, lo stato della distribuzione e il timestamp.

Fare clic con il pulsante destro su una distribuzione per accedere alle seguenti azioni:

Action Descrizione
Apri in portale di Azure Apre la pagina delle risorse del server nel portale di Azure.
Rimuovi distribuzione Rimuove la voce di distribuzione dal tracker. Questa azione non elimina la risorsa Azure.

Usare il pulsante Rimuovi completato nella barra degli strumenti di visualizzazione per cancellare tutte le distribuzioni completate dall'elenco.

Tip

Se una distribuzione Azure ha esito negativo, selezionare Riprova nella pagina di avanzamento per riavviare il provisioning o selezionare Torna al modulo per modificare le impostazioni.

Creare un cluster di Azure HorizonDB (anteprima)

Azure HorizonDB (anteprima) è un cluster PostgreSQL nativo del cloud altamente scalabile in Azure. L'estensione illustra una procedura guidata in più passaggi per effettuare il provisioning di un nuovo cluster.

Note

La disponibilità di Azure HorizonDB (anteprima) dipende dalla sottoscrizione di Azure e dall'area geografica.

Passaggio 1: Esaminare l'introduzione

Dopo aver selezionato la scheda Crea un'istanza di HorizonDB Azure, una pagina di destinazione descrive le funzionalità del servizio:

  • Architettura cloud-native: un cluster PostgreSQL cloud-native ottimizzato per un throughput elevato.
  • Scalabilità elastica: ridimensionare le risorse di calcolo da 2 a 128 vCore.
  • Gestione predefinita: gestire il ciclo di vita e la configurazione da Visual Studio Code.
  • Sviluppo pronto: concentrarsi sull'applicazione mentre Azure gestisce l'infrastruttura.

Selezionare Inizia per continuare. Facoltativamente, selezionare Non visualizzare di nuovo questa pagina per ignorare questa pagina in futuro.

Passaggio 2: Accedere a Azure

L'estensione apre una pagina di accesso. Se si dispone già di un account Azure connesso a Visual Studio Code, l'estensione usa automaticamente tali credenziali. Se sono presenti più account o tenant Azure, usare il selettore di account e il selettore tenant per scegliere l'identità corretta.

Passaggio 3: Configurare le impostazioni del cluster

Dopo l'autenticazione, l'estensione visualizza un modulo di configurazione organizzato in sezioni.

Dettagli del progetto

Impostazione Descrizione
Subscription Selezionare la sottoscrizione Azure che gestisce la fatturazione e l'accesso.
Gruppo di risorse Selezionare un gruppo di risorse esistente o selezionare Crea nuovo per crearne uno.

Dettagli del cluster

Impostazione Descrizione
Nome del cluster Nome univoco globale per il cluster. L'estensione controlla la disponibilità e visualizza un messaggio di errore se il nome è già in uso.
Area geografica Area Azure in cui viene distribuito il cluster.
Versione di PostgreSQL Versione principale di PostgreSQL da distribuire.

Configurazione di calcolo

Usa il cursore vCores per scegliere la capacità di calcolo del cluster. Le opzioni disponibili vanno da 2 a 128 vCore. La memoria viene ridimensionata automaticamente a 8 GiB per vCore.

Authentication

Impostazione Descrizione
Nome utente amministratore Nome di accesso per l'account amministratore postgreSQL.
Password amministratore Password per l'account amministratore.
Confermare la password dell'amministratore Immettere nuovamente la password dell'amministratore.

Funzionalità di intelligenza artificiale

La sezione Funzionalità di intelligenza artificiale consente di abilitare le funzionalità di gestione dei modelli di intelligenza artificiale predefinite. Selezionare la casella di controllo Abilita funzionalità di intelligenza artificiale per acconsentire esplicitamente. Quando le funzionalità di intelligenza artificiale sono abilitate, il cluster viene sottoposto a provisioning con il supporto per la gestione dei modelli e le estensioni pgvector e pg_diskann.

Note

La sezione Funzionalità di intelligenza artificiale è un'esperienza di anteprima e potrebbe non essere visualizzata per ogni ambiente o configurazione del cluster. Se la sezione non è visibile, continuare con le impostazioni del cluster di Azure HorizonDB (anteprima) standard e i passaggi di distribuzione.

Passaggio 4: Accettare termini e distribuire

Nella parte inferiore del modulo:

  1. Selezionare la casella di controllo dei termini supplementari del cluster.
  2. Se sono state abilitate le funzionalità di intelligenza artificiale e la casella di controllo Condizioni supplementari di intelligenza artificiale è visibile, selezionarla.
  3. Esaminare le Condizioni per l'utilizzo e l'informativa sulla privacy collegate.
  4. Selezionare Crea per iniziare il provisioning. Se il modulo è incompleto, passare il puntatore del mouse sul pulsante Crea disabilitato per visualizzare i campi che richiedono ancora valori.

L'estensione passa a una pagina di stato che tiene traccia di ogni fase della distribuzione. Un riepilogo della distribuzione mostra il nome del cluster, la sottoscrizione, il gruppo di risorse e la configurazione (vCore e memoria) selezionati.

Al termine di tutte le fasi, l'estensione crea un profilo di connessione per il nuovo cluster. Selezionare Fine per chiudere la pagina di stato.

Note

Se sono state abilitate le funzionalità di intelligenza artificiale e il passaggio di gestione dei modelli di intelligenza artificiale ha esito negativo, il cluster viene comunque creato e viene aggiunto un profilo di connessione. La pagina di stato mostra un avviso e un collegamento per aprire il cluster nel portale di Azure in modo da poter abilitare manualmente la gestione dei modelli di intelligenza artificiale.

Tip

Selezionare Configura in portale di Azure nella parte inferiore del modulo se sono necessarie opzioni oltre a quanto fornito dalla procedura guidata dell'estensione.

Verificare il server

Dopo aver creato il server (Docker o Azure):

  1. Espandere il nodo del server nell'albero Connessioni .
  2. Verificare che siano elencati i database predefiniti (postgres e, per Docker, tutti i database specificati).
  3. Fare clic con il pulsante destro del mouse su un database e scegliere Nuova query per aprire l'editor di query.
  4. Eseguire una query di test, SELECT version(); ad esempio per verificare la connettività.

Contenuti correlati

  • Last updated on