Como adicionar uma base de dados PostgreSQL, MySQL, MongoDB ou Redis a um desafio de código
Lista o PostgreSQL 18, o MySQL 8.4, o MongoDB 8.0 ou o Valkey 9 em databases no kendor.yaml. Correm dentro da sandbox e o código liga-se com DATABASE_URL, MONGODB_URI ou REDIS_URL.
Para dar uma base de dados a um desafio, lista-a em databases no kendor.yaml. O Kendor corre o PostgreSQL 18,
o MySQL 8.4, o MongoDB 8.0 e o Valkey 9 (compatível com Redis) dentro da sandbox do candidato em 127.0.0.1,
inicia-os antes de qualquer comando de instalação e define variáveis de ligação como DATABASE_URL,
MONGODB_URI e REDIS_URL para todos os processos, para que o código se ligue sem o candidato ter de
configurar nada.
Declarar uma base de dados
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| Chave | Obrigatória | Descrição |
|---|---|---|
type |
Sim | postgres, mysql, mongodb ou valkey. Cada um no máximo uma vez, e só um de postgres e mysql, já que ambos definem DATABASE_URL. |
version |
Sim | "18" para o PostgreSQL, "8.4" para o MySQL, "8.0" para o MongoDB, "9" para o Valkey, como texto entre aspas. |
name |
Não | PostgreSQL, MySQL e MongoDB. A base de dados a criar. Por omissão app. Letras minúsculas, dígitos, sublinhados e hífenes, começando por uma letra ou sublinhado, e que não seja um nome reservado pelo motor (postgres, template0, template1, admin, local, config, mysql, information_schema, performance_schema, sys). |
user |
Não | PostgreSQL, MySQL e MongoDB. O utilizador com que a app se liga. Por omissão kendor. |
password |
Não | PostgreSQL, MySQL e MongoDB. A palavra-passe desse utilizador. Por omissão nenhuma, exceto no MongoDB, onde é kendor. |
init |
Não | PostgreSQL, MySQL e MongoDB. Um ficheiro de seed, ou uma pasta deles, relativo à raiz do workspace: .sql para o PostgreSQL e o MySQL, .js para o MongoDB. |
Também podes adicionar bases de dados na janela Configuração do runtime, em Bancos de dados, com um Arquivo de seed opcional. O projeto Express + PostgreSQL + Valkey para Node.js é um exemplo completo e funcional.
Dados iniciais com init
O init corre uma vez, logo depois de a base de dados ser criada, com o utilizador da própria app:
- Um ficheiro corre sozinho. Uma pasta corre todos os ficheiros de seed que tiver, por ordem de nome, por isso prefixa
os ficheiros com números:
01_schema.sql,02_data.sql. - O PostgreSQL corre tudo numa única transação. Se alguma instrução falhar, nada é aplicado.
- O MySQL corre cada ficheiro
.sqlà vez e para no primeiro erro. O MySQL não consegue reverter alterações ao esquema, por isso um seed que falhe pode deixar algumas tabelas para trás. - O MongoDB corre ficheiros
.jscom omongosh, ligado à base de dados da app. Não há nenhuma transação à volta deles, por isso um seed que falhe pode deixar algumas escritas para trás. - Se o seed falhar enquanto a sandbox está a correr, a base de dados continua a correr e o erro aparece no seu processo. Corrige o ficheiro e reinicia o processo Base de dados na vista Processos para o executar de novo.
As migrações que a tua framework executa (prisma migrate deploy, php artisan migrate) vão antes nos comandos
migrate do serviço. Correm sempre que o serviço arranca, depois da instalação e
antes do comando dev, pelo que os novos ficheiros de migração são aplicados num reinício. Quando importas um repositório,
o Kendor preenche-os a partir da ferramenta de migrações que ele já usa.
Detalhes de ligação
Todos os servidores escutam apenas em 127.0.0.1. O PostgreSQL e o MySQL ligam-se como o utilizador kendor, sem
palavra-passe. O MongoDB não tem início de sessão sem palavra-passe, por isso o seu utilizador kendor tem a palavra-passe kendor. O
utilizador da app pode gerir a sua própria base de dados mas não é superutilizador.
PostgreSQL
| Variável | Valor |
|---|---|
DATABASE_URL |
postgresql://kendor@127.0.0.1:5432/app (com o teu name no lugar de app) |
PGHOST, PGPORT, PGUSER, PGDATABASE |
127.0.0.1, 5432, kendor, o nome da base de dados |
DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME, DB_PASSWORD |
Os mesmos valores, para o Laravel. DB_PASSWORD está vazia. |
SPRING_DATASOURCE_URL, SPRING_DATASOURCE_USERNAME, SPRING_DATASOURCE_PASSWORD |
jdbc:postgresql://127.0.0.1:5432/app, kendor e vazio, para o Spring Boot. |
Quando defines uma password, PGPASSWORD também é definida.
Como são variáveis de ambiente reais, têm precedência sobre um ficheiro .env do Laravel ou um
application.properties do Spring.
MySQL
| Variável | Valor |
|---|---|
DATABASE_URL |
mysql://kendor@127.0.0.1:3306/app (com o teu name no lugar de app) |
MYSQL_HOST, MYSQL_PORT, MYSQL_USER, MYSQL_PASSWORD, MYSQL_DATABASE |
127.0.0.1, 3306, kendor, vazio, o nome da base de dados |
DB_CONNECTION, DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME, DB_PASSWORD |
mysql e os mesmos valores, para o Laravel. |
SPRING_DATASOURCE_URL, SPRING_DATASOURCE_USERNAME, SPRING_DATASOURCE_PASSWORD |
jdbc:mysql://127.0.0.1:3306/app, kendor e vazio, para o Spring Boot. |
Quando defines uma password, MYSQL_PWD também é definida. O servidor aceita também inícios de sessão
mysql_native_password, para drivers mais antigos que não conseguem usar o método predefinido mais recente do MySQL.
MongoDB
| Variável | Valor |
|---|---|
MONGODB_URI, MONGODB_URL, MONGO_URI, MONGO_URL |
mongodb://kendor:kendor@127.0.0.1:27017/app?directConnection=true (com o teu name no lugar de app) |
SPRING_DATA_MONGODB_URI |
O mesmo, para o Spring Boot. |
DATABASE_URL |
O mesmo, para o Prisma. Não é definida quando o PostgreSQL ou o MySQL também está declarado; a base de dados SQL fica com ela. |
O MongoDB corre como um replica set de um só nó, por isso as transações e os change streams funcionam. O utilizador
existe na base de dados da app e em admin, por isso um URL com authSource=admin também funciona.
Valkey
| Variável | Valor |
|---|---|
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 |
O mesmo, para o Spring Boot. |
O Valkey fala o protocolo do Redis, por isso qualquer cliente Redis funciona.
Se o teu código lê um nome de variável diferente, mapeia-o em dev.env.vars do serviço com
databases.<type>.url, como databases.postgres.url ou 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.urlOs candidatos veem os mesmos detalhes no editor: a vista Processos tem uma secção Bancos de dados com cada URL de ligação, todas as variáveis definidas para ela e um comando para abrir um cliente no terminal:
| Base de dados | Comando no terminal |
|---|---|
| PostgreSQL | psql |
| MySQL | mysql -h 127.0.0.1 -u $MYSQL_USER $MYSQL_DATABASE |
| MongoDB | mongosh $MONGODB_URI |
| Valkey | redis-cli |
Ligar a partir do código
Lê o URL a partir do ambiente. Adiciona a biblioteca cliente às dependências do projeto (pg e
redis para Node.js, psycopg e redis para Python) para que o comando de instalação a obtenha.
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))O que acontece aos dados
Durante uma sessão, os dados persistem. As linhas ficam guardadas na pasta de cache da própria sandbox, por isso
sobrevivem a um reinício do processo da base de dados ou da sandbox inteira, e o seed init não corre uma segunda
vez.
O separador Testes corre contra essa mesma base de dados em funcionamento. Escreve testes que criem as linhas de que precisam e limpem depois de si, ou envolve cada teste numa transação, para que as experiências de um candidato no terminal não possam alterar o resultado.
Limites
| Limite | |
|---|---|
| Ligações PostgreSQL | 20 |
| Ficheiros temporários do PostgreSQL | 1 GB por ligação |
| Ligações MySQL | 20 |
| Cache do MongoDB | 256 MB |
| Memória do Valkey | 64 MB |
| Dados em disco | 1 GB; acima disso os servidores de bases de dados param e o processo Base de dados explica como recomeçar com uma base de dados vazia |
As portas das bases de dados, 5432, 3306, 27017 e 6379, nunca são expostas através da pré-visualização, mesmo que um servidor escute nelas.
O MySQL não consegue ler nem escrever ficheiros no disco da sandbox (LOAD DATA INFILE, SELECT ... INTO OUTFILE),
e o MongoDB tem o JavaScript do lado do servidor desligado ($where, $function, mapReduce).