Guida introduttiva: Connettersi ed eseguire query su PostgreSQL

In questa guida introduttiva si userà l'estensione PostgreSQL per Visual Studio Code per connettersi a un server PostgreSQL, creare una tabella, inserire righe ed eseguire una query, tutto dall'interno di VS Code.

Cosa imparerai

  • Aprire la finestra di dialogo di connessione e connettersi a un server PostgreSQL
  • Creare un database e una tabella con l'editor di query
  • Inserimento e interrogazione dei dati
  • Visualizzare i risultati nel pannello Risultati

Prerequisiti

Prima di iniziare, verificare di disporre di quanto segue:

Connetti a un server

  1. Aprire la visualizzazione PostgreSQL premendo CTRL+ALT+D (Windows/Linux) o CMD+ALT+D (macOS) oppure selezionare l'icona PostgreSQL nella barra delle attività.

  2. Passare il puntatore del mouse sull'intestazione della sezione Connessioni e selezionare Aggiungi nuova connessione ( + icona). Viene visualizzata la finestra di dialogo di connessione con la scheda Parametri selezionata.

    Screenshot della finestra di dialogo di connessione con la scheda Parametri visibile.

  3. Compilare i campi di connessione per il server PostgreSQL:

    Campo Valore di esempio Descrizione
    Nome server localhost Nome host o indirizzo IP del server.
    Tipo di autenticazione Password Scegliere Password, Entra Auth, AWS IAM (RDS/Aurora) o Nessuno.
    Nome utente postgres L'account di accesso di PostgreSQL.
    Password (la tua password) Password per l'account.
    Nome del database postgres Database a cui connettersi.
    Nome connessione Local dev server Nome visualizzato facoltativo per questa connessione.

    Tip

    Selezionare Salva password per archiviare la password in modo sicuro nell'archivio credenziali di VS Code, in modo che non vengano richieste tutte le connessioni. Per l'autenticazione di Microsoft Entra ID, l'autenticazione AWS IAM o altre configurazioni dell'identità, vedere Connessioni e identità.

  4. Selezionare Salva e connetti.

    Il server viene visualizzato nell'albero Connessioni con un indicatore di stato verde quando la connessione ha esito positivo.

Creazione di un database

  1. Fare clic con il pulsante destro del mouse sul nodo del server nell'albero Connessioni e scegliere Nuova query. Verrà aperto un editor di query connesso al server.

  2. Incollare l'istruzione seguente e premere CTRL+MAIUSC+E (Windows/Linux) o Cmd+MAIUSC+E (macOS) per eseguirla:

    CREATE DATABASE tutorialdb;

  3. Fare clic con il pulsante destro del mouse sul nodo del server nell'albero Connessioni e selezionare Aggiorna per visualizzare il nuovo database tutorialdb nell'albero.

Crea una tabella

  1. Modificare il contesto del database in tutorialdb. Usare l'elenco a discesa del database nella barra degli strumenti dell'editor di query oppure eseguire pgsql.changeDatabase dal riquadro comandi (Modifica database PostgreSQL) e selezionare tutorialdb.

  2. Incollare l'istruzione seguente nell'editor di query ed eseguirla con CTRL+MAIUSC+E / :

    CREATE TABLE customers (
    id SERIAL PRIMARY KEY,
    name VARCHAR(50) NOT NULL,
    email VARCHAR(50) NOT NULL,
    city VARCHAR(50)
);

    Il pannello Messaggi conferma che l'istruzione è stata completata correttamente.

Immettere dati

Sostituisci il contenuto dell'editor di query con l'istruzione seguente ed eseguila:

INSERT INTO customers (name, email, city)
VALUES
    ('Alice Johnson', 'alice@example.com', 'Seattle'),
    ('Bob Smith', 'bob@example.com', 'Portland'),
    ('Carol Williams', 'carol@example.com', 'San Francisco');

Il pannello Messaggi conferma che sono state inserite tre righe.

Eseguire una query sui dati

Sostituire il contenuto dell'editor di query con l'istruzione seguente ed eseguirla:

SELECT * FROM customers;

Nel pannello Risultati vengono visualizzate le tre righe inserite.

Verificare il risultato

Per verificare che i dati siano persistenti, eseguire una query filtrata:

SELECT name, city
FROM customers
WHERE city = 'Seattle';

Il pannello Risultati restituisce una riga per Alice Johnson a Seattle.

Risolvere problemi di connessione

Se non è possibile connettersi al server, verificare le cause comuni seguenti:

  • Connessione rifiutata: verificare che PostgreSQL sia in esecuzione e in ascolto sull'host e sulla porta previsti. Per i server locali, verificare che il servizio sia avviato.
  • Autenticazione della password non riuscita: controllare i valori Nome utente e Password . Esaminare il file del pg_hba.conf server per verificare che il metodo di autenticazione consenta la connessione.
  • Errori SSL: configurare le impostazioni SSL nelle opzioni di connessione avanzate. Per informazioni dettagliate, vedere Connessioni e identità: SSL e TLS.

Contenuti correlati

  • Last updated on