🗄️

Guia de Conexão: BuhDB

Aprenda a conectar seus aplicativos Fullstack ao seu banco de dados SQLite provisionado.

1. O Conceito

No BuhCloud, quando você provisiona um banco de dados, o sistema cria um arquivo físico .sqlite seguro no servidor. Diferente de um banco tradicional (MySQL/Postgres) que exige IP e Porta, o SQLite é um arquivo.

Vantagem:

Zero latência e backup simplificado. Ideal para apps de médio porte e bots.

2. Como Conectar (Node.js)

Use a biblioteca sqlite3 ou sqlite (wrapper async). No BuhCloud, injetamos o caminho do arquivo automaticamente se você configurar a variável de ambiente.

Exemplo com 'sqlite3' e 'sqlite':

const sqlite3 = require('sqlite3');
const { open } = require('sqlite');

async function main() {
    // Pegue o caminho da variável que você configurou no dashboard
    // Ex: DB_PATH=/root/user_databases/user123_nome.sqlite
    const dbPath = process.env.DB_PATH;

    if (!dbPath) {
        throw new Error("DB_PATH não configurado nas Secrets do App!");
    }

    const db = await open({
        filename: dbPath,
        driver: sqlite3.Database
    });

    await db.exec('CREATE TABLE IF NOT EXISTS teste (id INTEGER PRIMARY KEY, msg TEXT)');
    console.log("Conectado ao BuhDB com sucesso!");
}

main();

3. Configurando no Dashboard

  1. Crie seu banco na aba Bancos de Dados.
  2. Clique em Ver Credenciais e copie o valor de Caminho Absoluto.
  3. Vá no seu App Fullstack -> Configurações (Secrets).
  4. Crie uma variável chamada DB_PATH e cole o caminho.
  5. Reinicie o App para aplicar.