Hoe verbinding maken met een SQL-database
Voordat je begint
- Controleer of je database correct werkt.
- Zorg ervoor dat je database toegankelijk is vanaf een openbaar IP-adres.
- Controleer of je database verbindingen accepteert vanaf het IP-adres van Octoboard: 173.255.226.233
Om je eerste verbinding te configureren en een widget toe te voegen, gebruik je de rode knop rechtsonder en selecteer je ADD WIDGET (als je widgets aan een rapport toevoegt, zorg er dan voor dat je eerst in de BEWERK-modus staat).
Zodra je op ADD WIDGET klikt, kom je in de standaard verbindingswizard terecht. Op de eerste pagina selecteer je de database waarmee je wilt verbinden. Scroll naar beneden om je gewenste database te vinden. Selecteer deze en klik op VOLGENDE.
U wordt gevraagd om uw databaseverbindinggegevens in te voeren. Het maken van een SQL-databaseverbinding is een zeer vergelijkbaar proces voor alle ondersteunde databases. In deze tutorial gebruiken we Oracle als voorbeeld:
U wordt gevraagd om verbindingsgegevens voor uw database in te voeren. Klik op de knop "TEST CONNECTION". Octoboard zal u vertellen of uw verbinding succesvol is. Klik op APPLY om het proces te voltooien.
Zodra uw databaseverbinding tot stand is gebracht, kunt u SQL-query's uitvoeren en informatie weergeven in database-widgets. U kunt complexe SQL-statements maken, maar uw SELECT-velden moeten voldoen aan de eisen van elk widgettype.
Om door te gaan naar het maken van een database-widget, klikt u op VOLGENDE in de verbindingswizard.
Het proces van het toevoegen van database-widgets aan uw dashboards en rapporten wordt behandeld in deze Knowledge Base tutorial.
Zijn er beperkingen of vereisten voor SQL-query's?
- Alleen SELECT-statements zijn toegestaan.
- Beëindig uw query's niet met een puntkomma (;).
- Gebruik geen opmerkingen in uw SQL-query's.
- Kolomtellingen moeten overeenkomen met het gevraagde widgettype. Dit wordt behandeld in eerdere alinea's van deze handleiding.
- Queryresultaten zijn beperkt tot 1000 rijen. Dit zou voldoende moeten zijn voor de meeste gevallen. Als u deze limiet bereikt, probeer dan uw output te optimaliseren door (a) geretourneerde datasets te aggregeren (gebruik GROUPBY-instructie) en (b) gegevens in dalende volgorde terug te geven (gebruik "SORT BY veld DESC").
- Queries moeten binnen 10 seconden worden uitgevoerd. Na die periode zal de widget time-out optreden. Als dat gebeurt, probeer dan uw queries te vereenvoudigen.
Zorg er eerst voor dat uw database online toegankelijk is. Voer de volgende opdracht uit vanaf een openbare computer (vanaf een openbaar IP-adres, niet op uw privénetwerk). Vervang uw_db_host en uw_db_port door de host en poort van uw database:
f:Unix OS: nc -v uw_db_host uw_db_port
f:Windows OS: telnet uw_db_host uw_db_port
Gelieve contact op te nemen met uw databasebeheerder en ervoor te zorgen dat uw database verbindingen accepteert vanaf het volgende Octoboard IP-adres: 173.255.226.233
