Klant Query Server: verschil tussen versies

Er zijn twee schema's beschikbaar op de queryserver: public en vcs. In het vcs schema wordt alle bi- en bron-data neergezet, zodat de ValueCare data beschikbaar is. Deze data worden elke dag ververst, zodat het elke dag overeen komt met de data op de Productie-omgeving. Als u op schema vcs een eigen tabel zou aanmaken, wordt deze verwijderd tijdens de verversing. Om met eigen tabellen te werken, is het public-schema beschikbaar. De tabellen die hierop staan, blijven beschikbaar op de Queryserver. Hoe u data overzet van schema vcs naar schema public leest u hieronder.

=== '''Van een dashboard of tegel naar de juiste tabel op de Queryserver''' ===

Om te begrijpen welke tabellen op de queryserver onderliggend zijn aan de tegels en dashboards die zichtbaar zijn in het portaal is de tabel bi_queryserver_tegels_en_dashboards beschikbaar. Hierin kan je zien welke tabellen worden gebruikt in een tegel en/of dashboard. In onderstaand voorbeeld, zie je dus dat voor de tegel ‘Waarde verblijfsdagen per maand’, die te vinden is in dataset ‘Verblijf ZPM’, de onderliggende tabel ‘bi_zis_verblijf_zpm’ is. Tabel bi_zis_verblijf_zpm is dan te vinden op de queryserver.

Daarnaast kan je vanuit het portaal ook het filter paginanaam gebruiken. Als je deze toevoegt vanuit [+ nieuw filter] onderaan de linker balk met filters, dan zie je ook welke tabellen er gebruikt worden voor het opstellen van de tegel en/of dashboard.

De logica achter de benaming van tabellen op de queryserver is hieronder weergegeven.

|Alle tabellen die wij direct vanuit een bron ophalen krijgen het voorvoegsel src_. Dit zijn  dus tabellen vanuit bronnen, zoals XMCare, MijnQuarant, Beaufort, QuestManager,  etc. Ook bestanden die we ophalen vanaf een SFTP server of andere bronnen,  krijgen dit voorvoegsel.

|Alle tabellen die gebruikt worden voor het samenstellen van dashboards en tegels hebben het  voorvoegsel bi.  

=== '''Connectie opzetten''' ===

#* Het kan ook zijn dat de queryserver lokaal gehost wordt, in dat geval is de hostname doorgaans te achterhalen bij de ICT-afdeling

# Vraag om de username en password bij jouw ValueCare contactpersoon.

#* De Queryserver beschikt over een postgres database, dus het poortnummer is de standaard postgres poort (5432)

Er zijn tal van goede programma's die u kunt gebruiken om te querieën op de Queryserver. Mits u gebruik maakt of wilt maken van DBeaver om op de Queryserver te querieën, dan vindt u hieronder een aantal instructies en een aantal tips & tricks die het gebruik van DBeaver nog fijner maken.

* Via <nowiki>https://dbeaver.io/download/</nowiki> kan je DBeaver downloaden

* Met de standaard instellingen van de installatie kan je prima op de Queryserver komen, maar voel je vrij om de instellingen naar wens aan te passen.

# Vul juiste naam voor de Database in

'''Overzicht van de functie-toetsen'''

Templates zijn erg handig in DBeaver. Hiermee kan je veelgebruikte queries opslaan en hoef je die niet volledig te typen, als je ze de volgende keer wil gebruiken. Bijvoorbeeld: In plaats van ‘SELECT * FROM table_name;’, type je enkel ‘saf’ en druk je op tab.

Om een template aan te maken ga je naar: Window > Preferences > SQL Editor > Templates > New.

''Name'': de combinatie aan woorden of letters die jij wil typen in plaats van de query

''Pattern'': de query die moet verschijnen als je de Name typt en op Tab drukt.

''Insert variable'': Hiermee kan je een bepaalde variabele aanroepen nadat je het template gebruikt. Bijvoorbeeld, SELECT * FROM '''${table}'''; zorgt ervoor dat je makkelijk een bestaande tabel kan selecteren als je het template gebruikt.

Je kunt een extensie installeren waarmee je direct Excels kunt downloaden. Dus niet eerst csv-bestanden die nog met de hand geconverteerd moeten worden. Volg de stappen in de link 'extensie installeren'.

Onder Path kies je een map waarin je alle .csv-bestanden naar gaat zetten. Klik op Finish.

Alle csv's die je in de map die je hierboven getypt hebt plaatst, zijn dan beschikbaar om op te queryen.

In de Driver Properties kun je onder seperator instellen wat het scheidingsteken is.

Een export doe je door in een Resultset met de Rechtermuisknop op 'Export data ...' te klikken. Als u wil dat de file-name automatisch de databasenaam, tabelnaam, en/of een timestamp bevat, kan je dat doen door het volgende te doen.

Bij Export data ... > Output (stap 4) > File name pattern, kan je de naam van de te exporteren file bepalen. Als je daarin gebruik maakt van onderstaande variabelen, krijgt de export automatisch de naam van de betreffende variabele.