Voor de beheerders

Alleen-lezen SQL-verkenner

Een SQL-editor om de clubgegevens alleen-lezen te bevragen, met een gegevenswoordenboek, voorbeelden en op te slaan query’s.

Waar vindt u het

Statistieken › Verkenner

Beschikbaar sinds

versie 2.1 (2026)

Module om aan te zetten

Geen.

Waarvoor dient het

Een vraag stellen die geen van de 29 rapporten dekt: de tochten van de dinsdagavond, de kilometers van een groep, de boten die nooit in de winter zijn uitgevaren.

De Verkenner bevraagt de database van de club in SQL, maar alleen om te lezen: u kunt niets kapotmaken. Hij is voorbehouden aan beheerders: bij het openen vraagt hij om het beheerderswachtwoord.

Bedacht voor vrijwilligers

• Begeleide eerste stappen: drie stappen en tien voorbeeldquery’s, zoals ‘De 10 meest gebruikte boten’ of ‘Late terugkomst (meer dan 15 min) per maand’.
• Het gegevenswoordenboek beschrijft elke view en elke kolom in het Nederlands. Een klik op een kolom voegt haar in de query in.
• Fouten worden in gewone taal uitgelegd, met regel en kolom. Een tikfout als ‘LIMT’ wordt onderstreept, met ‘bedoelde u LIMIT?’ en een knop ‘Verbeteren naar LIMIT’.
• De parameter :season volgt het seizoen dat bovenaan de pagina is gekozen. De andere parameters stelt u onder de editor in.
• Het resultaat verschijnt als tabel of als grafiek (staven, lijnen, vlakken, taart, heatmap, kalender, kerncijfers). Het is te exporteren naar CSV, Excel of als afbeelding.

Hoe gebruikt u het

1. Open Statistieken › Verkenner en voer het beheerderswachtwoord in.
2. Begin met een voorbeeld, een rapport (‘SQL-query bekijken’ onder ‘Meer acties’) of de AI-assistent (‘AI vragen’, zie AI-assistent en MCP).
3. Pas de query aan en klik op ‘Uitvoeren’ (of Ctrl + Enter). ‘Opmaken’ zet de query netjes onder elkaar.
4. Kies de grafiek en dan ‘Opslaan als…’ of ‘Vastzetten op dashboard’.
5. De opgeslagen query’s staan in het tabblad ‘Query’s’, met hun herkomst: u, een rapport, de AI-assistent of een AI-app (MCP). U kunt ze hernoemen, dupliceren en archiveren, en daarna herstellen via ‘Gearchiveerd’.

Instellingen

• Woordenboek: ‘Vereenvoudigde views’ (klaar voor de statistieken: seizoen, datums opgesplitst in maand, week en uur, filters) en ‘Geavanceerde tabellen’ (de ruwe gegevens van de applicatie). De view van de tochten is de nuttigste. Persoonlijke kolommen zijn gemarkeerd met ‘Persoonsgegeven’. De contactgegevens (e-mail, telefoon, adres, licentie) zijn ‘altijd leeg’.
• Voorstellen: de grafieken die een via MCP gekoppelde AI-app voorstelt, komen in het tabblad ‘Voorstellen’ terecht. U bekijkt ze en kiest dan ‘Accepteren’ of ‘Weigeren’. Zie AI-assistent en MCP.
• Prestaties: in Beheer › Statistieken en AI › Prestaties bepaalt het profiel (Auto, Zuinig, Standaard of Krachtig) de maximale duur van een query en het aantal rijen. Auto kiest op basis van het geheugen en de kernen van de computer.

Beperkingen en toelichting

• Alleen-lezen: alleen SELECT- en WITH-query’s worden geaccepteerd, steeds één tegelijk. Een DELETE, UPDATE of INSERT wordt geweigerd met de melding ‘De statistieken lezen de gegevens alleen’: er is niets gewijzigd. Om een tocht of een roeier te corrigeren gebruikt u het Logboek of Beheer.
• Stoppen na een tijdslimiet: een te lange query wordt gestopt, met tips om hem in te korten en een knop ‘Opnieuw uitvoeren’. De limiet hangt af van het profiel van de computer: 10 seconden bij Zuinig (Raspberry Pi en kleine computers), 30 seconden bij Standaard (een recente laptop), een minuut bij Krachtig (een desktopcomputer). Met de knop ‘Stoppen’ onderbreekt u een query ook met de hand.
• Beperkt resultaat: boven de rijenlimiet van het profiel (1.000 getoonde rijen bij Zuinig) toont de Verkenner de eerste rijen en zegt dat. Voeg een filter of een GROUP BY toe om alles te zien.
• Gegevens buiten bereik: de statistieken lezen alleen de views en tabellen uit het woordenboek. De bootreserveringen, de instellingen van de applicatie en het beheerderswachtwoord horen daar niet bij. De contactgegevens van roeiers zijn altijd ‘leeg’.
• De query’s lezen de database zonder haar ooit te schrijven. Op een kleine computer kan een zware query de applicatie vertragen: daarom volgen de limieten voor tijd, rijen en geheugen het profiel van de computer, en daarom blijft een Raspberry Pi op Zuinig.
• Offline werken de rapporten en de Verkenner. Alleen de AI-hulp heeft internet nodig.

Alle functies