Inicio rápido: Conexión y consulta de PostgreSQL

En este inicio rápido, usará la extensión PostgreSQL para Visual Studio Code para conectarse a un servidor postgreSQL, crear una tabla, insertar filas y ejecutar una consulta, todo ello desde VS Code.

Qué aprenderá:

  • Abra el cuadro de diálogo de conexión y conéctese a un servidor postgreSQL.
  • Creación de una base de datos y una tabla con el editor de consultas
  • Insertar y consultar datos
  • Visualización de los resultados en el panel Resultados

Prerequisites

Antes de comenzar, asegúrese de que dispone de lo siguiente:

Conexión a un servidor

  1. Abra la vista PostgreSQL presionando Ctrl+Alt+D (Windows/Linux) o Cmd+Alt+D (macOS) o seleccione el icono de PostgreSQL en la barra de actividad.

  2. Mantenga el puntero sobre el encabezado de sección Conexiones y seleccione Agregar nueva conexión (el + icono). El cuadro de diálogo de conexión se abre con la pestaña Parámetros seleccionada.

    Captura de pantalla del cuadro de diálogo de conexión con la pestaña Parámetros visible.

  3. Rellene los campos de conexión del servidor postgreSQL:

    Campo Ejemplo de valor Descripción
    Nombre del servidor localhost Nombre de host o dirección IP del servidor.
    Tipo de autenticación Contraseña Elija Contraseña, Entra Auth, AWS IAM (RDS/Aurora) o Ninguno.
    Nombre de usuario postgres Su acceso a PostgreSQL.
    Contraseña (su contraseña) Contraseña de la cuenta.
    Nombre de la base de datos postgres La base de datos a la que hay que conectarse.
    Nombre de la conexión Local dev server Un nombre para mostrar opcional para esta conexión.

    Tip

    Seleccione Guardar contraseña para almacenar la contraseña de forma segura en el almacén de credenciales de VS Code, por lo que no se le pedirá cada conexión. Para obtener Microsoft Entra ID autenticación, autenticación de AWS IAM u otra configuración de identidad, consulte Conexiones e identidades.

  4. Seleccione Guardar y conectar.

    El servidor aparece en el árbol Conexiones con un indicador de estado verde cuando la conexión se realiza correctamente.

Creación de una base de datos

  1. Haga clic con el botón derecho en el nodo del servidor en el árbol Conexiones y seleccione Nueva consulta. Se abre un editor de consultas que está conectado al servidor.

  2. Pegue la instrucción siguiente y presione Ctrl+Mayús+E (Windows/Linux) o Cmd+Mayús+E (macOS) para ejecutarlo:

    CREATE DATABASE tutorialdb;

  3. Haga clic con el botón derecho en el nodo del servidor en el árbol Conexiones y seleccione Actualizar para ver la nueva base de datos tutorialdb en el árbol.

Creación de una tabla

  1. Cambie el contexto de la base de datos a tutorialdb. Use la lista desplegable de la base de datos en la barra de herramientas del editor de consultas o ejecute pgsql.changeDatabase desde la paleta de comandos (cambiar base de datos postgreSQL) y seleccione tutorialdb.

  2. Pegue la siguiente instrucción en el editor de consultas y ejecútelo con Ctrl+Mayús+E / Cmd+Mayús+E:

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

    El panel Mensajes confirma que la instrucción se completó correctamente.

Insertar datos

Reemplace el contenido del editor de consultas por la instrucción siguiente y ejecútelo:

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');

El panel Mensajes confirma que se insertaron tres filas.

Consultar los datos

Reemplace el contenido del editor de consultas por la instrucción siguiente y ejecútelo:

SELECT * FROM customers;

En el panel Resultados se muestran las tres filas insertadas.

Comprobar el resultado

Para confirmar que los datos se conservan, ejecute una consulta filtrada:

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

El panel Resultados devuelve una fila para Alice Johnson en Seattle.

Solución de problemas de conexión

Si no puede conectarse al servidor, compruebe las siguientes causas comunes:

  • Conexión rechazada: Compruebe que PostgreSQL está en ejecución y escuchando en el host y el puerto esperados. En el caso de los servidores locales, confirme que se ha iniciado el servicio.
  • Error de autenticación de contraseña: compruebe los valores Nombre de usuario y Contraseña . Revise el archivo del pg_hba.conf servidor para confirmar que el método de autenticación permite la conexión.
  • Errores ssl: configure las opciones de SSL en las opciones de conexión avanzadas. Para más información, consulte Conexiones e identidad: SSL y TLS.

Contenido relacionado

  • Last updated on