Plugin e suite di strumenti avanzati per Beekeeper Studio (v5.4+). Creato da T3zcaDev.
English · Español
L'interfaccia del plugin è disponibile in inglese e spagnolo; puoi cambiare lingua dall'intestazione.
✨ Funzionalità principali
- 📸 Snapshot & backup intelligenti (1 clic):
- Backup compressi al volo con Zstandard (
zstd -3) o Gzip ad alta velocità. - Motore ibrido: invia i dati direttamente tramite pipe quando il daemon è attivo, oppure esegue il dump nativamente dal browser con
CompressionStreamquando è offline. - Esplora snapshot locale con data, dimensione e motore, più ripristino assistito con finestra di conferma e protezione dal path traversal.
- Backup compressi al volo con Zstandard (
- 🔄 Clonazione live in streaming (A ➔ B):
- Trasferisce interi database tra server (Produzione/Staging ➔ Locale/Docker) in tempo reale tramite pipe, senza scrivere file temporanei su disco.
- Sanitizzazione automatica: rimuove le istruzioni in conflitto (
DEFINER,USE,CREATE DATABASE,SQL_LOG_BIN). - Filtro tabelle e mascheramento dati: esclude le tabelle di telemetria e maschera al volo email e dati sensibili.
- Modalità incrementale (solo modifiche): confronta le impronte di ogni tabella con l'ultima sincronizzazione e copia solo ciò che è cambiato. Le tabelle contrassegnate come append-only copiano solo le nuove righe. Pensata per database di grandi dimensioni, dove la seconda importazione non deve ripetere il 100%. Vedi docs/INCREMENTAL_SYNC.md.
- ⚖️ Schema Diff V2 multi-motore & migrazioni:
- Supporto multi-motore per MySQL / MariaDB e PostgreSQL.
- Rileva tabelle mancanti, colonne mancanti, tipi non corrispondenti, indici e chiavi esterne.
- Doppio esportatore: genera DDL nativo e codice di migrazione Laravel (
Blueprintcon i metodiup()edown()). Aprilo direttamente nell'editor SQL di Beekeeper Studio o salvalo come.sql/.php.
- 🩺 Audit di salute & prestazioni:
- Punteggio di salute globale (0 - 100) con indicatore a semaforo e penalità configurabili.
- Tabelle senza chiave primaria: segnala le tabelle che peggiorano la replica basata su righe (RBR) e le prestazioni.
- Indici ridondanti: trova indici duplicati identici e prefissi ridondanti che rallentano le scritture
INSERT/UPDATE. - Ripartizione dello spazio: dimensione dei dati rispetto agli indici per ogni tabella.
- Monitor dei processi live: mostra thread e query attivi (
SHOW PROCESSLIST/pg_stat_activity) con un pulsante per interrompere una query in sicurezza (KILL QUERY <id>).
- 🧪 Generatore intelligente di dati fittizi & seeding a cascata (DAG):
- Riempie qualsiasi tabella con dati realistici tramite Faker.
- Popola tutto a cascata (seeding a grafo): risolve il grafo delle dipendenze delle chiavi esterne per le tabelle vuote, popolando prima le tabelle padre e inserendo automaticamente i loro ID nelle tabelle figlie.
- Esportazione dei seed: esporta in
.sql(INSERT INTO),.csve.json.
- 🐳 Auto-Discovery (Docker & progetti locali):
- Rileva i container in esecuzione (
docker ps) per MySQL, Postgres, MongoDB, Redis, ClickHouse e SQL Server, con la mappatura delle porte dell'host. - Estrae le credenziali dai file
.envlocali, pronte da salvare in Beekeeper.
- Rileva i container in esecuzione (
- 📖 Dizionario dei dati:
- Esporta la documentazione tecnica del database in Markdown o HTML statico.
📋 Requisiti
- Beekeeper Studio 5.4+
- Node.js 18+ e npm — solo se installi con l'Opzione B (symlink/sviluppo). L'installer nativo del companion (Opzione A) non richiede Node.js.
mysql/mysqldump,psql/pg_dump,mongodump,docker(a seconda del motore che usi) — il companion li richiama ma non li include; controllaTools ➔ DB Managero/api/statusper vedere quali rileva.- CLI
sqlite3(opzionale, solo per leggere le connessioni già salvate in Beekeeper)
🔒 Privacy
Tutta l'elaborazione avviene sulla tua macchina. Il daemon companion resta in ascolto solo su 127.0.0.1:58765 (loopback) e non comunica mai con server esterni. Le credenziali di connessione non lasciano mai il tuo computer.
🚀 Installazione e avvio automatico
Opzione A: marketplace di Beekeeper Studio + installer nativo (consigliata)
- Installa DB Manager Pro dal marketplace dei plugin di Beekeeper Studio (
Plugins➔ cerca “DB Manager Pro”). - La prima volta che apri uno strumento che richiede il companion (Stream Clone, Auto-Discovery, Schema Diff), vedrai un avviso “Companion Daemon not responding” con un pulsante Download Companion — scarica l'eseguibile per il tuo sistema operativo da GitHub Releases e aprilo con un doppio clic.
- Fatto: l'eseguibile si installa da solo, si registra per l'avvio al login (Linux
systemd --user, macOSLaunchAgent, WindowsStartup) e parte subito. Non ti serve Node.js installato né un terminale aperto.
L'installer non è ancora firmato (vedi docs/COMPANION.md), quindi Windows/macOS mostreranno un avviso di sicurezza la prima volta — quel documento spiega esattamente quale pulsante premere per continuare.
⚠️ Modalità di sola lettura (Beekeeper Studio 6.2+)
Beekeeper Studio 6.2 installa i plugin in modalità di sola lettura per impostazione predefinita, bloccando le scritture eseguite tramite runQuery. DB Manager Pro ha bisogno che sia disattivata per Stream Clone, generazione di Mock Data, applicazione delle migrazioni di Schema Diff e annullamento dei processi dall'Health Auditor; l'opzione si trova nelle impostazioni del plugin (Plugins ➔ DB Manager Pro). Snapshot, Dizionario dei dati, Auto-Discovery e analisi di salute continuano a funzionare in sola lettura.
Opzione B: symlink per sviluppo/contributi
git clone https://github.com/JonathanHerSa/bks-db-manager.git
cd bks-db-manager
npm install
npm run build
ln -s "$(pwd)" ~/.config/beekeeper-studio/plugins/t3zca-db-manager
npm install lascia già il daemon companion in esecuzione in background, configurato per avviarsi automaticamente e puntato al repo clonato (non al binario nativo) — non servono comandi extra né finestre di terminale per usare il plugin.
Beekeeper Studio 6.2+: il sistema di plugin ha aggiunto
unlistedDisabled, attivo per impostazione predefinita. Perché Beekeeper carichi il symlink di sviluppo, aggiungi questo a~/.config/beekeeper-studio/user.config.ini:[pluginSystem] disabled = false unlistedDisabled = false communityDisabled = false
Gestione manuale del servizio (opzionale)
Ti serve solo se hai installato con npm install --ignore-scripts, hai spostato la cartella del progetto o vuoi disattivarlo:
# (Re)install the background service manually
npm run daemon:install
# Check that it is running and responding
npm run daemon:status
# Uninstall it at any time
npm run daemon:uninstall
(Puoi anche eseguirlo temporaneamente in un terminale con npm run server invece del servizio persistente.)
Aprirlo in Beekeeper Studio
- Apri Beekeeper Studio e connettiti a un database qualsiasi.
- Tutti gli strumenti sono disponibili dalla barra superiore in
Tools(le voci di menu nell'app sono attualmente in spagnolo):Tools➔DB Manager: Snapshots & BackupsTools➔DB Manager: Clonado Stream (A ➔ B)— clonazione live in streamingTools➔DB Manager: Schema Diff & Migraciones— schema diff & migrazioniTools➔DB Manager: Auditor de Salud & Rendimiento— audit di salute & prestazioniTools➔DB Manager: Generador Mock Data— generatore di dati fittiziTools➔DB Manager: Diccionario de Datos— dizionario dei datiTools➔DB Manager: Auto-Discovery (Docker & .env)- Oppure fai clic destro su una tabella ➔
DB Manager: Mock Data para esta tabla.
Modalità sviluppo con Hot Reload (opzionale)
Per modificare i componenti Vue e vedere subito le modifiche:
npm run dev
📦 Build e release
npm run build # plugin frontend -> dist/
npm run companion:build # native companion binary for your OS -> build/
Ogni push di un tag vX.Y.Z avvia .github/workflows/release.yml, che compila e pubblica una sola GitHub Release con:
manifest.jsonet3zca-db-manager-{version}.zip(frontend del plugin, secondo il processo di pubblicazione di Beekeeper Studio Plugins).bks-db-manager-companion-{linux-x64,linux-arm64,darwin-arm64,win-x64}.{tar.gz,zip}+ i relativi.sha256(l'installer nativo del companion, vedi docs/COMPANION.md) — senza versione nel nome, così si possono sempre linkare da/releases/latest/download/. macOS Intel (x64) è ancora in sospeso per un bug aperto di Node.js (nodejs/node#62893).
🤝 Contribuire
Issue e pull request sono benvenute. Prima di aprire una PR corposa, apri prima una issue per discutere la modifica.
📄 Licenza
Questo progetto è distribuito con licenza GPLv3 — vedi LICENSE per il testo completo.
👤 Autore
T3zcaDev — GitHub (@JonathanHerSa)