Aprender SQL leyendo es como aprender a nadar viendo vídeos: necesario, pero insuficiente. Para que este curso te sirva de verdad necesitas un entorno donde puedas escribir consultas, equivocarte, ver el mensaje de error y volver a intentarlo. Esta lección te lleva de la mano desde "no tengo nada instalado" hasta "tengo PostgreSQL 16 funcionando, sé conectarme y he creado la base de datos tiendaverde". Cubriremos la instalación en Linux, macOS y Windows, la alternativa con Docker (la que recomendamos), una salida de emergencia con SQLite si no puedes instalar nada en tu equipo, los comandos esenciales del cliente psql y los clientes gráficos más usados.

1. Qué necesitas exactamente
2. Opción A (recomendada): PostgreSQL con Docker
3. Opción B: instalación nativa en Linux, macOS y Windows
4. Opción C (mínima): SQLite
5. Conectarse con psql y sus comandos básicos
6. Clientes gráficos: pgAdmin, DBeaver y VS Code
7. Crear la base de datos tiendaverde y un usuario propio
8. Verificar que todo funciona
9. Errores Comunes y Consejos
10. Ejercicios
11. Conclusión

Para seguir el curso necesitas tres piezas:

Y necesitas decidir cómo vas a instalar el servidor. Estas son las tres vías, ordenadas por lo que recomendamos:

Docker te permite levantar PostgreSQL 16 en un contenedor aislado, con la misma versión exacta que usa el curso, sin tocar el resto de tu sistema.

Vale la pena entender cada opción, porque las volverás a ver:

En los registros debes ver una línea similar a database system is ready to accept connections.

Nota: si el puerto 5432 ya está ocupado por otra instalación de PostgreSQL, cambia la publicación a -p 5433:5432 y usa -p 5433 al conectarte.

Detalles que suelen dar problemas:

• Linux/Debian: tras instalar, el acceso local se hace por peer authentication. La forma correcta de entrar la primera vez es sudo -u postgres psql, no psql a secas.
• macOS con Homebrew: si psql no se encuentra, añade la ruta al PATH:

  echo 'export PATH="/opt/homebrew/opt/postgresql@16/bin:$PATH"' >> ~/.zshrc
  source ~/.zshrc
  

• Windows: el instalador no siempre añade psql al PATH. Si al abrir PowerShell te dice que no reconoce el comando, añade a mano C:\Program Files\PostgreSQL\16\bin a la variable de entorno Path, o usa el acceso directo "SQL Shell (psql)" del menú Inicio.

Si trabajas en un equipo donde no puedes instalar servicios, SQLite te permitirá seguir buena parte del curso. Una base de datos SQLite es un único fichero y no hay servidor que arrancar.

Crear una base de datos y entrar en ella es lo mismo:

Sus comandos de cliente empiezan por punto en lugar de barra invertida:

Limitaciones honestas de SQLite para este curso: no tiene usuarios ni permisos (módulo 11), sus tipos son dinámicos y muy permisivos (módulo 1 y 5), no soporta RIGHT/FULL OUTER JOIN en versiones anteriores a la 3.39, su EXPLAIN es distinto (módulo 8) y no tiene procedimientos almacenados ni triggers equivalentes (módulo 10). Úsalo como último recurso; si en algún momento puedes pasarte a PostgreSQL, hazlo.

psql es el cliente oficial de línea de comandos. Es la herramienta que usaremos en las explicaciones porque es rápida, está siempre disponible y muestra los errores tal cual los produce el servidor.

Las opciones se repiten en casi todas las herramientas PostgreSQL:

Cuando estás dentro, el símbolo del sistema te informa del estado:

