Banco de Dados SQLite

A Trapiche oferece bancos de dados SQLite integrados para todos os usuários dos planos pagos (Start e Pro), em parceria com o TursoDB. Crie um banco de dados diretamente da página do seu deploy, sem configuração externa.

Disponibilidade

Como Criar um Banco de Dados

1. Acesse a Página do Deploy

No dashboard, clique no deploy ao qual deseja vincular um banco de dados.

2. Clique em “Gerenciar banco”

Na página de detalhes do deploy, clique no botão “Gerenciar banco”. Se ainda não houver um banco de dados vinculado, você será solicitado a criar um.

3. Confirme a Criação

Confirme o nome do banco de dados (gerado automaticamente a partir do nome do deploy) e clique em “Criar banco de dados”.

O banco de dados é provisionado em segundos.

Variáveis de Ambiente Injetadas

Após criar o banco de dados, a Trapiche injeta automaticamente as seguintes variáveis de ambiente no seu deploy:

Essas variáveis ficam disponíveis no processo do seu servidor assim como qualquer outra variável de ambiente. Nenhuma configuração manual é necessária.

Conectando ao Banco de Dados

JavaScript / TypeScript (libsql)

Instale o cliente oficial:

npm install @libsql/client

Conecte usando as variáveis de ambiente injetadas:

import { createClient } from '@libsql/client';

const db = createClient({
  url: process.env.DATABASE_URL!,
  authToken: process.env.DATABASE_AUTH_TOKEN!,
});

// Exemplo: criar tabela e inserir dados
await db.execute(`
  CREATE TABLE IF NOT EXISTS usuarios (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    nome TEXT NOT NULL,
    email TEXT UNIQUE NOT NULL
  )
`);

await db.execute({
  sql: 'INSERT INTO usuarios (nome, email) VALUES (?, ?)',
  args: ['João Silva', 'joao@exemplo.com.br'],
});

const result = await db.execute('SELECT * FROM usuarios');
console.log(result.rows);

Python (libsql-client)

pip install libsql-client

import libsql_client
import os

client = libsql_client.create_client_sync(
    url=os.environ["DATABASE_URL"],
    auth_token=os.environ["DATABASE_AUTH_TOKEN"],
)

client.execute("CREATE TABLE IF NOT EXISTS items (id INTEGER PRIMARY KEY, nome TEXT)")
client.execute("INSERT INTO items (nome) VALUES (?)", ["meu item"])

result = client.execute("SELECT * FROM items")
print(result.rows)

Go (libsql)

go get github.com/tursodatabase/libsql-client-go/libsql

package main

import (
    "database/sql"
    "fmt"
    "os"

    _ "github.com/tursodatabase/libsql-client-go/libsql"
)

func main() {
    url := os.Getenv("DATABASE_URL") + "?authToken=" + os.Getenv("DATABASE_AUTH_TOKEN")
    db, _ := sql.Open("libsql", url)
    defer db.Close()

    db.Exec("CREATE TABLE IF NOT EXISTS items (id INTEGER PRIMARY KEY, nome TEXT)")
    db.Exec("INSERT INTO items (nome) VALUES (?)", "meu item")

    rows, _ := db.Query("SELECT id, nome FROM items")
    defer rows.Close()
    for rows.Next() {
        var id int
        var nome string
        rows.Scan(&id, &nome)
        fmt.Printf("%d: %s\n", id, nome)
    }
}

Gerenciando o Banco de Dados

Na página do deploy, o painel “Gerenciar banco” permite:

• Visualizar tabelas — navegue pela estrutura do banco diretamente no dashboard
• Executar queries — rode SQL diretamente pela interface
• Ver estatísticas — tamanho do banco, número de tabelas e linhas
• Rotacionar token — gere um novo DATABASE_AUTH_TOKEN (o novo token é injetado automaticamente no próximo deploy)
• Excluir banco — apaga permanentemente o banco de dados e remove as variáveis de ambiente

Atenção: A exclusão do banco de dados é irreversível. Faça backup dos dados antes de excluir.

Backup e Exportação

Para exportar seus dados, você pode usar o painel do dashboard ou executar via código:

// Exportar todas as linhas de uma tabela para JSON
const result = await db.execute('SELECT * FROM minha_tabela');
const json = JSON.stringify(result.rows, null, 2);
// salve em arquivo ou envie para um serviço de armazenamento

Limites

Suporte

Dúvidas sobre o banco de dados? Entre em contato:

• Email: suporte@trapiche.cloud
• Discord: discord.gg/trapiche

Feito com ❤️ no Brasil 🇧🇷