# Database

## Uso di database relazionali

### Introduzione

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.

### Preparazione

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;.

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.

### Amministrazione

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, &etc;. 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.

#### Creazione del database

È 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.

#### Creazione di tabelle

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 &devlist;. Vedere Creazione manuale del database per maggiori informazioni.

### Creazione di un database

Usando &kmymoney;, aprire o importare un file di dati esistente, o crearne uno nuovo. Poi selezionare la voce di menu File Salva come database. 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 OK per creare il database.

#### Tipo di 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;.

#### File (solo per SQLite)

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.

#### Nome del database (altri)

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.

#### Nome host

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.

#### Nome utente e password

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.

### Accedere ai dati

#### Organizzazione delle tabelle

Per accedere ai dati in &kmymoney;, utilizzare la voce di menu File Apri database. Si aprirà una finestra simile alla precedente.

Se hai creato il tuo database aprendo prima un file e selezionando quindi Salva come database, 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 File Salva come..., 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 | `kmmInstitutions.id` | `kmmAccounts.institutionId`
Contenimento tra conti | `kmmAccounts.id` | `kmmAccounts.parentId`
Transazioni e suddivisioni (vedere la nota 1) | `kmmTransactions.id` | `kmmSplits.transactionId`
Conti e suddivisioni | `kmmAccounts.id` | `kmmSplits.accountId`
Beneficiari e suddivisioni | `kmmPayees.id` | `kmmSplits.payeeId`
Pianificazioni e transazioni | `kmmSchedules.id` | `kmmTransactions.id`
Transazioni e valute | `kmmTransactions.currencyId` | `kmmCurrencies.ISOCode`
`Conti e titoli (vedere la nota 2)` | `kmmAccounts.currencyId` | `kmmSecurities.id`
Titoli e prezzi | `kmmSecurities.id` | `kmmPrices.fromId` o `kmmPrices.toId`
Tassi di cambio | `kmmCurrencies.ISOCode` | `kmmPrices.fromId` o `kmmPrices.toId`

Note:

1 – txType = “N” per le transazioni normali, “S” per le transazioni pianificate

2 – se kmmAccounts.isStockAccount = “Y”

#### Formato dei campi

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.

#### Aggiornamento dei dati

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!

#### Query memorizzate

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, &etc;, non si dovrebbero avere problemi.

### Creazione manuale del database

Questa sezione tratta l'utilizzo avanzato del database; la maggior parte degli utenti può evitare di leggerla.

#### Quando usarla

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 (&ie; con l'istruzione `CREATE DATABASE`). Una volta creata la banca dati, &kmymoney; dovrebbe essere in grado di creare le tabelle, &etc; nella procedura normale di salvataggio come base di dati, descritta sopra.

#### Generazione dei comandi SQL

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 Strumenti Genera SQL della base dati 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 Salva SQL. 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 Crea tabelle. È 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;.

#### Attenzione

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.

### Cifratura

La cifratura dei dati nel database non è attualmente supportata.