Ese tercer símbolo (-#) es el que más desconcierta al principio: significa que psql está esperando a que cierres la sentencia con ;.

Los comandos que empiezan por \ no son SQL: los interpreta el propio cliente, y por eso no llevan punto y coma.

Ejemplo de sesión típica:

Un cliente gráfico no sustituye a psql, pero acelera muchísimo la exploración de un esquema desconocido.

Datos de conexión que te pedirá cualquiera de ellos (con la configuración de Docker de la sección 2):

Vamos a preparar el espacio de trabajo del curso. Conéctate primero como superusuario:

Y ejecuta:

Qué hace cada parte:

• CREATE USER crea un rol con capacidad de iniciar sesión. Trabajar como superusuario a diario es una mala costumbre: un DROP accidental no tendría ninguna barrera.
• OWNER curso_sql hace que ese usuario sea el dueño de la base de datos y pueda crear tablas dentro sin permisos adicionales.
• ENCODING 'UTF8' garantiza que las tildes y la ñ de nuestros datos se guarden correctamente.
• LC_COLLATE define el orden alfabético del idioma: con la configuración española, ORDER BY colocará "álamo" antes de "bosque", como esperarías.

Si te da error el LC_COLLATE: en la imagen Docker de PostgreSQL puede que el locale español no esté generado. En ese caso, crea la base sin esas dos cláusulas:

CREATE DATABASE tiendaverde OWNER curso_sql ENCODING 'UTF8';

No afecta a nada del curso salvo a pequeños matices de ordenación alfabética.

Ahora conéctate a la base nueva con tu usuario:

Y concede permisos sobre el esquema public (necesario desde PostgreSQL 15, que endureció los permisos por defecto). Esto se ejecuta como superusuario:

La comprobación canónica es pedirle al servidor su versión:

Resultado esperado (el texto exacto variará según tu sistema):

Un par de verificaciones más, útiles para confirmar que estás donde crees estar:

Y una prueba rápida de que puedes crear objetos en la base:

Si las cuatro sentencias se ejecutan sin error, tu entorno está listo. Con DROP TABLE prueba; dejas la base limpia para el script real, que cargarás en la lección 01-06.

• psql: error: connection to server ... failed: Connection refused. El servidor no está arrancado o el puerto es otro. Con Docker, comprueba docker ps; con instalación nativa, sudo systemctl status postgresql.
• FATAL: password authentication failed for user "postgres". Contraseña incorrecta, o estás usando la de otro entorno. En Docker, la contraseña es la que pasaste en POSTGRES_PASSWORD la primera vez que se creó el volumen: cambiarla en un docker run posterior no tiene efecto si el volumen ya existe.
• FATAL: role "tu_usuario" does not exist. En Linux, psql intenta conectarse con tu usuario del sistema. Usa -U postgres explícitamente o entra con sudo -u postgres psql.
• FATAL: database "tiendaverde" does not exist. Todavía no la has creado, o la creaste en otro servidor distinto del que estás consultando.
• Olvidar el punto y coma. Si el símbolo del sistema pasa de =# a -#, psql está esperando el ;. Escríbelo y pulsa Intro.
• Perder los datos al recrear el contenedor. Sin -v no hay volumen, y borrar el contenedor borra la base entera. Es el error más doloroso de Docker.
• Consejo: guarda tus consultas en ficheros .sql. Crea una carpeta curso-sql/ con un fichero por módulo. Podrás ejecutarlos con \i y llevarás un registro de tu progreso.
• Consejo: activa \timing desde el primer día. Te acostumbrarás a mirar cuánto tarda cada consulta, algo que te será natural cuando llegues al módulo 8.
• Consejo: usa \x con tablas anchas. Cuando una fila no cabe en pantalla y el resultado es ilegible, \x lo convierte en una lista vertical de campos.

Levanta PostgreSQL 16 con Docker en el puerto 5433 en lugar del 5432 (útil si ya tienes otro PostgreSQL en tu máquina), con el nombre de contenedor pg-tiendaverde y un volumen llamado tv-data. Después, conéctate con psql y comprueba la versión del servidor.

Desde psql, y sin salir del cliente, responde a estas tres preguntas usando metacomandos (no SQL):

1. ¿Qué bases de datos existen en tu servidor?
2. ¿Qué usuarios/roles hay definidos?
3. ¿Cuál es la sintaxis completa de la sentencia CREATE DATABASE?

Crea una base de datos llamada pruebas_sql propiedad del usuario curso_sql, conéctate a ella, crea una tabla notas(id, texto), inserta dos filas, consúltalas y finalmente elimina la base de datos entera.

Solución 1

El detalle clave es -p 5433:5432: el número de la izquierda es el puerto de tu máquina y el de la derecha el del contenedor (que siempre es 5432, porque dentro del contenedor PostgreSQL escucha ahí). Para conectarte:

Solución 2

\l (de list) muestra bases de datos con su propietario y codificación; \du (display users) muestra roles y sus atributos; \h da la ayuda de sintaxis SQL, mientras que \? da la de los metacomandos. Recuerda: ninguno lleva punto y coma, porque no son SQL.

Solución 3

Para borrar la base de datos no puedes estar conectado a ella, así que primero vuelve a postgres:

Si intentas el DROP estando dentro, PostgreSQL responde ERROR: cannot drop the currently open database. Es un error muy frecuente y la solución siempre es la misma: cambiar de base de datos antes.

Ya tienes un entorno de trabajo real:

• Sabes las tres vías para tener PostgreSQL 16: Docker (reproducible y recomendada), instalación nativa por sistema operativo y SQLite como último recurso.
• Conoces el cliente psql, sus opciones de conexión (-h, -p, -U, -d, -f, -c) y sus metacomandos clave (\l, \c, \dt, \d, \x, \timing, \?, \q).
• Puedes elegir un cliente gráfico con criterio: DBeaver como opción general, pgAdmin para administrar, VS Code si ya trabajas ahí.
• Has creado la base de datos tiendaverde y el usuario curso_sql, y has verificado la instalación con SELECT version();.

En la siguiente lección, Sintaxis básica de SQL, dejaremos de instalar y empezaremos a escribir: verás cómo está construida una sentencia SQL por dentro (palabras clave, identificadores, literales, operadores), qué papel juega el punto y coma, cómo trata PostgreSQL las mayúsculas, cómo comentar tu código, qué convenciones de formato usan los profesionales y —muy importante— cómo leer un mensaje de error para saber exactamente dónde te has equivocado.