Come gestire i database di ServBay con DBeaver

ServBay è un ambiente completo per lo sviluppo web locale, che offre agli sviluppatori diversi servizi di database popolari. Sebbene ServBay includa strumenti di gestione database con interfaccia web come phpMyAdmin (per MySQL/MariaDB), pgAdmin (per PostgreSQL) e Redis Commander (per Redis), molti sviluppatori preferiscono utilizzare client desktop più avanzati e con un’interfaccia unificata per la gestione dei database. DBeaver è uno di questi strumenti cross-platform molto apprezzati.

Questa guida ti mostra come collegarti e gestire i database integrati in ServBay tramite DBeaver, inclusi MariaDB/MySQL, PostgreSQL, SQLite e Redis.

Che cos’è DBeaver?

DBeaver è uno strumento open source e gratuito per la gestione universale dei database, pensato per sviluppatori, programmatori SQL, amministratori di database e analisti. Supporta quasi tutti i principali sistemi di database, sia relazionali (come MySQL, PostgreSQL, Oracle, SQL Server, SQLite, ecc.) che NoSQL (come MongoDB, Redis, Cassandra, ecc.).

Le principali caratteristiche di DBeaver includono:

• Ampio supporto per database: Gestione di diversi tipi di database attraverso un’unica interfaccia.
• Interfaccia user-friendly: Offre un’interfaccia grafica intuitiva, semplificando anche le operazioni complesse.
• Funzionalità avanzate: Include editor SQL, editor di dati, browser dei metadati, generazione di diagrammi ER, import/export dati e molto altro.
• Cross-platform: Compatibile con Windows, macOS e Linux.
• Comunità attiva e aggiornamenti continui: Garantisce stabilità e costante espansione delle funzionalità dello strumento.

Per chi utilizza ServBay, combinare DBeaver offre un’esperienza di gestione database più professionale e coerente, soprattutto quando si devono amministrare differenti tipi di database o eseguire query e operazioni avanzate.

Gestione di MariaDB/MySQL integrato in ServBay con DBeaver

ServBay integra nativamente MariaDB, pienamente compatibile con MySQL. Ecco come collegare e gestire il database MariaDB/MySQL di ServBay tramite DBeaver.

Prerequisiti

• ServBay installato e in esecuzione.
• Il pacchetto MariaDB/MySQL avviato in ServBay.
• DBeaver scaricato e installato. Puoi trovare l’ultima versione sul sito ufficiale DBeaver.

Connessione a MariaDB/MySQL

1. Apri DBeaver.
2. Clicca sul pulsante "Nuova connessione database" (solitamente rappresentato da un’icona a forma di spina) in alto a sinistra.
3. Nella lista dei tipi di database, cerca e seleziona "MariaDB" oppure "MySQL". Clicca su "Avanti".
4. Inserisci le informazioni di connessione:
   • Host: 127.0.0.1 (oppure localhost)
   • Porta: 3306
   • Username: di default root.
   • Password: la password dell’utente root è disponibile alla scheda Database dell’interfaccia di ServBay.
   • Database: puoi lasciare questo campo vuoto inizialmente; dopo la connessione puoi selezionare o creare un database.
   • Metodo di connessione (opzionale): Oltre a TCP/IP (host+porta), puoi scegliere una connessione Socket, più efficiente localmente. Nelle Proprietà driver (Driver properties) cerca connectUsing e impostalo su socket, quindi trova la proprietà socket e inserisci il percorso del file socket di MariaDB/MySQL di ServBay (predefinito: /Applications/ServBay/tmp/mysql.sock). Nota: utilizzando il socket solitamente non serve indicare host e porta.
5. Clicca su "Testa connessione" per verificare i parametri inseriti. In caso di errore, controlla che MariaDB sia attivo su ServBay e che username e password siano corretti. Se hai dimenticato la password, puoi reimpostarla dalla scheda Database di ServBay.
6. Se il test va a buon fine, clicca su "Fine" per salvare la connessione.

Operazioni di base sul database

Una volta connesso, vedrai l’istanza MariaDB/MySQL di ServBay nel navigatore database di DBeaver e potrai:

