Saltar al contenido
KendorDocs

Cómo añadir una base de datos PostgreSQL, MySQL, MongoDB o Redis a un reto de código

Para autores de retos ·

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

kendor.yaml
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 .sql por 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 .js con mongosh, 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:

kendor.yaml
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.url

Los 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.

src/db.js
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));

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).

¿Te ha resultado útil este artículo?