Estudio de PostgreSQL

PostgreSQL es un sistema de bases de datos relacional (RDBMS) open source, ACID y con JSONB. Se usa con el cliente psql o desde Python con psycopg. A continuación los casos de uso con sus scripts minimalistas.

Resumen con para qué y cómo, listo para pegar en tu OKF/Obsidian (el agente lo implementa sin gastar tokens).

1 · psql + SQL básico

Conectar, crear una tabla e insertar/consultar.

🐘 Script minimalista

# Conectar por terminal
psql -h localhost -U usuario -d mi_base

# SQL: crear tabla + insertar + consultar
CREATE TABLE usuarios (
  id SERIAL PRIMARY KEY,
  nombre TEXT NOT NULL,
  email TEXT UNIQUE
);

INSERT INTO usuarios (nombre, email) VALUES ('Ana', 'ana@correo.com');
SELECT * FROM usuarios;

🔁 Cómo funciona

psql abre un cliente interactivo contra el servidor.
CREATE TABLE define el esquema; SERIAL autoincrementa el id.
INSERT / SELECT escriben y leen filas.

💡 \d tabla describe la tabla; CREATE INDEX acelera las búsquedas.

2 · PostgreSQL desde Python (psycopg)

La conexión más corta para ejecutar SQL desde tu código.

🐍 Script minimalista

# pip install psycopg[binary]
import psycopg

with psycopg.connect("dbname=mi_base user=usuario host=localhost") as conn:
    with conn.cursor() as cur:
        cur.execute("SELECT * FROM usuarios")
        for row in cur.fetchall():
            print(row)

🔑 Conceptos clave

Concepto	Qué es
`psycopg.connect(dsn)`	Conexión (gestor de contexto = commit/close automático)
`conn.cursor()`	Ejecuta SQL y obtiene resultados
`cur.fetchall()`	Devuelve las filas

3 · Grafo animado — el flujo de una consulta

El token 🟠 recorre el flujo. Clic en el gráfico reinicia la animación.

Iniciando…

4 · Referencia y regla de librerías

Función / comando	Qué hace
`psql -h host -U user -d db`	Conectar por terminal
`CREATE TABLE / INSERT / SELECT`	DDL + DML básico
`SERIAL · TEXT · INTEGER · JSONB`	Tipos y autoincremento
`CREATE INDEX` · `pg_dump`	Rendimiento y respaldo

📦 Regla de librerías (local primero): revisar C:\Users\TUF\Documents\librerías\local\. Instalación: pip install psycopg[binary]. Docs: https://www.postgresql.org/docs/.