Come aggiungere un database PostgreSQL, MySQL, MongoDB o Redis a una sfida di codice
Elenca PostgreSQL 18, MySQL 8.4, MongoDB 8.0 o Valkey 9 sotto databases in kendor.yaml. Girano dentro la sandbox e il codice si collega con DATABASE_URL, MONGODB_URI o REDIS_URL.
Per dare un database a una sfida, elencalo sotto databases in kendor.yaml. Kendor esegue PostgreSQL 18,
MySQL 8.4, MongoDB 8.0 e Valkey 9 (compatibile con Redis) dentro la sandbox del candidato su 127.0.0.1,
li avvia prima di qualsiasi comando di installazione e imposta variabili di connessione come
DATABASE_URL, MONGODB_URI e REDIS_URL per ogni processo, così il codice si collega senza che il
candidato debba configurare nulla.
Dichiarare un database
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| Chiave | Obbligatoria | Descrizione |
|---|---|---|
type |
Sì | postgres, mysql, mongodb o valkey. Ciascuno al massimo una volta, e solo uno tra postgres e mysql, perché entrambi impostano DATABASE_URL. |
version |
Sì | "18" per PostgreSQL, "8.4" per MySQL, "8.0" per MongoDB, "9" per Valkey, come stringa tra virgolette. |
name |
No | PostgreSQL, MySQL e MongoDB. Il database da creare. Predefinito app. Lettere minuscole, cifre, trattini bassi e trattini, che inizi con una lettera o un trattino basso, e diverso da un nome che il motore riserva (postgres, template0, template1, admin, local, config, mysql, information_schema, performance_schema, sys). |
user |
No | PostgreSQL, MySQL e MongoDB. L'utente con cui si collega l'app. Predefinito kendor. |
password |
No | PostgreSQL, MySQL e MongoDB. La password di quell'utente. Predefinita nessuna, tranne per MongoDB, dove è kendor. |
init |
No | PostgreSQL, MySQL e MongoDB. Un file di seed, o una cartella di file di seed, relativo alla radice del workspace: .sql per PostgreSQL e MySQL, .js per MongoDB. |
Puoi aggiungere i database anche nella finestra Configurazione runtime, sotto Database, con un File di seed facoltativo. Il progetto Express + PostgreSQL + Valkey per Node.js è un esempio completo e funzionante.
Dati iniziali con init
init viene eseguito una sola volta, subito dopo la creazione del database, con l'utente dell'app:
- Un file viene eseguito da solo. Una cartella esegue tutti i file di seed al suo interno in ordine
di nome, quindi dai ai file un prefisso numerico:
01_schema.sql,02_data.sql. - PostgreSQL esegue tutto in un'unica transazione. Se un'istruzione fallisce, non viene applicato nulla.
- MySQL esegue un file
.sqlalla volta e si ferma al primo errore. MySQL non può annullare le modifiche allo schema, quindi un seed fallito può lasciare alcune tabelle. - MongoDB esegue i file
.jsconmongosh, collegato al database dell'app. Non c'è una transazione attorno, quindi un seed fallito può lasciare alcune scritture. - Se il seed fallisce mentre la sandbox è in esecuzione, il database continua a girare e l'errore compare nel suo processo. Correggi il file, poi riavvia il processo Database dalla vista Processi per eseguirlo di nuovo.
Le migrazioni che il tuo framework esegue (prisma migrate deploy, php artisan migrate) vanno
invece nei comandi migrate del servizio. Vengono eseguiti ogni volta che il servizio parte, dopo
l'installazione e prima del comando dev, quindi i nuovi file di migrazione si applicano a un
riavvio. Quando importi un repository, Kendor li compila a partire dallo strumento di migrazione che
usa già.
Dettagli di connessione
Ogni server ascolta solo su 127.0.0.1. PostgreSQL e MySQL si collegano come utente kendor senza
password. MongoDB non ha accessi senza password, quindi il suo utente kendor ha la password kendor.
L'utente dell'app può gestire il proprio database ma non è un superutente.
PostgreSQL
| Variabile | Valore |
|---|---|
DATABASE_URL |
postgresql://kendor@127.0.0.1:5432/app (con il tuo name al posto di app) |
PGHOST, PGPORT, PGUSER, PGDATABASE |
127.0.0.1, 5432, kendor, il nome del database |
DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME, DB_PASSWORD |
Gli stessi valori, per Laravel. DB_PASSWORD è vuota. |
SPRING_DATASOURCE_URL, SPRING_DATASOURCE_USERNAME, SPRING_DATASOURCE_PASSWORD |
jdbc:postgresql://127.0.0.1:5432/app, kendor e vuota, per Spring Boot. |
Quando imposti una password, viene impostata anche PGPASSWORD.
Poiché sono vere variabili d'ambiente, hanno la precedenza su un file .env di Laravel o su un
application.properties di Spring.
MySQL
| Variabile | Valore |
|---|---|
DATABASE_URL |
mysql://kendor@127.0.0.1:3306/app (con il tuo name al posto di app) |
MYSQL_HOST, MYSQL_PORT, MYSQL_USER, MYSQL_PASSWORD, MYSQL_DATABASE |
127.0.0.1, 3306, kendor, vuota, il nome del database |
DB_CONNECTION, DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME, DB_PASSWORD |
mysql e gli stessi valori, per Laravel. |
SPRING_DATASOURCE_URL, SPRING_DATASOURCE_USERNAME, SPRING_DATASOURCE_PASSWORD |
jdbc:mysql://127.0.0.1:3306/app, kendor e vuota, per Spring Boot. |
Quando imposti una password, viene impostata anche MYSQL_PWD. Il server accetta anche accessi
mysql_native_password, per i driver più vecchi che non supportano il nuovo metodo predefinito di MySQL.
MongoDB
| Variabile | Valore |
|---|---|
MONGODB_URI, MONGODB_URL, MONGO_URI, MONGO_URL |
mongodb://kendor:kendor@127.0.0.1:27017/app?directConnection=true (con il tuo name al posto di app) |
SPRING_DATA_MONGODB_URI |
Lo stesso, per Spring Boot. |
DATABASE_URL |
Lo stesso, per Prisma. Non viene impostata quando è dichiarato anche PostgreSQL o MySQL; la mantiene il database SQL. |
MongoDB gira come replica set a un solo nodo, quindi transazioni e change stream funzionano. L'utente
esiste nel database dell'app e in admin, quindi funziona anche un URL con authSource=admin.
Valkey
| Variabile | Valore |
|---|---|
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 |
Gli stessi, per Spring Boot. |
Valkey parla il protocollo Redis, quindi funziona qualsiasi client Redis.
Se il tuo codice legge una variabile con un nome diverso, mappala in dev.env.vars del servizio con
databases.<type>.url, come databases.postgres.url o 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.urlI candidati vedono gli stessi dettagli nell'editor: la vista Processi ha una sezione Database con ogni URL di connessione, ogni variabile impostata per esso e un comando per aprire un client nel terminale:
| Database | Comando da terminale |
|---|---|
| PostgreSQL | psql |
| MySQL | mysql -h 127.0.0.1 -u $MYSQL_USER $MYSQL_DATABASE |
| MongoDB | mongosh $MONGODB_URI |
| Valkey | redis-cli |
Collegarsi dal codice
Leggi l'URL dall'ambiente. Aggiungi la libreria client alle dipendenze del progetto (pg e
redis per Node.js, psycopg e redis per Python) in modo che il comando di installazione la scarichi.
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))Che cosa succede ai dati
Durante una sessione i dati persistono. Le righe sono salvate nella cartella di cache della
sandbox, quindi sopravvivono al riavvio del processo del database o dell'intera sandbox, e il
seed init non viene eseguito una seconda volta.
La scheda Test viene eseguita su questo stesso database attivo. Scrivi test che creino le righe di cui hanno bisogno e che ripuliscano dopo di sé, oppure racchiudi ogni test in una transazione, così gli esperimenti di un candidato nel terminale non possono alterare il risultato.
Limiti
| Limite | |
|---|---|
| Connessioni PostgreSQL | 20 |
| File temporanei PostgreSQL | 1 GB per connessione |
| Connessioni MySQL | 20 |
| Cache MongoDB | 256 MB |
| Memoria Valkey | 64 MB |
| Dati su disco | 1 GB; oltre questo limite i server di database si fermano e il processo Database spiega come ripartire da un database vuoto |
Le porte dei database, 5432, 3306, 27017 e 6379, non vengono mai esposte tramite l'anteprima, anche se un server è in ascolto su di esse.
MySQL non può leggere né scrivere file sul disco della sandbox (LOAD DATA INFILE, SELECT ... INTO OUTFILE),
e MongoDB ha JavaScript lato server disattivato ($where, $function, mapReduce).