So fügst du einer Coding-Aufgabe eine PostgreSQL-, MySQL-, MongoDB- oder Redis-Datenbank hinzu
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
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 mitmongoshaus, 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:
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.urlKandidaten 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.
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))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).