Simple ETL

Esta guía te muestra cómo trabajar con GCP Cloud SQL y Firebase Cloud Functions localmente usando Docker Compose y Python. Este lab demuestra cómo procesar una subida de CSV mediante un trigger de Cloud Storage e insertar registros en PostgreSQL.

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
   1. Iniciar la infraestructura: Lanza el contenedor de PostgreSQL:

      docker compose up -d postgres

   2. Ejecuta el script de configuración para instalar herramientas y dependencias:

      scripts/setup-mve.sh

2. Iniciar los emuladores de Firebase:

   firebase emulators:start

3. Ejecutar el ejemplo:

   python main.py

Validar resultados

Firebase UI

Abre la UI del emulador de Firebase y verifica el archivo subido y los logs de la función:

http://localhost:4000/storage

http://localhost:4000/functions

SQLTools

Abre la extensión SQLTools en VS Code y usa la conexión Postgres preconfigurada para ejecutar:

SELECT * FROM users;

External Client

Conecta usando un cliente externo como DBeaver, configura los detalles de conexión definidos en tu .env y ejecuta:

SELECT * FROM users;

Limpieza

docker compose down -v

Siguientes pasos

• Consulta el proyecto equivalente en AWS.
• Profundiza en el Lab Cloud SQL.
• Profundiza en el Lab Firebase Cloud Functions.