• Creare un database: Tasto destro sul nome della connessione, seleziona "Editor SQL" -> "Nuovo script SQL". Inserisci CREATE DATABASE mydatabase_servbay; (sostituisci mydatabase_servbay con il nome desiderato) e premi il pulsante di esecuzione (triangolo verde).
• Eseguire query SQL: Tasto destro sulla connessione o su un database/tavola -> "Editor SQL" -> "Nuovo script SQL". Scrivi la tua query, ad esempio SELECT * FROM your_table_name; e avvia l’esecuzione.
• Visualizzare/modificare dati: Espandi database e tavole nel navigatore, doppio click su una tabella per visualizzare e modificare i dati. DBeaver offre un editor dati molto intuitivo.
• Creare, modificare e cancellare tavole: Tasto destro su "Tables" sotto un database -> "Crea nuova tavola". Tasto destro su tavole esistenti per modificarle o cancellarle.
• Importare/esportare dati: DBeaver supporta import/export in diversi formati per agevolare la migrazione dei dati.

L’interfaccia grafica e l’editor SQL permettono di eseguire queste operazioni facilmente, come con altri sistemi database.

Gestione di PostgreSQL integrato in ServBay con DBeaver

ServBay include anche il database PostgreSQL. Di seguito i passaggi per collegarsi e gestire PostgreSQL tramite DBeaver.

Prerequisiti

• ServBay installato e attivo.
• Il pacchetto PostgreSQL avviato in ServBay.
• DBeaver installato.

Connessione a PostgreSQL

1. Apri DBeaver.
2. Clicca il pulsante "Nuova connessione database".
3. Nella lista dei tipi di database, cerca e seleziona "PostgreSQL". Clicca su "Avanti".
4. Inserisci le informazioni di connessione:
   • Host: 127.0.0.1 (oppure localhost)
   • Porta: 5432 (porta predefinita di PostgreSQL)
   • Database: di default postgres. Puoi anche inserire un altro database creato in ServBay.
   • Username: di default servbay.
   • Password: la trovi nella scheda Database dell’applicazione ServBay.
   • Metodo di connessione (opzionale): Come con MariaDB/MySQL, è possibile connettersi tramite Socket. Nelle Proprietà driver (Driver properties) cerca socketFactory o proprietà simili e inserisci il percorso file socket, di default /Applications/ServBay/tmp/.s.PGSQL.5432 (se fallisce, prova /Applications/ServBay/tmp). La modalità di configurazione può variare leggermente a seconda della versione di DBeaver; solitamente la trovi tra le opzioni avanzate. Con il socket, host e porta di solito non sono necessari.
5. Clicca su "Testa connessione". Se necessario, controlla che il servizio PostgreSQL sia attivo in ServBay e che le credenziali siano corrette. Se hai dimenticato la password, puoi reimpostarla dalla scheda Database di ServBay.
6. Se il test è riuscito, clicca su "Fine" per salvare la connessione.

Operazioni di base sul database

Dopo la connessione, troverai l’istanza PostgreSQL di ServBay nel navigatore di DBeaver. Le operazioni comuni (creazione di database e tavole, query SQL, gestione dati, import/export) sono analoghe alla gestione di MariaDB/MySQL e possono essere eseguite sia tramite editor SQL che tramite l’interfaccia grafica.

Gestione di SQLite 3 integrato in ServBay con DBeaver

ServBay supporta anche SQLite 3, un motore database leggero e basato su file, che non richiede processi server dedicati.

Prerequisiti

• ServBay installato e attivo.
• DBeaver installato.
• È necessario avere un file database SQLite (.db, .sqlite, .sqlite3, ecc.). Se non lo possiedi, DBeaver può crearne uno durante la creazione della connessione.

Connessione a SQLite

1. Apri DBeaver.
2. Clicca su "Nuova connessione database".
3. Nella lista, cerca e seleziona "SQLite". Clicca su "Avanti".
4. Inserisci le informazioni di connessione:
   • Percorso file database: Clicca sull’icona cartella e scegli/inserisci il percorso completo al file database SQLite. ServBay consiglia di utilizzare la cartella /Applications/ServBay/db/sqlite/ per una migliore gestione e backup.
   • Se il file non esiste ancora, inserisci percorso e nome desiderati; DBeaver lo creerà automaticamente durante la connessione.
5. Premi su "Testa connessione". Se il percorso è corretto e accessibile, il test avrà successo.
6. Se il test va a buon fine, clicca "Fine" per salvare la connessione.

Operazioni di base con SQLite

Dopo la connessione puoi gestire i database SQLite come qualsiasi altro database in DBeaver, ricordando che le funzionalità offerte da SQLite sono più basilari.

