Aller au contenu
KendorDocs

Comment construire un exercice à la maison avec une vraie base de données

Donnez aux candidats une vraie instance PostgreSQL, MySQL, MongoDB ou Valkey, alimentez-la avec un petit fichier SQL et écrivez des tests qui l'interrogent. Pas de mocks, pas d'installation locale.

Un exercice à la maison avec une base de données fonctionne mieux quand le candidat reçoit une vraie base de données déjà démarrée et alimentée, de sorte que le temps passe sur la tâche plutôt que sur la configuration. Gardez le schéma et les données de seed petits, écrivez quelques tests qui s'exécutent sur la vraie base, et assurez-vous que l'environnement démarre de la même façon pour chaque candidat.

Pourquoi une vraie base de données plutôt que des mocks ?

La plupart des bugs backend se trouvent à la frontière entre le code et les données : un index manquant, une requête qui renvoie des doublons après une jointure, une transaction qui n'en est pas une, un cache qui devient périmé. Un dépôt mocké cache tout cela. Avec une vraie base de données, le candidat doit affronter les mêmes problèmes que le poste lui apportera.

Une vraie base de données change aussi ce que vous pouvez demander :

  • Écrire une migration qui ajoute une colonne sans perdre de données.
  • Corriger une requête lente et montrer le plan d'exécution avant et après.
  • Rendre un endpoint sûr en cas de concurrence avec une transaction ou un verrou.
  • Ajouter un cache devant une lecture fréquente et l'invalider correctement.

Rien de tout cela n'a de sens face à un faux en mémoire.

La taxe d'installation est le vrai risque

L'objection classique, c'est l'installation. Demander aux candidats d'installer PostgreSQL, de créer un rôle et de charger un dump leur coûte une heure avant d'écrire une ligne, et cette heure avantage ceux qui ont le bon ordinateur portable. Quel que soit l'outil, la base de données doit être démarrée quand le candidat ouvre le projet.

Alimentez-la avec un jeu de données petit et délibéré

Les données de seed font partie de la conception de la tâche. Quelques règles :

  • Assez petites pour être lues. Dix clients et quarante commandes permettent à un candidat de comprendre les données avec un seul SELECT. Un million de lignes générées n'ont de sens que si la tâche porte sur la performance.
  • Adaptées à la tâche. Si le bug concerne les commandes sans articles, assurez-vous que le seed en contient une. Si la tâche est la pagination, mettez assez de lignes pour trois pages.
  • Le schéma d'abord, les données ensuite. Séparez-les en deux fichiers, 001_schema.sql et 002_seed.sql, pour que le candidat trouve vite les définitions de tables.
  • Aucune vraie donnée client. Utilisez des noms et des adresses inventés, même pour un recrutement interne.

Si votre projet a déjà des migrations (Prisma, Alembic, Django, Laravel), laissez l'étape d'installation les exécuter et gardez le fichier de seed pour les données uniquement.

Quelle taille donner à la tâche ?

Visez quelque chose que vous pouvez terminer en la moitié de la limite de temps. Les tâches de base de données prennent plus de temps qu'il n'y paraît, car le candidat doit d'abord explorer le schéma. Une modification ciblée, comme un endpoint, une migration ou une correction de requête, plus des tests, c'est largement suffisant pour 90 minutes.

Écrivez des tests qui interrogent la base de données

Les tests disent au candidat ce que signifie « terminé » et lui permettent de vérifier son propre travail. Pour une tâche de base de données, ils doivent s'exécuter sur la même base que celle qu'utilise l'application.

  • Lisez la connexion depuis l'environnement, comme DATABASE_URL, jamais une chaîne codée en dur.
  • Nettoyez après chaque test. Enveloppez chacun dans une transaction et annulez-la, ou supprimez les lignes qu'il a créées. La base conserve ses lignes pendant que le candidat travaille : les tests qui laissent des données derrière eux échoueront à la deuxième exécution.
  • Testez le comportement, pas le SQL. Vérifiez ce que renvoie l'endpoint ou ce qui se retrouve dans la table, pour que toute solution correcte passe.
test/orders.test.js
const { test } = require('node:test');
const assert = require('node:assert');
const { Client } = require('pg');

