Fazer deploy ↗
docs

MySQL

Banco MySQL gerenciado na Veloz, ideal para aplicações legadas e stacks PHP/Node.js.

MySQL gerenciado para casos onde sua aplicação ou framework já fala MySQL. Provisionamento automático, backups e variáveis de ambiente injetadas nos serviços.

Versão padrão Versões disponíveis Porta padrão
8.4 8.4, 8.0 3306

Tamanhos

Tamanho CPU Memória
basico 0.25 vCPU 256 MB
essencial 0.5 vCPU 512 MB
turbo 1 vCPU 1 GB
turbo-plus 1.5 vCPU 2 GB
nitro 2 vCPU 4 GB
nitro-plus 4 vCPU 8 GB

O tamanho padrão é essencial.

Criar via CLI

# Mais simples
veloz db create --name mysql --engine mysql
 
# Com versão e storage
veloz db create --name mysql --engine mysql --version 8.4 --storage 10Gi --size essencial

Criar via veloz.json

{
  "databases": {
    "mysql": {
      "engine": "mysql",
      "version": "8.4",
      "storage": "10Gi",
      "size": "essencial"
    }
  }
}

Nota: MySQL não suporta a opção pooler. Esse campo é exclusivo do PostgreSQL.

Variáveis injetadas

Quando o banco está LIVE:

  • MYSQL_DATABASE_URL, mysql://user:pass@host:3306/db
  • MYSQL_HOST, MYSQL_PORT, MYSQL_USERNAME, MYSQL_PASSWORD, MYSQL_DATABASE
  • DATABASE_URL, alias automático se este for o único banco SQL do projeto

Acesso local

Túnel para GUI (DBeaver, MySQL Workbench, TablePlus)

# Abre na porta 3306 local
veloz db tunnel mysql
 
# Porta customizada (se 3306 já estiver ocupada)
veloz db tunnel mysql --port 3307

Em outra aba:

mysql -h 127.0.0.1 -P 3307 -u user -p

As credenciais aparecem em veloz db credentials mysql.

Query rápida

# Interativo
veloz db query mysql
 
# Inline
veloz db query mysql -q "SELECT count(*) FROM users"
veloz db query mysql -q "SHOW TABLES"

Dashboard

A seção de Insights traz métricas (conexões, QPS, latência, memória, disco), SQL Editor com syntax highlighting MySQL e Table Explorer para navegar schemas, tabelas e colunas.

Migrations

A Veloz não roda migrations automaticamente, fica a cargo da sua aplicação. Padrões comuns:

  • Prisma: prisma migrate deploy no pre-start command
  • TypeORM: typeorm migration:run no pre-start
  • Knex/Drizzle: comando equivalente do framework

Veja Melhores Práticas para a configuração com preStartCommand.

Comandos úteis

veloz db list                    # Listar bancos
veloz db credentials mysql       # Ver host, porta, usuário, senha
veloz db update mysql --size turbo   # Trocar tier
veloz db restart mysql           # Reiniciar engine
veloz db delete mysql            # Excluir (irreversível)

Próximos passos