Configurazione iniziale¶
Dopo una corretta installazione, organizzazioni più complesse vorranno configurare il loro database e configurare Ghini secondo la loro configurazione del database. Questa pagina si concentra su questo compito. Se non hai idea di cosa si tratti, meglio continuare la lettura con la parte relativa a SQLite.
E se fosse SQLite?¶
Questa è la prima volta che si utilizza Ghini, sono stai andando a lavorare in un ambiente autonomo, avete non la più pallida idea come gestire un sistema di gestione di database? Se avete risposto sì a uno qualsiasi dei precedenti, è probabilmente meglio restare con SQLite, il database facile, veloce, senza doveri di amministrazione, tutto basato su file, il database più diffuso al mondo.
Con SQLite non c’è bisogno di preparare altro e si può proseguire con connecting.
D’altra parte, se si desidera collegare più di una workstation ghini allo stesso database o se si desidera rendere disponibili i dati per altri client, come potrebbe essere un server web in una configurazione LAMP, è consigliabile mantenere il database in un database management system come PostgreSQL o MySQL/MariaDB, entrambi supportati da Ghini.
When connecting to a database server as one of the above, you have to
manually do the following: Create at least one user; Create your database;
Give at least one user full permissions on your database; If you plan having
more database users: Give one of your users the CREATEROLE
privilege;
Consider the user with the CREATEROLE
privilege as a super-user, not
meant to handle data directly; Keep your super-user credentials in a very
safe place.
When this is done, Ghini will be able to proceed, creating the tables and importing the default data set. The process is database-dependent and it falls beyond the scope of this manual.
Se già vi tremano le ginocchia, non c’è bisogno di preoccuparsi, basta restare con SQLite, senza perdere in funzionalità né prestazioni.
Some more hints if you need PostgreSQL
Start simple, don’t do all at the same time. Review the online manual, or download and study the offline version.
As said above, create a database, a user, make this user the owner of the database, decide whether you’re going to need multiple users, and preferably reserve a user for database and normal user creation. This super-user should be your only user with
CREATEROLE
privilege.All normal users will need all privileges on all tables and sequences, something you can do from the open an issue about it.
menu. If you have any difficulty, pleaseConnect using the
psql
interactive terminal. Create a~/.pgpass
file (read more about it in the manual), tweak yourpg_hba.conf
andpostgresql.conf
files, until you can connect using the command:psql <mydb> --username <myuser> --no-password --host <mydbhost>With the above setup, connecting from ghini will be an obvious task.
Connettersi ad una base dati¶
All’avviare Ghini, la prima cosa che appare è la finestra per la scelta della connessione.
Abbastanza naturalmente, la prima volta che si avvia Ghini non ci saranno connessioni a disposizione. Ghini mostra una finestra di avviso.
Questo avviso vi mostrerà alla prima attivazione e anche in futuro se il tuo elenco di connessioni diventa vuota. Come l’avviso stesso dice: fare clic su aggiungere per creare la prima connessione.
Semplicemente: inserire un nome per la connessione, una cose semplice e significativa che si associ naturalmente alla collezione che si vuol inserire (che so, «alberi monumentali»), e scegliere OK. Ghini torna allo schermo precedente, ma il nome della connessione sarà selezionato e la sezione Dettagli della Connessione sarà visibile.
specificare i dettagli della connessione
Se non si conosce cosa fare qui, Ghini vi aiuterà a stare al sicuro. Attivare il utilizzare la casella di controllo posizioni di predefinito e creare il tuo primo collegamento facendo clic su Connect.
Si può tranquillamente ignorare il resto di questa sezione per il momento e continua a leggere la sezione seguente.
mettere a punto i dettagli di connessione
Per impostazione predefinita Ghini utilizza SQLite database basato su file. Durante il processo di installazione si aveva la scelta (e avete ancora dopo l’installazione), per aggiungere connettori di database diverso da quello predefinito SQLite.
In questo esempio, Ghini può connettersi a SQLite, PostgreSQL e MySQL, ma nessun connettore è disponibile per MS SQL Server o Oracle.
Se si utilizza SQLite, è davvero necessario specificare solo il nome di connessione. Se permetti che Ghini utilizzi il nome file predefinito, Ghini crea un file di database con lo stesso nome come la connessione ed estensione .db
e una cartella di immagini ancora con lo stesso nome ma senza estensione, entrambe in ~/.bauble
su Linux/MacOSX o in AppData\Roaming\Bauble
su Windows.
Ancora con SQLite, si potrebbe avere ricevuto o scaricato un database bauble, e si desidera connettersi ad esso. In questo caso non lasciate Ghini utilizzare il nome file predefinito, ma navighi nel vostro computer nel percorso dove è stato salvato il Ghini SQLite database file.
Se si utilizza un connettore diverso database, finestra di dialogo avrà un aspetto diverso e vi offrirà l’opzione di mettere a punto tutti i parametri necessari per connettersi al database di vostra scelta.
If you are connecting to an existing database you can continue to Inserire e modificare dati and subsequently searching-in-ghini, otherwise read on to the following section on initializing a database for Ghini.
Se si prevede di associare immagini alle piante, specificare anche il * cartella radice * immagini. Il significato di questo è spiegato in dettaglio a: ref: “pianta-immagini” in: ref: “editing-e-inserimento-dati”.
A sample SQLite database
Indeed we have a sample database, from our pilot garden «El Cuchubo», in Mompox, Colombia. We have a zipped sample database for ghini-1.0.
Download and unzip it to the location of your choice, then start Ghini, create a connection named possibly
cuchubo
, orsample
, and edit the Connection Details. Keep the connection type at the default SQLite, but instead of using the default locations, make sure that Filename points to your unpackedcuchubo.db
file.
Inizializzare la base dati¶
La prima volta che si apre una connessione ad una base dati che Ghini non ha mai utilizzato prima, Ghini mostrerà l’avviso:
seguito a ruota da una domanda:
Fare attenzione quando si specificano manualmente i parametri di connessione: i valori immessi possono riferirsi a un database esistente, non destinato all’uso con Ghini. Permettendo a Ghini di inizializzare il database, questo sarà svuotato e tutto il suo contenuto verrà perso.
Se sei sicuro di voler creare un database con questi parametri seleziona «Sì». Ghini inizierà quindi col creare le tabelle del database e procederà con l’importazione di dati predefiniti. Questo può richiedere un minuto o due: prego pazientare mentre tutti i dati predefiniti vengono importati.
Una volta creata, configurata, inizializzata la base dati, siamo pronti per iniziare a editing-and-inserting-data`ed in seguito :ref:`searching-in-bauble.