Metabase

Esta guía te muestra cómo trabajar con Metabase localmente usando Docker Compose, PostgreSQL y SQLAlchemy. Este lab demuestra cómo insertar datos en una base de datos PostgreSQL y explorarlos usando Metabase.

Prerrequisitos

• Docker instalado y en ejecución.
• Dev Containers extension instalada (opcional).

Cómo ejecutar

1. Configurar el entorno:

   Dev Container (recomendado)

   Abre VS Code en la carpeta del proyecto y ejecuta este comando en la Paleta de Comandos:

   > Dev Containers: Reopen in Container

   Manual

   pip3 install uv && uv sync

2. Iniciar la infraestructura: Lanza Metabase y PostgreSQL:

   docker compose up -d

3. Ejecutar el ejemplo:

   python main.py

Validar resultados

Metabase

1. Abre la UI de Metabase:

   http://localhost:3000

2. Completa la configuración inicial y crea una cuenta de administrador.
3. Conecta PostgreSQL usando las credenciales definidas en .env (METABASE_DB, METABASE_USER, METABASE_PASSWORD, POSTGRES_HOST, POSTGRES_PORT).
4. Explora la tabla products y crea visualizaciones.

DBeaver

Conecta usando DBeaver con los detalles de conexión definidos en .env y ejecuta:

SELECT * FROM products;

Limpieza

docker compose down -v

Solución de problemas

Problema	Solución
Puerto 3000 o 5432 en uso	Cambia el mapeo de puertos en docker-compose.yml y reinicia.
Metabase no carga	Espera a que se inicialice — revisa los logs: docker compose logs -f metabase (busca “Initialization COMPLETE”).
Conexión rechazada	Asegúrate de que ambos contenedores están en ejecución: docker ps
Módulo no encontrado	Reinstala las dependencias: pip3 install uv && uv sync

Siguientes pasos

• Explora el Lab relacionado PostgreSQL.
• Explora el Lab relacionado MongoDB.