Come gestire i database di ServBay con DBeaver

ServBay è un ambiente completo per lo sviluppo web locale che offre diversi servizi di database comunemente usati dagli sviluppatori. Sebbene ServBay includa strumenti di gestione database web come phpMyAdmin (per MySQL/MariaDB), pgAdmin (per PostgreSQL) e Redis Commander (per Redis), molti sviluppatori preferiscono utilizzare client desktop più potenti e con interfaccia unificata. DBeaver è proprio uno di questi strumenti, molto apprezzato e multipiattaforma.

In questa guida vedrai come collegare e gestire i database integrati in ServBay — tra cui MariaDB/MySQL, PostgreSQL, SQLite e Redis — tramite DBeaver.

Cos’è DBeaver?

DBeaver è un tool universale gratuito ed open source per la gestione dei database, pensato per sviluppatori, programmatori SQL, amministratori di database e analisti. Supporta quasi tutti i sistemi database più diffusi, tra cui database relazionali (come MySQL, PostgreSQL, Oracle, SQL Server, SQLite e altri) e database NoSQL (come MongoDB, Redis, Cassandra ecc.).

Caratteristiche principali di DBeaver:

• Ampio supporto per i database: consente la gestione di diversi tipi di database tramite un’unica interfaccia.
• Interfaccia intuitiva: offre un’interfaccia grafica user-friendly che semplifica anche le operazioni più complesse.
• Funzionalità avanzate: include editor SQL, editor di dati, browser di metadati, generazione di diagrammi ER, import/export di dati e altro ancora.
• Multipiattaforma: disponibile per Windows, macOS e Linux.
• Comunità attiva e aggiornamenti costanti: ne garantiscono stabilità e crescita funzionale.

Per gli utenti ServBay, l’utilizzo combinato con DBeaver offre un’esperienza di gestione database professionale e unificata, particolarmente utile nella gestione simultanea di più tipi di database o per operazioni complesse.

Gestione di MariaDB/MySQL su ServBay con DBeaver

ServBay integra di default MariaDB, completamente compatibile con MySQL. Di seguito sono riportati i passaggi per connettersi e gestire MariaDB/MySQL di ServBay tramite DBeaver.

Prerequisiti

• ServBay installato e in esecuzione.
• Il servizio MariaDB/MySQL avviato all’interno di ServBay.
• Client DBeaver scaricato e installato. Trovi l’ultima versione sul sito ufficiale DBeaver.

Connessione a MariaDB/MySQL

1. Apri DBeaver.
2. Fai clic sul pulsante in alto a sinistra "Nuova connessione database" (di solito rappresentato da un’icona a forma di spina).
3. Nel menù dei tipi di database, cerca e seleziona "MariaDB" oppure "MySQL". Poi clicca su "Avanti".
4. Inserisci i dati di connessione:
   • Host: 127.0.0.1 (o localhost)
   • Porta: 3306
   • Username: di default root.
   • Password: puoi trovare la password dell’utente root di MariaDB/MySQL nella scheda Database dell’interfaccia ServBay.
   • Database: puoi lasciarlo vuoto, la selezione o creazione può avvenire dopo la connessione.
   • Modalità di connessione (opzionale): Oltre alla connessione tramite TCP/IP (host+porta), puoi scegliere una connessione tramite Socket, generalmente più efficiente per collegamenti locali. Cerca la proprietà connectUsing nelle Proprietà driver e seleziona socket; poi cerca la proprietà socket e inserisci il percorso del file socket di MariaDB/MySQL di ServBay, che di default è /Applications/ServBay/tmp/mysql.sock. Nota: usando la connessione Socket, di solito non serve indicare host e porta.
5. Fai clic su "Test connessione" per verificare i parametri inseriti. Se il test fallisce, controlla che il servizio MariaDB su ServBay sia attivo e che username e password siano corretti. Se hai dimenticato la password, puoi reimpostarla dalla scheda Database di ServBay.
6. Se la connessione è testata con successo, clicca su "Finito" per salvare la connessione.

Operazioni database di base

Appena connesso, troverai l’istanza MariaDB/MySQL di ServBay nel navigatore database di DBeaver. Potrai:

