Comment ajouter une base de données PostgreSQL, MySQL, MongoDB ou Redis à un exercice de code
Déclarez PostgreSQL 18, MySQL 8.4, MongoDB 8.0 ou Valkey 9 sous databases dans kendor.yaml. Elles s’exécutent dans le bac à sable, et le code s’y connecte avec DATABASE_URL, MONGODB_URI ou REDIS_URL.
Pour donner une base de données à un exercice, déclarez-la sous databases dans kendor.yaml.
Kendor exécute PostgreSQL 18, MySQL 8.4, MongoDB 8.0 et Valkey 9 (compatible Redis) dans le bac à
sable du candidat, sur 127.0.0.1, les démarre avant toute commande d’installation et définit des
variables de connexion comme DATABASE_URL, MONGODB_URI et REDIS_URL pour chaque processus : le
code se connecte donc sans aucune configuration de la part du candidat.
Déclarer une base de données
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| Clé | Obligatoire | Description |
|---|---|---|
type |
Oui | postgres, mysql, mongodb ou valkey. Chacun au plus une fois, et un seul parmi postgres et mysql, puisque les deux définissent DATABASE_URL. |
version |
Oui | "18" pour PostgreSQL, "8.4" pour MySQL, "8.0" pour MongoDB, "9" pour Valkey, sous forme de chaîne entre guillemets. |
name |
Non | PostgreSQL, MySQL et MongoDB. La base à créer. app par défaut. Lettres minuscules, chiffres, tirets bas et traits d’union, en commençant par une lettre ou un tiret bas, et pas un nom réservé par le moteur (postgres, template0, template1, admin, local, config, mysql, information_schema, performance_schema, sys). |
user |
Non | PostgreSQL, MySQL et MongoDB. L’utilisateur avec lequel l’application se connecte. kendor par défaut. |
password |
Non | PostgreSQL, MySQL et MongoDB. Le mot de passe de cet utilisateur. Aucun par défaut, sauf pour MongoDB, où c’est kendor. |
init |
Non | PostgreSQL, MySQL et MongoDB. Un fichier de seed, ou un dossier de fichiers de seed, relatif à la racine de l’espace de travail : .sql pour PostgreSQL et MySQL, .js pour MongoDB. |
Vous pouvez aussi ajouter des bases de données dans la boîte de dialogue Configuration d’exécution, sous Bases de données, avec un Fichier de seed facultatif. Le projet Express + PostgreSQL + Valkey pour Node.js est un exemple complet et fonctionnel.
Charger des données avec init
init s’exécute une seule fois, juste après la création de la base, avec l’utilisateur propre à l’application :
- Un fichier s’exécute seul. Un dossier exécute tous les fichiers de seed qu’il contient, dans
l’ordre alphabétique des noms ; préfixez donc les fichiers par des numéros :
01_schema.sql,02_data.sql. - PostgreSQL exécute tout dans une seule transaction. Si une instruction échoue, rien n’est appliqué.
- MySQL exécute chaque fichier
.sqltour à tour et s’arrête à la première erreur. MySQL ne peut pas annuler les modifications de schéma : un seed qui échoue peut donc laisser certaines tables. - MongoDB exécute les fichiers
.jsavecmongosh, connecté à la base de l’application. Aucune transaction ne les entoure : un seed qui échoue peut donc laisser certaines écritures. - Si le seed échoue pendant que le bac à sable tourne, la base de données continue de fonctionner et l’erreur s’affiche dans son processus. Corrigez le fichier, puis redémarrez le processus Base de données depuis la vue Processus pour le relancer.
Les migrations lancées par votre framework (prisma migrate deploy, php artisan migrate) vont
plutôt dans les commandes migrate du service. Elles s’exécutent à chaque démarrage du service,
après son installation et avant sa commande dev : les nouveaux fichiers de migration sont donc
appliqués lors d’un redémarrage. Quand vous importez un dépôt, Kendor les renseigne à partir de
l’outil de migration qu’il utilise déjà.
Détails de connexion
Chaque serveur écoute uniquement sur 127.0.0.1. PostgreSQL et MySQL se connectent avec
l’utilisateur kendor, sans mot de passe. MongoDB n’a pas de connexion sans mot de passe : son
utilisateur kendor a donc le mot de passe kendor. L’utilisateur de l’application peut gérer sa
propre base mais n’est pas superutilisateur.
PostgreSQL
| Variable | Valeur |
|---|---|
DATABASE_URL |
postgresql://kendor@127.0.0.1:5432/app (avec votre name à la place de app) |
PGHOST, PGPORT, PGUSER, PGDATABASE |
127.0.0.1, 5432, kendor, le nom de la base |
DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME, DB_PASSWORD |
Les mêmes valeurs, pour Laravel. DB_PASSWORD est vide. |
SPRING_DATASOURCE_URL, SPRING_DATASOURCE_USERNAME, SPRING_DATASOURCE_PASSWORD |
jdbc:postgresql://127.0.0.1:5432/app, kendor et vide, pour Spring Boot. |
Quand vous définissez un password, PGPASSWORD est aussi défini.
Comme ce sont de véritables variables d’environnement, elles l’emportent sur un fichier .env
Laravel ou un application.properties Spring.
MySQL
| Variable | Valeur |
|---|---|
DATABASE_URL |
mysql://kendor@127.0.0.1:3306/app (avec votre name à la place de app) |
MYSQL_HOST, MYSQL_PORT, MYSQL_USER, MYSQL_PASSWORD, MYSQL_DATABASE |
127.0.0.1, 3306, kendor, vide, le nom de la base |
DB_CONNECTION, DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME, DB_PASSWORD |
mysql et les mêmes valeurs, pour Laravel. |
SPRING_DATASOURCE_URL, SPRING_DATASOURCE_USERNAME, SPRING_DATASOURCE_PASSWORD |
jdbc:mysql://127.0.0.1:3306/app, kendor et vide, pour Spring Boot. |
Quand vous définissez un password, MYSQL_PWD est aussi défini. Le serveur accepte également les
connexions mysql_native_password, pour les anciens pilotes qui ne gèrent pas la méthode par défaut
plus récente de MySQL.
MongoDB
| Variable | Valeur |
|---|---|
MONGODB_URI, MONGODB_URL, MONGO_URI, MONGO_URL |
mongodb://kendor:kendor@127.0.0.1:27017/app?directConnection=true (avec votre name à la place de app) |
SPRING_DATA_MONGODB_URI |
La même, pour Spring Boot. |
DATABASE_URL |
La même, pour Prisma. Non définie quand PostgreSQL ou MySQL est aussi déclaré ; la base SQL la conserve. |
MongoDB s’exécute en replica set à un seul nœud : les transactions et les change streams
fonctionnent. L’utilisateur existe dans la base de l’application et dans admin : une URL avec
authSource=admin fonctionne donc aussi.
Valkey
| Variable | Valeur |
|---|---|
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 |
Les mêmes, pour Spring Boot. |
Valkey parle le protocole Redis : n’importe quel client Redis fonctionne.
Si votre code lit une variable portant un autre nom, associez-la dans dev.env.vars du service avec
databases.<type>.url, par exemple databases.postgres.url ou 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.urlLes candidats voient les mêmes informations dans l’éditeur : la vue Processus contient une section Bases de données avec chaque URL de connexion, toutes les variables définies pour elle et une commande pour ouvrir un client dans le terminal :
| Base de données | Commande dans le terminal |
|---|---|
| PostgreSQL | psql |
| MySQL | mysql -h 127.0.0.1 -u $MYSQL_USER $MYSQL_DATABASE |
| MongoDB | mongosh $MONGODB_URI |
| Valkey | redis-cli |
Se connecter depuis le code
Lisez l’URL depuis l’environnement. Ajoutez la bibliothèque cliente aux dépendances de votre projet
(pg et redis pour Node.js, psycopg et redis pour Python) afin que la commande d’installation
la récupère.
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))Ce qu’il advient des données
Pendant une session, les données persistent. Les lignes sont stockées dans le dossier de cache
propre au bac à sable : elles survivent au redémarrage du processus de base de données ou de tout le
bac à sable, et le seed init ne s’exécute pas une seconde fois.
L’onglet Tests s’exécute sur cette même base de données active. Écrivez des tests qui créent les lignes dont ils ont besoin et nettoient après eux, ou enveloppez chaque test dans une transaction, afin que les essais d’un candidat dans le terminal ne puissent pas modifier le résultat.
Limites
| Limite | |
|---|---|
| Connexions PostgreSQL | 20 |
| Fichiers temporaires PostgreSQL | 1 Go par connexion |
| Connexions MySQL | 20 |
| Cache MongoDB | 256 Mo |
| Mémoire Valkey | 64 Mo |
| Données sur disque | 1 Go ; au-delà, les serveurs de bases de données s’arrêtent, et le processus Base de données indique comment repartir d’une base vide |
Les ports des bases de données, 5432, 3306, 27017 et 6379, ne sont jamais exposés via l’aperçu, même si un serveur y écoute.
MySQL ne peut ni lire ni écrire de fichiers sur le disque du bac à sable (LOAD DATA INFILE,
SELECT ... INTO OUTFILE), et MongoDB a le JavaScript côté serveur désactivé ($where,
$function, mapReduce).