menu
languageItaliano
save_alt Download

DB Manager Pro

Clonazione in streaming live, backup intelligenti, schema diff, health auditor, generatore di dati mock e rilevamento automatico di Docker/.env.

di T3zcaDev Plugin della community

Readme

Questo testo è stato scritto da terzi e tradotto automaticamente. Leggi l'originale in inglese

Versione Licenza Beekeeper Studio

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

  1. 📸 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 CompressionStream quando è offline.
    • Esplora snapshot locale con data, dimensione e motore, più ripristino assistito con finestra di conferma e protezione dal path traversal.
  2. 🔄 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.
  3. ⚖️ 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 (Blueprint con i metodi up() e down()). Aprilo direttamente nell'editor SQL di Beekeeper Studio o salvalo come .sql / .php.
  4. 🩺 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>).
  5. 🧪 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), .csv e .json.
  6. 🐳 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 .env locali, pronte da salvare in Beekeeper.
  7. 📖 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; controlla Tools ➔ DB Manager o /api/status per 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

  1. Installa DB Manager Pro dal marketplace dei plugin di Beekeeper Studio (Plugins ➔ cerca “DB Manager Pro”).
  2. 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.
  3. Fatto: l'eseguibile si installa da solo, si registra per l'avvio al login (Linux systemd --user, macOS LaunchAgent, Windows Startup) 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.

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

  1. Apri Beekeeper Studio e connettiti a un database qualsiasi.
  2. Tutti gli strumenti sono disponibili dalla barra superiore in Tools (le voci di menu nell'app sono attualmente in spagnolo):
    • Tools ➔ DB Manager: Snapshots & Backups
    • Tools ➔ DB Manager: Clonado Stream (A ➔ B) — clonazione live in streaming
    • Tools ➔ DB Manager: Schema Diff & Migraciones — schema diff & migrazioni
    • Tools ➔ DB Manager: Auditor de Salud & Rendimiento — audit di salute & prestazioni
    • Tools ➔ DB Manager: Generador Mock Data — generatore di dati fittizi
    • Tools ➔ DB Manager: Diccionario de Datos — dizionario dei dati
    • Tools ➔ 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.json e t3zca-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)