SQL Analytics - Produktblad

Produktblad för Kleers SQL-lösningar: vad SQL Analytics är, hur man ansluter till databasen och vilka restriktioner som gäller.

Detta produktblad kompletterar databasdokumentationen och vänder sig till dig som vill få en översikt av Kleers SQL-lösningar. Här får du en introduktion till tjänstens innehåll samt vägledning för hur du enkelt kommer igång.

Vad är SQL Analytics?

SQL Analytics är en tilläggstjänst i Kleer som ger användare direkt åtkomst till sin egen databas. Med ett standardiserat SQL-gränssnitt kan du enkelt skapa egna rapporter och hämta ut data efter behov.

Vad är en databas och vad är SQL?

En databas är en struktur för att lagra rådata i form av tabeller, där varje tabell har ett namn, kolumner och rader med olika typer av information.

SQL (Structured Query Language) är ett språk som används för att hämta och bearbeta data ur databasen på ett organiserat sätt. Med SQL kan man kombinera tabeller, göra beräkningar, filtrera innehåll och tillämpa egen logik — vilket gör det möjligt att skapa dynamiska, skräddarsydda rapporter som uppdateras i realtid.

Vad behöver man för att komma igång?

För att kunna ansluta till databasen behöver man:

Användarnamn, ex: user_1_2 (user_userID_companyID)
Lösenord (token)

Prata med din ansvariga konsult på Kleer om du vill ansluta till tjänsten.

Kleer kommer att behöva en IP-adress från användaren som ska ansluta.

Hur ansluter man till databasen?

Det finns två sätt att etablera en anslutning till databasen:

Direkt anslutning (IP-adress)
SSH-tunnel

Anslutningsinformation vid direkt anslutning (IP-adress):

Hostname: data.kleer.se
Port: 3306

Anslutningsinformation vid SSH-tunnel:

Hostname: localhost
Port: 3306

SSL-certifikat

Alla anslutningar till SQL Analytics måste vara krypterade. Det kan lösas på ett av två sätt:

Anslut direkt mot databasen på data.kleer.se:3306 och använd MySQLs inbyggda SSL-stöd. För att detta ska fungera behöver du ladda ner och installera Kleers publika CA-certifikat.
Anslut först via SSH till data.kleer.se och skapa därefter en tunnel mot localhost:3306. I detta fall används inte SSL i MySQL, eftersom anslutningen redan är krypterad via SSH.

Direkt anslutning

Om möjligt rekommenderar vi en direkt end-to-end-anslutning till databasen genom en MySQL-kompatibel klient, till exempel MySQL Workbench.

SSH-tunnel

Om man inte har möjlighet att ansluta från en fast IP-adress, men ändå vill säkerställa en trygg anslutning till databasen, kan man använda en SSH-tunnel. Denna metod bygger på ett nyckelpar — en privat och en publik nyckel. Användaren behåller den privata nyckeln lokalt på sin dator, medan den publika nyckeln delas med Kleer. Genom att upprätta en SSH-tunnel mellan användarens dator och Kleer skapas en krypterad och säker anslutning mot databasen. Läs mer i How to set up ODBC Plugin for Excel and SQL Analytics.

Egna rapporter

Vid aktivering av SQL Analytics finns möjlighet att även slå på gränssnittsfunktionen “Egna rapporter”. Det är ett användarvänligt SQL-gränssnitt som är integrerat direkt i Kleer. Med den här funktionen kan du skapa anpassade SQL-rapporter direkt i verktyget, där parametrar och behörigheter kan användas för att skräddarsy rapporterna efter olika behov.

Navigera databasen

En uppdaterad lista över alla tillgängliga tabeller finns i den allmänna databasdokumentationen (tillgänglig för nedladdning när du är inloggad i Kleer). Utöver detta finns ett kompletterande dokument som innehåller exempel och förklaringar särskilt anpassade för Kleer-kunder som vill fördjupa sig i SQL Analytics.

Specialanpassade rapporter/widgets

Teknisk support på Kleer kan bistå med att ta fram SQL-skript för skräddarsydda rapporter åt våra kunder. Detta erbjuds som ett beställningsuppdrag, där kravställningen tas fram i samråd med kundens redovisningskonsult, teknisk support och kunden själv. Läs mer i Rapporter & Widgets – Beställningsjobb.

Widgets i Kleer

I gränssnittet kan SQL-rapporter visualiseras som widgets på dashboarden, vilket gör det enkelt att presentera och följa upp data på ett överskådligt sätt. Läs mer i Hur man skapar egna widgets i Kleer.

Restriktioner

Databasen som är tillgänglig i SQL Analytics motsvarar inte hela Kleers databas, utan består av så kallade vyer. Dessa vyer innehåller utvalda och relevanta delar av databasen, sammanställda för att förenkla användningen och minska komplexiteten. Databasen uppdateras kontinuerligt, och nya tabeller och kolumner läggs till vid behov.
Varje användare är begränsad till högst 10 samtidiga anslutningar och kan köra upp till 3 600 SELECT-frågor per timme.
Användare har enbart läsbehörighet till databasen i SQL Analytics. Det innebär att det inte är möjligt att använda kommandon som UPDATE eller DELETE — data kan enbart läsas, inte ändras eller raderas.

Att tänka på

En databasanvändare behöver minst behörighetsnivån “Full läsbehörighet” och “Läsa alla löner”. Detta innebär att en anslutning till Kleers databas kommer ge användaren access till alla löner i bolaget.
Monetära summor noteras i “ören” som heltal. Dessa behöver därmed divideras med 100 för att få beloppen i decimalform. Exempel: om currency = "SEK" och amount = 125000, så är beloppet 1 250 SEK.
SQL-access är begränsad till ett företag per anslutning. För moderbolag finns dock möjlighet att ge access även till underliggande dotterbolag som är registrerade i Kleer. Det innebär att bolagsöverskridande rapporter, såsom koncernrapporter, kan skapas via en och samma anslutning.
Databasen är begränsad till vad som är exponerat. Generellt sett är tanken att all data som man kan se i Kleers gränssnitt ska gå att komma åt via SQL Analytics. Men all data är inte exponerad i dagsläget — nytt innehåll exponeras vid behov.

Har du frågor om vad som finns exponerat och i så fall hur? Prata med din konsult eller mejla teknik@kleer.se.