• Creare un database: Clic destro sul nome della connessione, scegli "Editor SQL" -> "Nuovo script SQL". Scrivi CREATE DATABASE mydatabase_servbay; (sostituisci mydatabase_servbay con il nome desiderato) ed esegui tramite il pulsante dedicato (triangolo verde).
• Eseguire query in SQL Editor: Clic destro sulla connessione o su uno specifico database/tavola, scegli "Editor SQL" -> "Nuovo script SQL". Scrivi la tua query SQL, ad es. SELECT * FROM your_table_name; ed esegui.
• Visualizzare e modificare dati: Espandi database e tabelle nel navigatore, fai doppio clic su una tabella per visualizzarla e modificarne i dati nell’interfaccia intuitiva di DBeaver.
• Creare, modificare e eliminare tabelle: Clic destro sul nodo "Tabelle" sotto il database, scegli "Crea nuova tabella". Puoi anche modificare o cancellare tabelle esistenti con il clic destro.
• Importare/Esportare dati: DBeaver supporta diversi formati per import/export, facilitando la migrazione dei dati.

Queste operazioni possono essere svolte tramite l’interfaccia grafica o con l’editor SQL integrato, e il flusso è simile a quello di altri database.

Gestione di PostgreSQL su ServBay con DBeaver

ServBay integra anche il database PostgreSQL. Ecco come collegarsi e gestirlo tramite DBeaver.

Prerequisiti

• ServBay installato e attivo.
• Il servizio PostgreSQL avviato su ServBay.
• Client DBeaver installato.

Connessione a PostgreSQL

1. Avvia DBeaver.
2. Clicca su "Nuova connessione database" in alto a sinistra.
3. Nel menù dei tipi di database, cerca e seleziona "PostgreSQL". Clicca "Avanti".
4. Inserisci le informazioni di collegamento:
   • Host: 127.0.0.1 (o localhost)
   • Porta: 5432 (la porta di default di PostgreSQL)
   • Database: di default postgres. Puoi anche collegarti ad altri database che hai creato in ServBay.
   • Username: di default servbay.
   • Password: puoi trovare la password dell’utente PostgreSQL nella scheda Database di ServBay.
   • Modalità di connessione (opzionale): Come per MariaDB/MySQL, puoi usare la connessione Socket dal menù Proprietà driver, cercando socketFactory o proprietà simili e impostando il percorso del file Socket, di default /Applications/ServBay/tmp/.s.PGSQL.5432 (se la connessione fallisce, prova con /Applications/ServBay/tmp). Alcune versioni di DBeaver possono avere modalità di configurazione leggermente diverse; cerca tra le impostazioni avanzate della connessione. Usando Socket, solitamente non serve inserire host e porta.
5. Clicca su "Test connessione". Se il test fallisce, verifica che il servizio PostgreSQL sia avviato in ServBay e che username e password siano corretti. Se necessario, reimposta la password dalla scheda Database di ServBay.
6. Se la connessione viene verificata, clicca su "Finito" per salvare.

Operazioni database di base

Una volta collegato, troverai l’istanza di PostgreSQL nel navigatore database di DBeaver. Le operazioni tipiche di database relazionali (creazione di database/tabelle, query, editing dati, import/export) seguono un flusso simile a quello visto per MariaDB/MySQL e si possono eseguire sia tramite l’editor SQL che tramite l’interfaccia grafica.

Gestione di SQLite 3 su ServBay con DBeaver

ServBay include anche supporto per SQLite 3, un database leggero basato su file che non richiede un server dedicato.

Prerequisiti

• ServBay installato e in funzione.
• Client DBeaver installato.
• Un file database SQLite (.db, .sqlite, .sqlite3 ecc.). Se non lo possiedi, DBeaver può crearne uno quando avvii una nuova connessione.

Connessione a SQLite

1. Apri DBeaver.
2. Clic su "Nuova connessione database" in alto a sinistra.
3. Nel menù dei tipi di database, cerca e seleziona "SQLite". Poi clicca "Avanti".
4. Inserisci i dettagli di connessione:
   • Percorso file database: Clicca sull’icona cartella, scegli o inserisci il percorso completo del file SQLite. ServBay consiglia di salvare questi file in /Applications/ServBay/db/sqlite/ per facilità di gestione e backup.
   • Se il file non esiste, inserisci il percorso e nome desiderato, e DBeaver lo creerà automaticamente in fase di connessione.
5. Clicca su "Test connessione"; se il percorso è corretto e accessibile, la connessione sarà eseguita con successo.
6. Dopo il test, clicca su "Finito" per salvare il collegamento.

Operazioni base con SQLite

Collegato il file SQLite, puoi gestirlo in DBeaver come altri database, anche se le funzionalità di SQLite sono più semplici.