• Creare una tabella: Tasto destro sul nome della connessione, seleziona "Crea nuova tavola".
• Utilizzare l’editor SQL: Tasto destro sulla connessione, seleziona "Editor SQL" -> "Nuovo script SQL", inserisci ed esegui le istruzioni SQL.
• Visualizzare/modificare dati: Doppio click sul nome della tabella.
• Eliminare una tabella: Tasto destro sulla tabella, seleziona "Elimina".
• Eliminare il database: Un database SQLite è semplicemente un file; per eliminarlo cancella il file .db dal file system.

Gestione di Redis integrato in ServBay con DBeaver

Redis è uno store dati open source in memoria, utilizzabile come database, cache e message broker. Anche Redis è integrato in ServBay.

Prerequisiti

• ServBay installato e in esecuzione.
• Pacchetto Redis avviato in ServBay.
• DBeaver installato.

Connessione a Redis

1. Apri DBeaver.
2. Clicca su "Nuova connessione database".
3. Nella lista, cerca e seleziona "Redis". Clicca su "Avanti".
4. Inserisci i dati di connessione:
   • Host: 127.0.0.1 (oppure localhost)
   • Porta: 6379 (porta predefinita di Redis)
   • Password: Redis fornito di default da ServBay non ha password. Se hai configurato una password in ServBay, inseriscila qui.
5. Premi su "Testa connessione". Se ci sono problemi, verifica che Redis sia avviato su ServBay e che porta e password (se esistente) siano corretti.
6. Se il test riesce, clicca su "Fine".

Gestione base dei dati (Redis)

Collegato Redis, DBeaver offre un’interfaccia grafica per visualizzare e gestire chiavi e valori.

• Visualizzare le chiavi: Espandi la connessione nel navigatore, seleziona un database (solitamente DB 0) per vedere la lista delle chiavi.
• Aggiungere una chiave: Tasto destro sul nodo database o zona vuota della lista chiavi, seleziona "Crea nuova chiave", inserisci nome, tipo (String, List, Set, Hash, ZSet, ecc.) e valore.
• Modificare una chiave: Doppio click o tasto destro su una chiave esistente -> "Modifica chiave", cambia valore o TTL (Time To Live).
• Eliminare una chiave: Tasto destro sulla chiave, seleziona "Elimina chiave".
• Utilizzare la console Redis: Tasto destro sulla connessione/database -> "Editor SQL" -> "Nuova console Redis" per inserire e lanciare comandi Redis direttamente.

FAQ e risoluzione dei problemi

• Connessione rifiutata (Connection Refused):
  • Accertati che ServBay sia avviato.
  • Verifica che il servizio database desiderato (MariaDB/MySQL, PostgreSQL, Redis) sia stato avviato in ServBay e visualizzi stato verde.
  • Controlla che host e porta siano corretti (127.0.0.1 e porta di default: MariaDB/MySQL 3306, PostgreSQL 5432, Redis 6379).
  • Se usi Socket, assicurati che il percorso sia giusto e che il database sia configurato per utilizzarlo.
  • Verifica le impostazioni firewall per assicurarti che DBeaver possa comunicare sui port locali.
• Connessione riuscita ma autenticazione fallita:
  • Controlla che username e password inseriti siano corretti. Puoi trovarli o reimpostarli nella scheda Database di ServBay.
• Errore percorso file in connessione SQLite:
  • Assicurati che il percorso sia completo e corretto.
  • Verifica che DBeaver abbia permessi di lettura e scrittura sulla cartella.
• Interfaccia DBeaver incompleta o anomala:
  • Prova a riavviare DBeaver.
  • Assicurati che l’ambiente Java (su cui si basa DBeaver) sia funzionante.

Conclusioni

DBeaver è uno strumento potente e polivalente per la gestione dei database; in combinazione con l’ambiente di sviluppo locale ServBay, può aumentare sensibilmente la tua efficienza nel gestire diversi tipi di database. Seguendo questa guida puoi collegare agilmente DBeaver ai database MariaDB/MySQL, PostgreSQL, SQLite e Redis inclusi in ServBay e svolgere le comuni attività di sviluppo e amministrazione. Che tu debba consultare dati, modificarli, eseguire query SQL o occuparti di manutenzioni più avanzate, DBeaver ti offre un’esperienza unica e produttiva. Unito alla flessibilità di ServBay nella gestione degli ambienti, il tuo workflow locale diventerà ancora più fluido.