# Databas

## Använda relationsdatabaser

### Inledning

Sedan utgåva 1.0 tillåter &kmymoney; lagring av data i en relationsdatabas. En av fördelarna med att använda det branschstandardformatet är att det kan göra det möjligt att visa data med hjälp av ett av de grafiska gränssnitten som OpenOffice.org eller LibreOffice, eller kanske i något format som &kmymoney; för närvarande inte erbjuder. Dessutom bör lite kunskap om språket SQL (Structured Query Language, som används världen över för att komma åt relationsdatabaser) göra det lättare att exportera data till ett externt program, till exempel ett budgetprogram.

Även om de flesta relationsdatabassystem tillåter samtidig åtkomst till en databas av mer än en användare, är det inte möjligt med &kmymoney;. Även om &kmymoney; kan lagra data i en relationsdatabas, använder den faktiskt databasen bara som en annan typ av fillagring. När filen öppnas läser programmet all data från databasen. Under arbetar med data görs ändringarna endast i den interna lagringen; de skrivs inte omedelbart tillbaka i databasen. Först när data sparas skriver &kmymoney; hela filen tillbaka i databasen.

Det har förekommit förfrågningar om att &kmymoney; ska uppdatera databasen för varje dataändring, men det skulle kräva en betydande förändring av hur hela programmet hanterar sina interna datastrukturer, så det är extremt osannolikt att det kommer att ske inom överskådlig framtid.

### Förberedelse

För att komma åt databasen använder &kmymoney; SQL-modulen som tillhandahålls av &Qt; Software som en del av deras &Qt; programmeringssystem. Modulen stöder många databassystem genom en samling drivrutiner. &Qt; har drivrutiner för ett stort antal relationsdatabassystem med öppen källkod och proprietära relationsdatabassystem, inklusive MySQL, PostgreSQL och SQLCipher. Modulen stöder också några "tyngre", mer industriella system som Oracle och IBM DB2.

Tidigare versioner av &kmymoney; stödde SQLite. Det har ersatts med stöd för SQLCipher, vilket är en fristående gren av databasbiblioteket SQLite som lägger till 256-bitars AES-kryptering och andra säkerhetsfunktioner. Drivrutinen SQLCipher läser befintliga filer från SQLite. Se avsnittet nedan om SQLCipher för mer information.

Med undantag för SQLCipher använder systemen en klient/server-modell, där "klient"-programvaran finns på "din" dator, medan servern finns på samma dator som själva databasen, vilken kan finnas någon annanstans i ett nätverk. Naturligtvis, i det normala scenariot för ett personligt ekonomiprogram som &kmymoney;, kan "din" dator fungera som både klient och server. Den första uppgift, efter att ha bestämt vilket databassystem som ska användas, är därför att installera klient-, och troligtvis server-, programvaran.

Förutom själva databasprogramvaran måste också motsvarande &Qt;-drivrutinsmodul installeras. De flesta &Linux;-distributioner inkluderar drivrutinsmoduler för de mer populära databaserna. Annars kan du titta på &Qt;-programvarans webbplats och söka efter SQL drivers.

SQLCipher och SQLite fungerar inte på en klient/server-modell; varje databas lagras i en vanlig fil, lokal eller fjärransluten, som nås med de normala metoder som tillhandahålls av det underliggande operativsystemet. I det fallet finns det därför bara ett programpaket och drivrutinen att installera. Dessutom kanske en del av följande information, särskilt den som rör administration, inte gäller.

### Administration

Att hantera databaser är lite mer komplext än att hantera vanliga filer. Varje system har olika metoder för att utföra nödvändiga administrativa uppgifter, som att skapa databaser, tilldela behörigheter till olika användare eller skapa säkerhetskopior. Att beskriva uppgifterna ligger utanför ramen för den här handboken, men alla produkter som stöds tillhandahåller omfattande referensdokumentation, och en snabb sökning på webben kommer att leda dig till många handledningar i ämnet.