test('an order with no items has a zero total', async () => {
  const db = new Client({ connectionString: process.env.DATABASE_URL });
  await db.connect();
  await db.query('BEGIN');

  const { rows } = await db.query(
    "INSERT INTO orders (customer_id) VALUES (1) RETURNING id",
  );
  const total = await db.query('SELECT order_total($1) AS total', [rows[0].id]);
  assert.strictEqual(Number(total.rows[0].total), 0);

  await db.query('ROLLBACK');
  await db.end();
});

Astuce. Livrez un test qui passe et un test qui échoue et qui décrit la tâche. Le candidat voit tout de suite comment les tests s'exécutent et ce qu'il reste à faire.

Faut-il ajouter un cache ou une file d'attente ?

Seulement si la tâche porte dessus. Un magasin compatible Redis a du sens pour un limiteur de débit, un magasin de sessions ou un problème d'invalidation de cache. En ajouter un « pour le réalisme » ajoute simplement une deuxième chose à comprendre dans une fenêtre courte.

Le faire dans Kendor

Kendor exécute PostgreSQL, MySQL, MongoDB et Valkey (compatible Redis) dans le bac à sable du candidat, sur 127.0.0.1. Ils démarrent avant vos commandes d'installation : les migrations peuvent donc s'exécuter pendant l'installation. Vous les déclarez dans kendor.yaml à la racine du projet. Référence complète dans Bases de données.

kendor.yaml
version: 1
runtime:
  type: node
  version: "22"
databases:
  - type: postgres
    version: "18"
    init: db
  - type: valkey
    version: "9"
install:
  commands:
    - npm ci
services:
  api:
    dev:
      command: node --watch src/server.js
      port: 3000
    test:
      command: node --test
preview:
  service: api

Ce que fait chaque partie :

  • databases liste au plus une base de chaque type, et une seule base SQL (PostgreSQL ou MySQL). PostgreSQL 18, MySQL 8.4, MongoDB 8.0 et Valkey 9 sont disponibles.
  • init est un fichier de seed, ou un dossier dont les fichiers de seed s'exécutent dans l'ordre des noms : .sql pour PostgreSQL et MySQL, .js pour MongoDB. Il s'exécute une fois, juste après la création de la base ; sur PostgreSQL, en une seule transaction. Ce doit être un chemin à l'intérieur du projet. Valkey n'accepte pas init ; alimentez-le depuis votre application ou la configuration de vos tests.
  • name (facultatif, pas pour Valkey) définit le nom de la base. La valeur par défaut est app.

Chaque processus du bac à sable, y compris l'application, les terminaux et les tests, reçoit les informations de connexion : DATABASE_URL, PGHOST, PGPORT, PGUSER et PGDATABASE pour PostgreSQL, DATABASE_URL, MYSQL_HOST et compagnie pour MySQL, MONGODB_URI pour MongoDB, et REDIS_URL et VALKEY_URL pour Valkey. Les variables Laravel et Spring (DB_HOST, SPRING_DATASOURCE_URL, etc.) sont également définies. Les candidats peuvent ouvrir psql, mysql, mongosh ou redis-cli dans le terminal pour regarder à l'intérieur, et les bases de données ne sont pas joignables depuis l'extérieur du bac à sable.

La configurer depuis l'éditeur

Si vous préférez ne pas écrire de YAML, ouvrez le défi dans l'éditeur et utilisez Configuration d'exécution. Sous Bases de données, choisissez le moteur et la version, et pointez Fichier de seed vers votre SQL. Passez à YAML brut pour voir ce qui a été écrit. Quand vous importez un dépôt, Kendor détecte souvent la base de données pour vous, à partir d'un schéma Prisma, d'un docker-compose.yml ou des dépendances du projet, et la préremplit.

La vérifier comme un candidat

Choisissez Aperçu côté candidat et lancez les tests depuis l'onglet Tests. L'onglet Tests exécute la commande test de kendor.yaml ; une sortie TAP (node --test, pytest --tap-stream) donne une ligne par test. Voir L'onglet Tests.

Remarque. Les lignes de la base de données restent pendant que le candidat travaille, y compris lors d'un redémarrage du bac à sable. Elles ne sont toutefois pas enregistrées avec le rendu : ce que vous évaluez, c'est le code, y compris les migrations et les fichiers de seed que le candidat a modifiés.

Cet article vous a-t-il aidé ?