Cómo añadir una base de datos PostgreSQL, MySQL, MongoDB o Redis a un reto de código
Indica PostgreSQL 18, MySQL 8.4, MongoDB 8.0 o Valkey 9 en databases dentro de kendor.yaml. Se ejecutan dentro del sandbox y el código se conecta con DATABASE_URL, MONGODB_URI o REDIS_URL.
Para dar una base de datos a un reto, inclúyela en databases dentro de kendor.yaml. Kendor
ejecuta PostgreSQL 18, MySQL 8.4, MongoDB 8.0 y Valkey 9 (compatible con Redis) dentro del sandbox
del candidato, en 127.0.0.1, los inicia antes de cualquier comando de instalación y define
variables de conexión como DATABASE_URL, MONGODB_URI y REDIS_URL para todos los procesos, de
modo que el código se conecta sin que el candidato tenga que configurar nada.
Declara una base de datos
version: 1
runtime:
type: node
version: "22"
databases:
- type: postgres
version: "18"
init: db/seed.sql
- type: valkey
version: "9"
services:
app:
install:
commands:
- npm ci
dev:
command: node --watch src/server.js
port: 3000
test:
command: node --test| Clave | Obligatoria | Descripción |
|---|---|---|
type |
Sí | postgres, mysql, mongodb o valkey. Cada una como máximo una vez, y solo una de postgres y mysql, ya que ambas definen DATABASE_URL. |
version |
Sí | "18" para PostgreSQL, "8.4" para MySQL, "8.0" para MongoDB, "9" para Valkey, como cadena entre comillas. |
name |
No | PostgreSQL, MySQL y MongoDB. La base de datos que se crea. Por defecto app. Letras minúsculas, dígitos, guiones bajos y guiones, empezando por una letra o un guion bajo, y distinta de los nombres que reserva el motor (postgres, template0, template1, admin, local, config, mysql, information_schema, performance_schema, sys). |
user |
No | PostgreSQL, MySQL y MongoDB. El usuario con el que se conecta la aplicación. Por defecto kendor. |
password |
No | PostgreSQL, MySQL y MongoDB. La contraseña de ese usuario. Por defecto ninguna, salvo en MongoDB, donde es kendor. |
init |
No | PostgreSQL, MySQL y MongoDB. Un archivo de seed, o una carpeta con ellos, relativa a la raíz del workspace: .sql para PostgreSQL y MySQL, .js para MongoDB. |
También puedes añadir bases de datos en el cuadro de Configuración de runtime, en Bases de datos, con un Archivo de seed opcional. El proyecto Express + PostgreSQL + Valkey de Node.js es un ejemplo completo y funcional.
Datos iniciales con init
init se ejecuta una sola vez, justo después de crear la base de datos, con el usuario propio de la aplicación:
- Un archivo se ejecuta por sí solo. Una carpeta ejecuta todos los archivos de seed que contiene por
orden de nombre, así que pon números como prefijo:
01_schema.sql,02_data.sql. - PostgreSQL lo ejecuta todo en una sola transacción. Si falla alguna sentencia, no se aplica nada.
- MySQL ejecuta cada archivo
.sqlpor turnos y se detiene en el primer error. MySQL no puede deshacer cambios de esquema, así que un seed fallido puede dejar algunas tablas creadas. - MongoDB ejecuta los archivos
.jsconmongosh, conectado a la base de datos de la aplicación. No hay ninguna transacción alrededor, así que un seed fallido puede dejar algunas escrituras hechas. - Si el seed falla mientras el sandbox está en marcha, la base de datos sigue funcionando y el error aparece en su proceso. Corrige el archivo y reinicia el proceso Base de datos desde la vista Procesos para ejecutarlo de nuevo.
Las migraciones que ejecuta tu framework (prisma migrate deploy, php artisan migrate) van en
los comandos migrate del servicio. Se ejecutan cada vez que el servicio arranca, después de su
instalación y antes de su comando dev, así que los archivos de migración nuevos se aplican al
reiniciar. Cuando importas un repositorio, Kendor los rellena a partir de la herramienta de
migraciones que ya usa.
Datos de conexión
Todos los servidores escuchan solo en 127.0.0.1. PostgreSQL y MySQL se conectan con el usuario
kendor sin contraseña. MongoDB no admite inicio de sesión sin contraseña, así que su usuario
kendor tiene la contraseña kendor. El usuario de la aplicación puede gestionar su propia base de
datos pero no es superusuario.
PostgreSQL
| Variable | Valor |
|---|---|
DATABASE_URL |
postgresql://kendor@127.0.0.1:5432/app (con tu name en lugar de app) |
PGHOST, PGPORT, PGUSER, PGDATABASE |
127.0.0.1, 5432, kendor, el nombre de la base de datos |
DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME, DB_PASSWORD |
Los mismos valores, para Laravel. DB_PASSWORD está vacía. |
SPRING_DATASOURCE_URL, SPRING_DATASOURCE_USERNAME, SPRING_DATASOURCE_PASSWORD |
jdbc:postgresql://127.0.0.1:5432/app, kendor y vacía, para Spring Boot. |
Cuando defines una password, también se define PGPASSWORD.
Como son variables de entorno reales, tienen prioridad sobre un archivo .env de Laravel o un
application.properties de Spring.
MySQL
| Variable | Valor |
|---|---|
DATABASE_URL |
mysql://kendor@127.0.0.1:3306/app (con tu name en lugar de app) |
MYSQL_HOST, MYSQL_PORT, MYSQL_USER, MYSQL_PASSWORD, MYSQL_DATABASE |
127.0.0.1, 3306, kendor, vacía, el nombre de la base de datos |
DB_CONNECTION, DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME, DB_PASSWORD |
mysql y los mismos valores, para Laravel. |
SPRING_DATASOURCE_URL, SPRING_DATASOURCE_USERNAME, SPRING_DATASOURCE_PASSWORD |
jdbc:mysql://127.0.0.1:3306/app, kendor y vacía, para Spring Boot. |
Cuando defines una password, también se define MYSQL_PWD. El servidor también acepta inicios de
sesión con mysql_native_password, para drivers antiguos que no pueden usar el método por defecto
más reciente de MySQL.
MongoDB
| Variable | Valor |
|---|---|
MONGODB_URI, MONGODB_URL, MONGO_URI, MONGO_URL |
mongodb://kendor:kendor@127.0.0.1:27017/app?directConnection=true (con tu name en lugar de app) |
SPRING_DATA_MONGODB_URI |
Lo mismo, para Spring Boot. |
DATABASE_URL |
Lo mismo, para Prisma. No se define cuando también se declara PostgreSQL o MySQL; la base de datos SQL se queda con ella. |
MongoDB se ejecuta como un replica set de un solo nodo, así que las transacciones y los change
streams funcionan. El usuario existe en la base de datos de la aplicación y en admin, así que una
URL con authSource=admin también funciona.
Valkey
| Variable | Valor |
|---|---|
REDIS_URL, VALKEY_URL |
redis://127.0.0.1:6379 |
REDIS_HOST, REDIS_PORT |
127.0.0.1, 6379 |
SPRING_DATA_REDIS_HOST, SPRING_DATA_REDIS_PORT |
Lo mismo, para Spring Boot. |
Valkey habla el protocolo de Redis, así que sirve cualquier cliente de Redis.
Si tu código lee otro nombre de variable, asígnalo en dev.env.vars del servicio con
databases.<type>.url, como databases.postgres.url o databases.mongodb.url:
version: 1
runtime:
type: python
version: "3.12"
databases:
- type: postgres
version: "18"
name: inventory
services:
app:
install:
commands:
- pip install --user -r requirements.txt
dev:
command: uvicorn main:app --host $HOST --port $PORT --reload
port: 8000
env:
vars:
SQLALCHEMY_DATABASE_URI: databases.postgres.urlLos candidatos ven los mismos datos en el editor: la vista Procesos tiene una sección Bases de datos con cada URL de conexión, todas las variables definidas para ella y un comando para abrir un cliente en la terminal:
| Base de datos | Comando en la terminal |
|---|---|
| PostgreSQL | psql |
| MySQL | mysql -h 127.0.0.1 -u $MYSQL_USER $MYSQL_DATABASE |
| MongoDB | mongosh $MONGODB_URI |
| Valkey | redis-cli |
Conéctate desde el código
Lee la URL del entorno. Añade la librería cliente a las dependencias de tu proyecto (pg y redis
para Node.js, psycopg y redis para Python) para que el comando de instalación la descargue.
import pg from 'pg';
import { createClient } from 'redis';
export const pool = new pg.Pool({ connectionString: process.env.DATABASE_URL });
export const cache = createClient({ url: process.env.REDIS_URL });
await cache.connect();
const { rows } = await pool.query('SELECT id, title FROM todos ORDER BY id');
await cache.set('todos', JSON.stringify(rows));import json
import os
import psycopg
import redis
conn = psycopg.connect(os.environ["DATABASE_URL"])
cache = redis.Redis.from_url(os.environ["REDIS_URL"])
with conn.cursor() as cur:
cur.execute("SELECT id, title FROM todos ORDER BY id")
rows = cur.fetchall()
cache.set("todos", json.dumps(rows))Qué pasa con los datos
Durante una sesión, los datos persisten. Las filas se guardan en la carpeta de caché del propio
sandbox, así que sobreviven a un reinicio del proceso de la base de datos o de todo el sandbox, y el
seed de init no se vuelve a ejecutar.
La pestaña Tests se ejecuta contra esa misma base de datos activa. Escribe tests que creen las filas que necesitan y limpien después, o envuelve cada test en una transacción, para que los experimentos de un candidato en la terminal no puedan cambiar el resultado.
Límites
| Límite | |
|---|---|
| Conexiones de PostgreSQL | 20 |
| Archivos temporales de PostgreSQL | 1 GB por conexión |
| Conexiones de MySQL | 20 |
| Caché de MongoDB | 256 MB |
| Memoria de Valkey | 64 MB |
| Datos en disco | 1 GB; al superarlo, los servidores de bases de datos se detienen y el proceso Base de datos explica cómo empezar de nuevo con una base de datos vacía |
Los puertos de las bases de datos, 5432, 3306, 27017 y 6379, nunca se exponen a través de la vista previa, aunque un servidor escuche en ellos.
MySQL no puede leer ni escribir archivos en el disco del sandbox (LOAD DATA INFILE,
SELECT ... INTO OUTFILE), y MongoDB tiene desactivado el JavaScript del lado del servidor ($where,
$function, mapReduce).