#### Skapa databasen

&kmymoney; innehåller SQL-kod för att skapa en initial databas för att lagra data om en sådan inte finns. Det rekommenderas dock starkt att skapa en databas i förväg, eftersom de flesta produkterna erbjuder ett antal alternativ som kan vara relevanta. Ett alternativ som kan vara av särskild betydelse för vissa är tilldelning av teckenuppsättningen (t.ex. UTF-8) som ska användas för textfält.

Vid denna tidpunkt måste du också ange rättigheter för diverse användare att utföra olika åtgärder med databasen. I de flesta system, blir användaren som skapar databasen automatiskt tilldelad fullständiga rättigheter, men det är ett område där man bör rådfråga dokumentationen.

För första gången databasen används, och ibland vid andra tillfällen när databasens layout ändras, behövs behörighet (även kallad privilegier) för att skapa och ändra tabeller och vyer (se nästa stycke). Det kan finnas olika namn på behörigheten/privilegiet i olika system, men något i stil med `CREATE` och `ALTER` borde vara vanligt förekommande. För normal körning behövs möjlighet att läsa och skriva poster; de definieras normalt i SQL som behörigheterna `SELECT`, `INSERT`, `UPDATE` och `DELETE`.

#### Skapa tabeller

Vid första användning försöker &kmymoney; skapa de nödvändiga tabellstrukturerna. För att uppnå maximal kompatibilitet mellan olika databastyper används endast en delmängd av vanliga datatyper. Det kan dock finnas situationer där en viss typ inte stöds, och för det fallet har möjligt att generera den SQL-kod som krävs för att skapa tabellerna lagts till. Koden kan sedan modifieras efter behov och användas för att skapa tabellerna utanför &kmymoney;. Om den situationen skulle uppstå är det vanligtvis möjligt att få hjälp från en av kanalerna som listas i avsnittet Skaffa hjälp. Se Skapa en databas för hand för mer information.

### Skapa en databas

Använd &kmymoney; för att öppna eller importera en befintlig datafil, eller skapa en ny. Välj sedan menyalternativet Arkiv Spara som databas. Välj SQL från kombinationsmenyn Lagringstyp som ska användas för data och klicka på Ok. Då visas följande dialogruta:

skapa en databas skapa en databas

Fyll i lämpliga fält för typen av databas du har valt (som vanligt är nödvändiga fält markerade) och klicka på Ok för att skapa databasen.

#### Databastyp

Kombinationsmenyn listar alla &Qt; SQL-drivrutiner som är installerade på systemet. Välj drivrutinen för databastypen. Om den du vill ha inte finns i listan måste du installera lämplig drivrutin. Se distributionsdokumentationen eller besök &Qt;-programvarans webbplats och sök efter 'SQL drivers'.

#### Fil (bara SQLite och SQLCipher)

SQLCipher har en databas per fil, så ange filnamnet som databasen ska skapas i. För att bläddra i filsystemet klicka på ikonen till höger om filnamnet. För databaser med SQLCipher är fälten Databasnamn, Värdnamn och Användarnamn inte relevanta. Filen i SQLCipher måste ha lämpliga läs- och skrivrättigheter inställda av det underliggande filsystemet för att möjliggöra lämplig åtkomst för den inloggade användaren.

Skaparna av SQLCipher släppte version 4.0 i november 2018. Många användare av &kmymoney;, särskilt de som inte uppgraderar särskilt ofta, eller som använder LTS (Long Term Support) &Linux;-distributioner, kan dock fortfarande använda en databas skapad med version 3 av SQLCipher. Vid någon tidpunkt, vanligtvis efter att ha uppgraderat &kmymoney; eller distributionen, upptäcker de att de inte kan öppna databasen, med ett fel som inte är särskilt informativt eller användbart. Det som krävs i det fallet är att uppgradera själva databasen från version 3 till version 4. Instruktioner för det finns på SQLCiphers webbplats.

