NoSQL Writer

Esta guía te muestra cómo trabajar con Azure Cosmos DB localmente usando Docker y Python. Este lab demuestra cómo conectar una aplicación Python al emulador de Azure Cosmos DB.

Prerrequisitos

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

Cómo ejecutar

Configurar el entorno:
- Dev Container (recomendado)
- Manual
Abre VS Code en la carpeta del proyecto y ejecuta este comando en la Paleta de Comandos:
Ventana de terminal
> Dev Containers: Reopen in Container
1. Instala las dependencias:
  Ventana de terminal
  pip3 install uv && uv sync
2. Iniciar la infraestructura: Lanza el emulador de Cosmos DB:
  Ventana de terminal
  docker compose up -d cosmos
Ejecutar el ejemplo:
Ventana de terminal
```
python main.py
```

Abre el explorador de Cosmos DB en tu navegador:

http://localhost:1234/

Instala la extensión Azure Cosmos DB desde el marketplace de VS Code y conecta usando COSMOS_ENDPOINT y COSMOS_KEY definidos en tu .env.

Limpieza

docker compose down -v

Solución de problemas

Problema	Solución
Conexión rechazada	Asegúrate de que el emulador está en ejecución: `docker ps`
`PostgreSQL=FAIL` en los logs	Reinicia el estado del emulador: `docker compose down -v`
Período de evaluación expirado	Elimina la imagen antigua (`docker rmi mcr.microsoft.com/cosmosdb/linux/azure-cosmos-emulator`), descarga `latest` y reinicia.