Datahotel-platform · demo & guide

Datahotel

En generell datatjänst som gör godtyckliga SQL-källor sökbara som länkad öppen data via SPARQL — dolt bakom ett vanligt REST-API.

REV 2026-09-23
CI grön
TÄCKNING ~98%
SQL TILL LÄNKAD DATA ↗ API-REFERENS ↗
00

Vad är det här?

Du pekar plattformen mot en befintlig SQL-databas (eller laddar upp en CSV), och den blir sökbar med SPARQL — utan att du kopierar eller synkar någon data. En tunn REST-fasad döljer SPARQL:et bakom vanliga GET/POST-anrop, så den som frågar aldrig behöver veta vilken källa svaret kom ifrån.

Två körande demo: lunchsök ("var serveras köttbullar närmast mig") och en universitetsdemo som joinar tre oberoende system för att svara på "vart är min nästa föreläsning?". Bägge går att testa nedan i Våning 03.

01

Hur det hänger ihop

Ingen ETL: Ontop översätter SPARQL till SQL i farten mot samma Postgres som redan äger datan. Källregistrering (CSV-uppladdning eller postgres_fdw mot en extern Postgres) skriver bara in nya tabeller och en genererad mappning — inget flyttas ur sitt ursprungssystem.

CSV/Excel- uppladdning Extern Postgres- källa Källregistrering genererar R2RML Postgres + PostGIS lunch / uploads / ext_<källa> Ontop :8081/sparql REST-API FastAPI :8000 POST /sources/csv POST /sources/postgres (FDW) skriver tabell(er) SQL via JDBC live · 0 kopior SPARQL ↔ JSON Klient HTTP GET → svar
Två inregistreringsvägar skriver in i samma Postgres; Ontop läser den databasen live (ingen ETL, ingen kopia) och REST-API:et döljer SPARQL:et för klienten.
02

Datakällor — rumsöversikt

Varje registrerad källa får ett eget schema och en egen genererad mappning. Klassnamn är schema-kvalificerade så att två källor med likadant namngivna tabeller aldrig krockar i grafen.

01
lunch

Restauranger, menyer, rätter, öppettider, geografi (PostGIS). Kurerad schema.org + GeoSPARQL-mappning, skriven för hand.

Live
02
uploads

Vad som helst laddat via POST /sources/csv. Kolumntyper inferreras, R2RML genereras automatiskt per tabell.

Live
03
ext_<källa>

Extern Postgres importerad via postgres_fdw — hela scheman blir synliga utan datakopiering.

Live
04
schema_system

Universitetsdemo: undervisningstillfällen (schema/typ/start/slut), importerat via FDW.

Live
05
lokalbokning_system

Universitetsdemo: vilken sal/byggnad som är bokad per undervisningstillfälle, via FDW.

Live
—
studentregister

Vem som är anmäld till vad. Slås upp direkt mot SQL — går aldrig via SPARQL/Ontop.

Aldrig SPARQL-mappad
03

Testa själv

Kör mot en lokal instans (se README.md för docker compose up). Alla anrop nedan pekar mot localhost:8000.

🍽 "Var serveras köttbullar närmast mig?"

Lunch-domänen
curl "http://localhost:8000/search/dish?dish=kottbullar&lat=63.8258&lon=20.2630&radius_km=10"

Rankar träffar efter GeoSPARQL-avstånd och faktiska öppettider just nu (svensk tid) — testa en vardag 11–14 för träff.

🎓 "Vart är min nästa föreläsning?"

Flersystemsfederation
  1. Registrera kurskatalogen (CSV):
curl -F "file=@demo-data/university/kurser.csv" -F "table_name=kurser" http://localhost:8000/sources/csv curl -F "file=@demo-data/university/kurstillfallen.csv" -F "table_name=kurstillfallen" http://localhost:8000/sources/csv
  1. Registrera schema- och lokalbokningssystemen (FDW mot samma Postgres, andra scheman):
curl -X POST http://localhost:8000/sources/postgres -H "Content-Type: application/json" -d '{"source_name":"schema","host":"db","port":5432,"dbname":"datahotel_platform","user":"datahotel_platform","password":"...","remote_schema":"schema_system"}' curl -X POST http://localhost:8000/sources/postgres -H "Content-Type: application/json" -d '{"source_name":"lokalbokning","host":"db","port":5432,"dbname":"datahotel_platform","user":"datahotel_platform","password":"...","remote_schema":"lokalbokning_system"}'
  1. Ladda om Ontop (ingen hot-reload ännu), fråga sedan:
docker compose restart ontop curl "http://localhost:8000/schedule/next-lecture?student_id=S1001"

Joinar tre oberoende registrerade källor i en enda SPARQL-fråga (kurskatalog + schema + lokalbokning), medan vem som är anmäld slås upp privat direkt i SQL och aldrig lämnar den frågan som SPARQL. Se ADR-0005 för hela resonemanget.

Fullständig, interaktiv API-referens: GET /docs (Swagger UI, auto-genererad av FastAPI).

04

Säkerhet & prestanda

60–220ms
fyrhopps-join, tre källor, mätt på riktig deploy
~98%
testtäckning (enhet + e2e mot full stack)
0
datakopior — allt läses live
SkyddVad det görEndpoint
SSRF-skyddAvvisar loopback-, link-local- (molnmetadata 169.254.169.254), multicast- och reserverade adresser samt alla portar utom 5432. Privata nät (192.168.x.x/10.x.x.x) är medvetet tillåtna.POST /sources/postgres
Rate limitingPer klient-IP (sista hoppet i X-Forwarded-For), in-memory.60/min · 20/min · 10/min
Publikt/privat-delningPersonuppgifter (t.ex. kursanmälan) mappas aldrig in i SPARQL-grafen — bara slagen upp direkt i SQL, i en separat privat kod­väg.GET /schedule/next-lecture
05

Under uppförande

Skisser, inte beslut — här är vad som är tänkt men inte byggt än.

Planerat

Katalog & SPARQL-konsol

Fritt SPARQL-fält mot Ontops öppna endpoint, plus en bläddringsbar lista över registrerade källor och deras länkar (skos:closeMatch mot Wikidata m.fl.).

Planerat

Konton & hotellplatser

Signup, 1 GB gratiskvot per konto. Ägaren väljer policy per lagringsplats: hårt stopp eller rullande fönster (äldsta faller bort).

Planerat

MQTT-broker

Nivåstyrd åtkomst — öppen (fri men begränsad), bidrag (den som publicerar egna dataströmmar får mer), betald (enligt abonnemang).