#### Databasnamn (övriga)

Standardnamnet på databasen är `KMyMoney`, men du kan välja något annat namn om du vill. För vissa typer av databas, kanske &kmymoney; inte klarar av att skapa databasen, så den måste skapas i förväg genom att använda lämplig administrationsprocedur. &kmymoney; klarar dock oftast av att skapa alla tabellstrukturer när det behövs. Om inte, kan du skapa dem själv. Se Skapa en databas för hand för mer information.

#### Värddatornamn

För den genomsnittliga användaren är standardnamnet localhost, det vill säga den dator som för närvarande används, korrekt. För nätverksanslutna databaser ange den anslutna databasserverns värddatornamn.

#### Användarnamn och lösenord

Kontrollera inställda rättigheter för databasen, eller kontakta administratören av databasen, för riktiga värden att använda här. Användarnamnet måste ha möjlighet att välja, ta bort, infoga och uppdatera poster. Om användarnamnet är samma som inloggningsnamnet behövs i allmänhet inte något lösenord.

### Komma åt data

#### Tabellkonstruktion

För att komma åt data i &kmymoney;, använd menyalternativet Arkiv Öppna databas . Det öppnar en dialogruta som liknar den ovan.

Om du skapade databasen genom att först öppna en fil och sedan använda Arkiv Spara och välja SQL som beskrivits ovan, sparas alla efterföljande ändringar av data endast i databasen, inte i filen. Det betyder att filen kan användas som en säkerhetskopia eller ögonblicksbild av data vid en viss tidpunkt. För att göra en ny säkerhetskopia som denna, öppna databasen, välj menyalternativet Arkiv Spara som..., välj XML som lagringstyp och ange ett lämpligt filnamn. Kom ihåg att öppna databasen igen, så att &kmymoney; inte fortsätter att använda filen.

För att komma åt data på andra format, måste du känna till en del om hur den lagras i relationsdatabaser. Det allra enklaste sättet att få en känsla för det är att öppna databasen i ett gränssnitt som OpenOffice.org. Det tillhandahåller en lista med de olika tabellerna som utgör databasen, och gör det möjligt för dig att se layouten för var och en av dem.

För att extrahera data, t.ex., till ett kalkylblad eller en extern fil är det nästan alltid nödvändigt att välja länkade data från mer än en tabell. Det görs genom att sammanfoga tabellerna med hjälp av ett fält som är gemensamt för dem. Det finns mycket mer information om hur det görs i de ovan nämnda handledningarna för databaser på nätet. Följande tabell listar de fält som används för att definiera relationerna mellan tabeller.

Relation | Matchar | Med
Institutioner och konton | `kmmInstitutions.id` | `kmmAccounts.institutionId`
Överliggande konton och delkonton | `kmmAccounts.id` | `kmmAccounts.parentId`
Transaktioner och delningar (se anmärkning 1) | `kmmTransactions.id` | `kmmSplits.transactionId`
Konton och delningar | `kmmAccounts.id` | `kmmSplits.accountId`
Betalare och delningar | `kmmPayees.id` | `kmmSplits.payeeId`
Schemaläggningar och transaktioner | `kmmSchedules.id` | `kmmTransactions.id`
Transaktioner och valutor | `kmmTransactions.currencyId` | `kmmCurrencies.ISOCode`
`Konton och värdepapper (se anmärkning 2)` | `kmmAccounts.currencyId` | `kmmSecurities.id`
Värdepapper och kurser | `kmmSecurities.id` | `kmmPrices.fromId` eller `kmmPrices.toId`
Valutakurser | `kmmCurrencies.ISOCode` | `kmmPrices.fromId` eller `kmmPrices.toId`

Anmärkningar:

1 – txType = "N” för normala transaktioner, "S” för schemalagda transaktioner

2 – if kmmAccounts.isStockAccount = "Y”

#### Fältformat

Flera av datafälten lagras med ett internt format, vilket kanske inte är omedelbart användbart för externa program. I dessa fall, har informationen duplicerats med både internt och externt format.

