Saltar para o conteúdo
KendorDocs

Como adicionar uma base de dados PostgreSQL, MySQL, MongoDB ou Redis a um desafio de código

Para autores de desafios ·

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

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
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 .js com o mongosh, 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:

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

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

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

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

Este artigo foi útil?