Zum Inhalt springen
KendorDocs

So fügst du einer Coding-Aufgabe eine PostgreSQL-, MySQL-, MongoDB- oder Redis-Datenbank hinzu

Für Aufgabenautoren ·

Trage PostgreSQL 18, MySQL 8.4, MongoDB 8.0 oder Valkey 9 unter databases in kendor.yaml ein. Sie laufen in der Sandbox, und der Code verbindet sich über DATABASE_URL, MONGODB_URI oder REDIS_URL.

Um einer Aufgabe eine Datenbank zu geben, trägst du sie unter databases in kendor.yaml ein. Kendor betreibt PostgreSQL 18, MySQL 8.4, MongoDB 8.0 und Valkey 9 (Redis-kompatibel) in der Sandbox des Kandidaten auf 127.0.0.1, startet sie vor jedem Install-Befehl und setzt Verbindungsvariablen wie DATABASE_URL, MONGODB_URI und REDIS_URL für jeden Prozess. Der Code verbindet sich also ohne jede Einrichtung durch den Kandidaten.

Eine Datenbank deklarieren

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
Schlüssel Pflicht Beschreibung
type Ja postgres, mysql, mongodb oder valkey. Jeweils höchstens einmal, und nur eines von postgres und mysql, da beide DATABASE_URL setzen.
version Ja "18" für PostgreSQL, "8.4" für MySQL, "8.0" für MongoDB, "9" für Valkey, als String in Anführungszeichen.
name Nein PostgreSQL, MySQL und MongoDB. Die Datenbank, die angelegt wird. Standard app. Kleinbuchstaben, Ziffern, Unterstriche und Bindestriche, beginnend mit einem Buchstaben oder Unterstrich, und kein Name, den die Engine reserviert (postgres, template0, template1, admin, local, config, mysql, information_schema, performance_schema, sys).
user Nein PostgreSQL, MySQL und MongoDB. Der Benutzer, als der sich die App verbindet. Standard kendor.
password Nein PostgreSQL, MySQL und MongoDB. Das Passwort dieses Benutzers. Standardmäßig keins, außer bei MongoDB, wo es kendor ist.
init Nein PostgreSQL, MySQL und MongoDB. Eine Seed-Datei oder ein Ordner mit solchen Dateien, relativ zum Workspace-Stamm: .sql für PostgreSQL und MySQL, .js für MongoDB.

Du kannst Datenbanken auch im Dialog Runtime-Konfiguration unter Datenbanken hinzufügen, mit einer optionalen Seed-Datei. Das Projekt Express + PostgreSQL + Valkey für Node.js ist ein vollständiges, funktionierendes Beispiel.

Seed-Daten mit init

init läuft einmal, direkt nachdem die Datenbank angelegt wurde, als der eigene Benutzer der App:

  • Eine Datei läuft für sich allein. Ein Ordner führt jede Seed-Datei darin in alphabetischer Reihenfolge aus, stelle den Dateien deshalb Zahlen voran: 01_schema.sql, 02_data.sql.
  • PostgreSQL führt alles in einer einzigen Transaktion aus. Schlägt eine Anweisung fehl, wird nichts angewendet.
  • MySQL führt jede .sql-Datei nacheinander aus und stoppt beim ersten Fehler. MySQL kann Schemaänderungen nicht zurückrollen, ein fehlgeschlagener Seed kann also einige Tabellen zurücklassen.
  • MongoDB führt .js-Dateien mit mongosh aus, verbunden mit der Datenbank der App. Es gibt keine Transaktion darum, ein fehlgeschlagener Seed kann also einige Schreibvorgänge zurücklassen.
  • Schlägt der Seed fehl, während die Sandbox läuft, läuft die Datenbank weiter, und der Fehler erscheint in ihrem Prozess. Korrigiere die Datei und starte dann den Prozess Datenbank in der Ansicht Prozesse neu, um sie erneut auszuführen.

Migrationen, die dein Framework ausführt (prisma migrate deploy, php artisan migrate), gehören stattdessen in die migrate-Befehle des Dienstes. Sie laufen bei jedem Start des Dienstes, nach dessen Installation und vor seinem dev-Befehl, sodass neue Migrationsdateien bei einem Neustart angewendet werden. Wenn du ein Repository importierst, trägt Kendor sie anhand des Migrationstools ein, das es bereits verwendet.

Verbindungsdetails

Jeder Server lauscht nur auf 127.0.0.1. PostgreSQL und MySQL verbinden sich als Benutzer kendor ohne Passwort. MongoDB kennt keine Anmeldung ohne Passwort, daher hat sein Benutzer kendor das Passwort kendor. Der Benutzer der App kann seine eigene Datenbank verwalten, ist aber kein Superuser.

PostgreSQL