Monetära belopp och aktievärden visas både i bråkformat och, med ett fältnamn med suffixet `Formatted` , i den form som vanligtvis anges.

På liknande sätt, anges fält som kontotyp både som en numerisk kod, och på programmets form och språk i ett fält som slutar med '`String`' (sträng)

#### Uppdatera data

Att ha data på ett industristandardformat ger möjlighet att ändra det utanför programmet &kmymoney;. GÖR INTE DET, om du inte verkligen vet vad du gör, och försäkra dig alltid om att först skapa en säkerhetskopia av data. Om du gör fel, kanske &kmymoney; inte kan komma åt data, och du kan till och med bli av med det helt och hållet. Du har fått en varning.

#### Lagrade förfrågningar

De flesta databassystem låter dig lagra ofta använda förfrågningar och procedurer, och i vissa fall kan de lagras som tabeller i själva databasen. Som du kanske gissat från det ovanstående, börjar alla tabeller som &kmymoney; använder med '`kmm`', med små bokstäver. Den standarden kommer att upprätthållas, och bara tabeller som börjar med dessa bokstäver kommer att uppdateras. Under förutsättning att du undviker dessa när du namnger förfrågningar, etc., bör du sålunda inte uppleva några problem.

### Skapa en databas för hand

Det här avsnittet beskriver mer avancerad användning av databaser, och kan hoppas över av vanliga användare.

#### När det bör användas

Det kan finnas tillfällen då &kmymoney; inte klarar av att skapa databasen automatiskt, eller skapar den utan vissa alternativ som krävs av användaren. Exempelvis kanske inte databassystemet som används är fullständigt anpassat för vanlig användning av SQL, eller stöd kan ha lagts till för nya system som inte har utprovats fullständigt i &kmymoney;.

Innan funktionen används, bör du försöka att skapa själva databasposten själv (dvs. med satsen `CREATE DATABASE`). Under förutsättning att databasen finns, kan &kmymoney; mycket väl klara av att skapa tabeller, etc. med den normala proceduren för att spara i en databas, som beskrivs ovan.

#### Skapa SQL-koden

Om det misslyckas är det möjligt att generera de grundläggande SQL-kommandon som behövs för att skapa de olika tabeller, vyer och index som krävs av programmet. Välj menyalternativet Verktyg Generera SQL för databas . Det visar följande dialogruta:

generera SQL för att skapa en databas generera SQL för att skapa en databas

När typ av databas väljes, visas lämplig SQL i textrutan SQL för att skapa databas. Den kan redigeras av användaren, eller sparas i en textfil genom att klicka på Spara SQL. I det senare fallet, måste databasen skapas med de administrativa funktionerna som tillhandahålls av databassystemet.

Om du vill att &kmymoney; ska skapa databasen efter att du har redigerat texten i dialogrutan, måste fylla i övriga fält i dialogrutan, som beskrivs under Skapa en databas ovan, och klicka på Skapa tabeller. Observera att utom för fallet med SQLite, måste du antingen inkludera en lämplig `CREATE DATABASE`-sats som första kommando, eller tidigare ha utfört ett sådant kommando utanför &kmymoney;.

#### Varning

Du bör vara mycket försiktig när du redigerar definitionerna för någon av de grundläggande tabellerna eller vyerna (de med namn som börjar med '`kmm`'). Vissa ändringar, som att öka längden på ett heltalsfält, kan ha liten inverkan, men du bör inte ta bort eller ändra följden av några fält, annars kan &kmymoney; vägra fungera, eller skada data.

Även om prestanda kan förbättras genom att lägga till eller ta bort index, bör man också vara medveten om att det motsatta kan inträffa. Viss kunskap om &kmymoney;s interna funktion kan hjälpa till att få bästa möjliga prestanda under sådana omständigheter.

### Kryptering

Kryptering av data i databasen stöds för närvarande inte.