• Creare una tabella: Clic destro sul nome della connessione, scegli "Crea nuova tabella".
• Utilizzare l’editor SQL: Clic destro sulla connessione, scegli "Editor SQL" -> "Nuovo script SQL", scrivi ed esegui i tuoi comandi SQL.
• Visualizzare/modificare dati: Doppio clic sul nome della tabella per accedere all’editor dei dati.
• Eliminare una tabella: Clic destro sulla tabella, scegli "Elimina".
• Eliminare il database: Essendo un file, per eliminare il database basta cancellare il file .db dal sistema.

Gestione di Redis su ServBay con DBeaver

Redis è un archivio dati open source in memoria, usato come database, cache e broker di messaggi. ServBay integra anche Redis.

Prerequisiti

• ServBay installato e in esecuzione.
• Il servizio Redis avviato da ServBay.
• Client DBeaver installato.

Connessione a Redis

1. Avvia DBeaver.
2. Clicca su "Nuova connessione database" in alto a sinistra.
3. Nel menù dei tipi di database, cerca e seleziona "Redis". Poi clicca "Avanti".
4. Inserisci i dati di connessione:
   • Host: 127.0.0.1 (o localhost)
   • Porta: 6379 (porta predefinita Redis)
   • Password: Nel setup standard ServBay Redis non richiede password, quindi il campo può rimanere vuoto. Se hai impostato una password in ServBay, inseriscila qui.
5. Clicca su "Test connessione"; se il test fallisce, verifica che Redis stia funzionando su ServBay e che porta e password siano corrette.
6. Se test superato, clicca su "Finito" per salvare.

Gestione dei dati di base in Redis

Connesso a Redis, l’interfaccia grafica di DBeaver permette di visualizzare e amministrare le coppie chiave-valore.

• Visualizzare chiavi: Espandi la connessione nel navigatore database e seleziona il database (di solito DB 0), vedrai la lista delle chiavi.
• Aggiungere una chiave: Clic destro sul database o in un'area vuota dell’elenco chiavi, seleziona "Nuova chiave". Inserisci nome, scegli tipo (Stringa, Lista, Set, Hash, ZSet, ecc.) e valore.
• Modificare una chiave: Doppio clic o clic destro su una chiave esistente, scegli "Modifica chiave" per aggiornare valore o TTL (Time to Live).
• Eliminare una chiave: Clic destro sulla chiave, scegli "Elimina chiave".
• Utilizzare la console Redis: Clic destro sulla connessione o database, scegli "Editor SQL" -> "Nuova console Redis" per inviare direttamente comandi Redis.

Domande frequenti e risoluzione problemi (FAQ)

• Connessione fallita con errore "Connection Refused":
  • Assicurati che ServBay sia attivo.
  • Verifica che il servizio database scelto (MariaDB/MySQL, PostgreSQL, Redis) su ServBay sia avviato e appaia con stato verde.
  • Controlla che host e porta siano corretti (127.0.0.1 e le relative porte: MariaDB/MySQL: 3306, PostgreSQL: 5432, Redis: 6379).
  • Se usi la connessione Socket, accertati che il percorso file socket sia corretto e che il servizio database sia configurato per usarlo.
  • Verifica le impostazioni del firewall: assicurati che non interrompa la comunicazione tra DBeaver e le porte locali.
• Connessione riuscita ma autenticazione fallita (Authentication Failed):
  • Verifica username e password. Puoi trovare o reimpostare le credenziali utente root/predefinite nella scheda Database di ServBay.
• Errore di percorso file in connessione SQLite:
  • Accertati che il percorso del file sia completo e corretto.
  • Verifica che DBeaver abbia permessi di lettura/scrittura per il file.
• Interfaccia DBeaver incompleta o anomala:
  • Prova a riavviare DBeaver.
  • Verifica che la tua installazione Java sia funzionante (DBeaver dipende da Java).

Conclusioni

DBeaver è uno strumento molto potente per la gestione universale dei database e usato assieme a ServBay consente di amministrare facilmente tutti i database necessari nello sviluppo locale. Grazie alle indicazioni fornite, puoi collegare rapidamente DBeaver a MariaDB/MySQL, PostgreSQL, SQLite e Redis gestiti da ServBay ed eseguire tutte le operazioni di sviluppo e gestione correnti. Che si tratti di visualizzazione, editing, query SQL o attività di manutenzione avanzate, DBeaver offre un’interfaccia unificata ed efficiente. Unito alle funzionalità di ServBay per la gestione degli ambienti, il tuo workflow locale sarà ancora più fluido e produttivo.