Vai al contenuto
KendorDocs

Come aggiungere un database PostgreSQL, MySQL, MongoDB o Redis a una sfida di codice

Per chi crea le sfide ·

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

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
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 .sql alla 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 .js con mongosh, 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:

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

I 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.

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

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

Questo articolo ti è stato utile?