Let op
Deze pagina gaat over OnsDB 4. Vanaf 1 mei 2027 is OnsDB versie 5 de minimaal vereiste versie. Eerdere versies van OnsDB werken vanaf die datum niet meer. Zorg daarom dat je vóór 1 mei 2027 bent overgestapt op versie 5 of hoger. Voor meer informatie over het overstapen naar versie 5 van OnsDB, bekijk hier de migratie gids.
Structureel gebruik van OnsDB (met achterliggende tooling)
Het is raadzaam om in een dergelijk geval voor de volgende configuratie te kiezen:
Soort data:
Zet met de schema-version parameter de structuur van de data die je wilt ophalen vast. Om te voorkomen dat ongewenste data opgehaald wordt, is het raadzaam om de ondersteuning van datamodellen te bestuderen.
Kies ervoor om alleen de gewenste tabellen op te halen door middel van de include en exclude parameters. Dit zorgt ervoor dat de OnsDB run sneller verloopt en dat de lokale database minder belast of vervuild wordt met gegevens die niet gebruikt worden. Daarnaast is de kans op irrelevantie foutmeldingen in de log kleiner.
Stel een beperkte periode in door middel van de start en end parameters. Als het bijvoorbeeld niet nodig is om zorgregels op te vragen die ouder zijn dan een aantal dagen/weken/maanden/jaren, laat deze dan buiten beschouwing. Deze parameters hebben op een beperkt aantal, maar grote, tabellen invloed. Dit heeft dezelfde voordelen als het vorige punt.
Interval:
Gezien het repeterende karakter van het ophalen van gegevens, is het raadzaam om deze als automatische taak in Windows te plannen met behulp van de "task scheduler". Selecteer hierbij bij het instellen van programma het OnsDB-batch bestand.
Daarnaast is het aan te raden om de schermoutput naar een bestand te schrijven, zodat het op een later tijdstip geraadpleegd kan worden in geval van problemen bij het ophalen van data. Om schermoutput naar het bestand te schrijven kan het volgende commando aangeroepen worden via het batchbestand:
cmd/c onsdb.exe onsdb.cfg >> CMDoutput_%date:~-4,4%%date:~-7,2%%date:~-10,2%.txt 2>&1
Dit genereert een bestand met naam CMDouput_[huidigedatum].txt. Indien er meerdere runs op een dag lopen, worden deze aangevuld in hetzelfde bestand.
Op elke dinsdagavond kunnen er tussen 19:00 en 22:00 uur onderhoud en updates worden uitgevoerd aan onze systemen en infrastructuur. Als dit gebeurt op het moment dat een OnsDB-run wordt gedaan, kan dit betekenen dat de OnsDB-run mislukt. Plan daarom automatische runs op dinsdag pas na 22:00 uur.
Incidenteel gebruik van OnsDB (zonder achterliggende tooling)
Het is raadzaam om in een dergelijk geval voor de volgende configuratie te kiezen:
Soort data:
Kies de meeste recente schema-version. Dit is automatisch het geval als je deze niet in de configuratie opgeeft. Het is af te raden om de (op dat moment) hoogste schema-version in de configuratie op te geven, want deze zal na verloop van tijd verouderd zijn. Daardoor wordt op een later moment mogelijk (onbewust) een oudere versie opgevraagd.
Kies ervoor om alle tabellen op te halen. Dit is het geval als je niet in de configuratie de include en exclude parameters opgeeft.
Gebruik geen restrictie op begin- of einddatums. Dit is het geval als je geen gebruik maakt van de start en end parameters opgeeft.
Interval:
Aangezien het een eenmalige actie betreft, is het afdoende om OnsDB handmatig te starten en geen automatische taak te maken.
Op elke dinsdagavond kunnen er tussen 19:00 en 22:00 uur onderhoud en updates worden uitgevoerd aan onze systemen en infrastructuur. Als dit gebeurt op het moment dat een OnsDB-run wordt gedaan, kan dit betekenen dat de OnsDB-run mislukt. Start daarom een run niet in dat tijdvak.
