DatabaseIndice
Fin dalla versione 1.0, KMyMoney permette di conservare i propri dati in un database relazionale. Uno dei vantaggi dell'uso di questo formato comune è che ti consente di visualizzare i dati usando l'interfaccia grafica di programmi come OpenOffice.org™ o LibreOffice™, magari in formati che KMyMoney ancora non fornisce. Inoltre, una conoscenza di base di SQL (Structured Query Language, il linguaggio usato comunemente per accedere ai database relazionali) dovrebbe consentirti di esportare più facilmente i dati verso programmi esterni come, ad esempio, applicazioni per la redazione di budget.
Per accedere al database, KMyMoney usa il modulo SQL fornito da Qt™ Software come parte del loro sistema di programmazione Qt™. Questo modulo supporta diversi sistemi di database, attraverso una serie di driver. I più famosi tra i sistemi open-source supportati sono MySQL™, SQLite (solo versione 3 e successive), e PostgreSQL. Questo modulo supporta anche i sistemi «più pesanti», industriali, come Oracle® e DB2® di IBM.
Con l'eccezione di SQLite, questi sistemi usano un modello client/server, in cui il programma «client» viene eseguito sul proprio computer e il «server» viene eseguito nel computer che contiene il database stesso, che potrebbe essere un altro computer connesso in rete. Ovviamente, nell'uso normale di questa funzione in KMyMoney, il computer in uso agisce sia da client sia da server. Il primo passo quindi, dopo aver deciso il sistema da usare, consiste nell'installazione del programma client e, probabilmente, anche di quello server.
Oltre al programma stesso di gestione della base dati, è necessario installare anche il modulo di Qt™ con il driver corrispondente. La maggior parte delle distribuzioni include i moduli dei driver per le basi dati più comuni. Altrimenti, cercare «SQL drivers» nel sito web di Qt™.
Nota
SQLite non usa un modello client/server; ogni database è memorizzato in un file, locale o remoto, a cui accede attraverso i metodi comuni forniti dal sistema operativo. In questo caso, quindi, c'è da installare un solo programma oltre al driver. Alcune delle informazioni seguenti, in particolare quelle relative all'amministrazione, potrebbero non essere applicabili a SQLite.
L'amministrazione dei database è più complessa di quella dei file normali. Ogni sistema ha un modo diverso di eseguire le operazioni di amministrazione, come la creazione di database, l'assegnazione di permessi agli utenti, la creazione di copie di sicurezza, ecc.. Questo documento non ha come obiettivo la descrizione di queste operazioni, ma ognuno dei sistemi supportati fornisce una documentazione completa, e basterà una breve ricerca su Internet per trovare queste informazioni.
È stato aggiunto del codice per creare un database iniziale per memorizzare i dati, se non ne esiste già uno. Comunque, si raccomanda vivamente di creare manualmente un database, perché molti di questi sistemi permettono di fornire delle opzioni importanti. Una che potrebbe essere particolarmente importante è l'impostazione della codifica (ad esempio UTF-8) usata per i campi di testo.
Attualmente, è anche necessario specificare i permessi per i vari utenti relativi alle operazioni consentite sul database. Nella maggior parte dei sistemi vengono assegnati tutti i privilegi all'utente che crea il database, ma è meglio controllare nella documentazione.
Per usare per la prima volta il database, e in altri casi in cui cambia l'organizzazione del database, sono necessari i permessi (chiamati anche privilegi) di creazione e modifica di tabelle e visualizzazioni (vedere il paragrafo successivo). I vari sistemi possono chiamare i privilegi in modi diversi, ma CREATE e ALTER dovrebbero essere comuni a tutti. Per l'utilizzo normale, è necessario essere in grado di leggere e scrivere record; questi permessi sono normalmente chiamati SELECT, INSERT, UPDATE, e DELETE in SQL.
Al primo utilizzo, KMyMoney proverà a creare la struttura di tabelle necessaria. Per poter ottenere la massima compatibilità con i vari sistemi di database, vengono usati solo alcuni dei tipi di dato comuni. Comunque, ci potrebbero essere situazioni in cui un certo tipo non è supportato e, in questo caso, viene fornito il codice SQL necessario alla creazione di tabelle. Questo codice può essere modificato come richiesto e usato per la creazione delle tabelle al di fuori di KMyMoney. Se ci si trova in questa situazione, è possibile ottenere aiuto dalla lista di distribuzione (kmymoney-devel kde.org). Vedere Creazione manuale del database per maggiori informazioni.
Usando KMyMoney, aprire o importare un file di dati esistente, o crearne uno nuovo. Poi selezionare la voce di menu → . Si aprirà la finestra seguente:
Completa i campi appropriati per il tipo di database selezionato (come al solito, i campi obbligatori saranno evidenziati) e fai clic su per creare il database.
Questa casella elenca i driver Qt™ per SQL installati sul proprio sistema. Selezionare il driver relativo al tipo di database utilizzato. Se non viene elencato il driver desiderato, è necessario installarlo. Vedere la documentazione della distribuzione, o cercare «SQL drivers» nel sito web di Qt™.
SQLite ha un database per file, quindi inserire il nome del file in cui creare il database. Per sfogliare le cartelle, fare clic sull'icona a destra del nome del file.Per i database SQLite, i campi Nome host, Nome utente e Password non sono rilevanti. Il file SQLite deve avere i corretti permessi in lettura/scrittura, impostati dal sistema operativo, per permettere l'accesso all'utente corrente.
Il nome predefinito del database è KMyMoney, ma è possibile sceglierne un altro se si desidera. Per alcuni tipi di database, KMyMoney non è in grado di creare il database, quindi è necessario crearlo in precedenza con la relativa procedura di amministrazione. Comunque, KMyMoney creerà le strutture delle tabelle, se necessario. È possibile anche crearle manualmente, vedere Creazione manuale del database per maggiori informazioni.
Comunemente va bene il nome predefinito («localhost»), che si riferisce al computer in uso. Per l'uso di database in rete, inserire il nome dell'host.
Per sapere i valori da utilizzare controllare i permessi impostati nel database, o contattare l'amministratore del database. Il nome utente inserito deve avere i permessi di selezione, di inserimento, di modifica e di cancellazione sui record. Se il nome utente è quello in uso nel computer, spesso la password non è richiesta.
Per accedere ai dati in KMyMoney, utilizzare la voce di menu → . Si aprirà una finestra simile alla precedente.
Nota
Se hai creato il tuo database aprendo prima un file e selezionando quindi , come descritto sopra, ogni successiva modifica ai tuoi dati sarà memorizzata solo nel database, non nel file. Ciò significa che puoi utilizzare il file come una copia di sicurezza o istantanea dei tuoi dati a una certa data. Per fare una nuova copia di sicurezza come questa, apri il tuo database, seleziona → , indicando un nome appropriato per il file. Ricordati di riaprire quindi il tuo database, così che KMyMoney non continui a usare il file.
Per accedere ai dati in altri formati, è necessario conoscere i dettagli con cui vengono memorizzati nei database relazionali. Il modo migliore di capirlo è aprire il database in un programma come OpenOffice.org™. Sarà visualizzata un elenco delle tabelle che compongono il database, e si potrà vedere la loro struttura.
Per estrarre dati, ad esempio in un foglio di calcolo o in un file esterno, è quasi sempre necessario selezionare dati correlati da più tabelle, Questo viene fatto «associando» le tabelle usando un campo comune. È possibile trovare sul web maggiori informazioni sull'associazione delle tabelle. La tabella seguente elenca i campi usati per definire queste relazioni tra le tabelle.
|
Relazione |
Campo |
Campo corrispondente |
|---|---|---|
|
Istituti e conti |
|
|
|
Contenimento tra conti |
|
|
|
Transazioni e suddivisioni (vedere la nota 1) |
|
|
|
Conti e suddivisioni |
|
|
|
Beneficiari e suddivisioni |
|
|
|
Pianificazioni e transazioni |
|
|
|
Transazioni e valute |
|
|
|
|
|
|
|
Titoli e prezzi |
|
|
|
Tassi di cambio |
|
|
Note:
1 – txType = “N” per le transazioni normali, “S” per le transazioni pianificate
2 – se kmmAccounts.isStockAccount = “Y”
Diversi campi dati sono memorizzati in un formato interno che potrebbe non essere immediatamente utilizzabile da altri programmi. In questi casi, le informazioni sono duplicate in formati interni ed esterni.
Gli importi monetari e i valori delle azioni sono visualizzati sia nel formato numeratore/denominatore e, in un campo il cui nome termina con Formatted, nella forma visualizzata sullo schermo.
In modo simile, alcuni campi, come il tipo di conto, sono memorizzati sia come codice numerico sia in un campo il cui nome termina con String usando il formato e la lingua del programma.
Avere i dati in un formato standard dà la possibilità di modificarli con un programma esterno. NON FARLO a meno che non si sappia veramente quello che si sta facendo, e fare sempre una copia di sicurezza dei dati prima della modifica. Se si sbaglia, KMyMoney potrebbe non essere più in grado di accedere ai dati, e si potrebbe persino perderli tutti. Sei stato avvisato!
La maggior parte dei sistemi di database permette di memorizzare le query e le procedure utilizzate più spesso; in alcuni casi, potrebbero essere memorizzate come tabelle o altri oggetti nel database stesso. Come si può intuire dalla tabella sopra, tutte le tabelle usate da KMyMoney iniziano con le lettere minuscole kmm. Questo standard sarà mantenuto, e verranno aggiornate solo le tabelle che iniziano con queste lettere. Quindi, se si evitano queste lettere nei nomi delle query, ecc., non si dovrebbero avere problemi.
Nota
Questa sezione tratta l'utilizzo avanzato del database; la maggior parte degli utenti può evitare di leggerla.
Ci sono casi in cui KMyMoney non riesce a creare automaticamente un database, o lo crea senza utilizzare delle opzioni richieste dall'utente. Ad esempio, il sistema di database in uso potrebbe non rispettare completamente lo standard SQL, o non essere stato testato completamente con KMyMoney.
Prima di usare questa funzione, si dovrebbe provare a creare la banca dati stessa (cioè con l'istruzione CREATE DATABASE). Una volta creata la banca dati, KMyMoney dovrebbe essere in grado di creare le tabelle, ecc. nella procedura normale di salvataggio come base di dati, descritta sopra.
Se non riesce, è possibile generare i comandi SQL di base necessari per creare le varie tabelle, viste e indici richiesti dall'applicazione. Selezionare la voce di menu → dal menu. Si aprirà la seguente finestra:
Selezionando il tipo di database, apparirà il codice SQL corrispondente nella casella di testo SQL per la creazione; può essere modificato dall'utente o salvato in un file di testo facendo clic sul pulsante . In quest'ultimo caso, si deve creare database usando le funzioni di amministrazione fornite dal sistema di database.
Se, dopo aver modificato il testo nella finestra, si vuole che KMyMoney crei il database, è necessario completare gli altri campi della finestra, come descritto sopra nel capitolo Creazione di un database, e fare clic su . È bene notare che, a parte nel caso di SQLite, bisogna aggiungere un'istruzione CREATE DATABASE come primo comando, se non si è già eseguito questo comando all'esterno di KMyMoney.
Bisogna stare molto attenti nella modifica delle definizioni delle tabelle e delle viste di base (quelle i cui nomi iniziano con kmm). Alcune modifiche, come l'aumento della lunghezza di un campo intero, possono non creare danni, ma non si dovrebbe rimuovere o modificare l'ordine dei campi, altrimenti KMyMoney potrebbe non funzionare più o danneggiare i dati.
L'aggiunta e la rimozione di indici potrebbero migliorare le prestazioni, ma potrebbe accadere anche l'opposto. In questi casi, conoscere il funzionamento interno di KMyMoney può aiutare a ottenere le massime prestazioni.