Variable Wert
DATABASE_URL postgresql://kendor@127.0.0.1:5432/app (mit deinem name anstelle von app)
PGHOST, PGPORT, PGUSER, PGDATABASE 127.0.0.1, 5432, kendor, der Datenbankname
DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME, DB_PASSWORD Dieselben Werte, für Laravel. DB_PASSWORD ist leer.
SPRING_DATASOURCE_URL, SPRING_DATASOURCE_USERNAME, SPRING_DATASOURCE_PASSWORD jdbc:postgresql://127.0.0.1:5432/app, kendor und leer, für Spring Boot.

Wenn du ein password setzt, wird auch PGPASSWORD gesetzt.

Da dies echte Umgebungsvariablen sind, haben sie Vorrang vor einer Laravel-.env-Datei oder einer Spring-application.properties.

MySQL

Variable Wert
DATABASE_URL mysql://kendor@127.0.0.1:3306/app (mit deinem name anstelle von app)
MYSQL_HOST, MYSQL_PORT, MYSQL_USER, MYSQL_PASSWORD, MYSQL_DATABASE 127.0.0.1, 3306, kendor, leer, der Datenbankname
DB_CONNECTION, DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME, DB_PASSWORD mysql und dieselben Werte, für Laravel.
SPRING_DATASOURCE_URL, SPRING_DATASOURCE_USERNAME, SPRING_DATASOURCE_PASSWORD jdbc:mysql://127.0.0.1:3306/app, kendor und leer, für Spring Boot.

Wenn du ein password setzt, wird auch MYSQL_PWD gesetzt. Der Server akzeptiert außerdem Anmeldungen mit mysql_native_password, für ältere Treiber, die den neueren Standard von MySQL nicht nutzen können.

MongoDB

Variable Wert
MONGODB_URI, MONGODB_URL, MONGO_URI, MONGO_URL mongodb://kendor:kendor@127.0.0.1:27017/app?directConnection=true (mit deinem name anstelle von app)
SPRING_DATA_MONGODB_URI Dasselbe, für Spring Boot.
DATABASE_URL Dasselbe, für Prisma. Nicht gesetzt, wenn auch PostgreSQL oder MySQL deklariert ist; dann behält die SQL-Datenbank sie.

MongoDB läuft als Replica Set mit einem Knoten, daher funktionieren Transaktionen und Change Streams. Der Benutzer existiert in der Datenbank der App und in admin, eine URL mit authSource=admin funktioniert also ebenfalls.

Valkey

Variable Wert
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 Dasselbe, für Spring Boot.

Valkey spricht das Redis-Protokoll, daher funktioniert jeder Redis-Client.

Liest dein Code einen anderen Variablennamen, ordne ihn in dev.env.vars des Dienstes mit databases.<type>.url zu, etwa databases.postgres.url oder 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

Kandidaten sehen dieselben Details im Editor: Die Ansicht Prozesse hat einen Abschnitt Datenbanken mit jeder Verbindungs-URL, allen dafür gesetzten Variablen und einem Befehl, der einen Client im Terminal öffnet:

Datenbank Befehl im Terminal
PostgreSQL psql
MySQL mysql -h 127.0.0.1 -u $MYSQL_USER $MYSQL_DATABASE
MongoDB mongosh $MONGODB_URI
Valkey redis-cli

Aus dem Code verbinden

Lies die URL aus der Umgebung. Füge die Client-Bibliothek zu den Abhängigkeiten deines Projekts hinzu (pg und redis für Node.js, psycopg und redis für Python), damit der Install-Befehl sie lädt.

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

Was mit den Daten passiert

Während einer Sitzung bleiben die Daten erhalten. Die Zeilen liegen im eigenen Cache-Ordner der Sandbox, sie überstehen also einen Neustart des Datenbankprozesses oder der gesamten Sandbox, und der init-Seed läuft kein zweites Mal.

Der Tab Tests läuft gegen genau diese Live-Datenbank. Schreibe Tests, die die benötigten Zeilen selbst anlegen und hinterher aufräumen, oder umschließe jeden Test mit einer Transaktion, damit die Experimente eines Kandidaten im Terminal das Ergebnis nicht verändern können.

Limits

Limit
PostgreSQL-Verbindungen 20
Temporäre PostgreSQL-Dateien 1 GB pro Verbindung
MySQL-Verbindungen 20
MongoDB-Cache 256 MB
Valkey-Speicher 64 MB
Daten auf der Festplatte 1 GB; darüber hinaus stoppen die Datenbankserver, und der Prozess Datenbank erklärt, wie du mit einer leeren Datenbank neu beginnst

Die Datenbank-Ports 5432, 3306, 27017 und 6379 werden nie über die Vorschau freigegeben, selbst wenn ein Server darauf lauscht.

MySQL kann keine Dateien auf der Festplatte der Sandbox lesen oder schreiben (LOAD DATA INFILE, SELECT ... INTO OUTFILE), und bei MongoDB ist serverseitiges JavaScript ausgeschaltet ($where, $function, mapReduce).

War dieser Artikel hilfreich?