Een OData-feed laden in je Azure datawarehouse en Power BI
OData-feeds ontsluiten
Biedt je systeem een OData-feed, dan heeft Yres weinig van je nodig: een OData-service maakt zelf bekend welke entiteiten en velden ze heeft. Je geeft de service-root op en kiest de aanmelding: anoniem of Basic, of OAuth 2.0 via de aparte variant OData OAuth. Yres leest de metadata, haalt de records op en volgt de nextLink tot de laatste pagina. De data landt in een Azure SQL-database in je eigen Azure-tenant, krijgt daar historie (SCD2) en is bruikbaar in Power BI.
In het kort
- Verbinding
- Generieke OData-koppeling voor feeds in versie 2 en 4. Je vult alleen de service-root in (vaak eindigend op /odata)
- Aanmelden zonder OAuth
- Anoniem voor een publieke feed, of Basic met gebruikersnaam en wachtwoord. Extra HTTP-headers zijn mogelijk, bijvoorbeeld Authorization, APIKey of X-API-KEY
- Aanmelden met OAuth 2.0
- Via het brontype OData OAuth: client credentials (server naar server), of authorization code met een refresh token waarmee Yres steeds een nieuw toegangstoken ophaalt
- Paginering
- Ligt vast: Yres volgt de OData-nextLink in de respons totdat alle pagina's binnen zijn. Je hoeft geen parameters op te geven
- Incrementeel laden
- Mogelijk als de feed een geschikte wijzigingskolom bevat. Anders laad je de volledige set
- Waar draait het
- Als Azure Data Factory-pipelines in je eigen Azure-tenant. Staat de feed on-premises of achter een firewall, dan kies je een self-hosted integration runtime
- Geheimen
- Service-URL, wachtwoord en client secret komen in de Key Vault van je eigen Azure-omgeving te staan, niet in de webapplicatie van Yres
Wat je zelf regelt
- 1Vraag de aanbieder van het systeem om de service-root van de OData-feed. Zet er /$metadata achter om te zien welke entiteiten en velden de feed heeft.
- 2Ga na hoe de feed beveiligd is: publiek, Basic, een API-key in een header, of OAuth 2.0.
- 3Bij OAuth 2.0: registreer een OAuth-client bij de aanbieder. Je krijgt een client ID, een client secret, het token-endpoint en de toegestane scope. Werk je met authorization code, zorg dan ook voor een geldig refresh token.
- 4Voeg in Yres de bron OData toe, of OData OAuth bij een OAuth-beveiligde feed, en vul de gegevens in.
- 5Kies wat je wilt laden en stel per tabel het laadtype en de planning in.
Wanneer heb je dit nodig — en wanneer niet
Een losse connector is genoeg als…
Power BI heeft zelf een OData-connector. Lees je één kleine feed uit voor één rapport en hoef je niet terug te kijken in de tijd, dan is dat voldoende.
Yres voegt iets toe als…
Yres wordt zinvol bij feeds met veel pagina's, bij OAuth-tokens die steeds vernieuwd moeten worden, als je wijzigingen wilt bewaren die de feed zelf niet laat zien, of als de OData-data gecombineerd moet worden met bronnen die geen OData spreken.
Veelgestelde vragen: OData
Wat is het verschil tussen de OData- en de REST-koppeling van Yres?
OData is een standaard bovenop REST. De feed publiceert zijn eigen datamodel via $metadata en geeft bij elke pagina de link naar de volgende mee. Daardoor liggen paginering en structuur in Yres al vast. Bij een gewone REST API moet je zelf het endpoint, de paginatievorm en de parameternamen opgeven en leidt Yres de kolommen af uit de JSON. Heeft je systeem een OData-feed, dan is dat de kortste weg.
Hoe weet ik of mijn systeem een OData-feed heeft?
Kijk in de API-documentatie van de leverancier of vraag ernaar. Een service-root eindigt vaak op /odata, en als je er /$metadata achter zet krijg je het datamodel te zien. Staat je systeem niet in onze bronnenlijst maar biedt het OData, dan kun je het hiermee koppelen. Ook bekende bronnen zoals SAP-services, Mendix en Topdesk lopen in Yres via OData.
Mijn feed vraagt een API-key of OAuth. Kan dat?
Ja. Een API-key stuur je mee als extra HTTP-header bij het gewone OData-brontype. Voor OAuth 2.0 kies je het brontype OData OAuth, met client credentials of authorization code. Bij authorization code is een refresh token verplicht; zonder dat token weigert Yres de bron.
Wanneer heb ik een self-hosted integration runtime nodig voor OData?
Alleen als de OData-service niet rechtstreeks vanuit Azure bereikbaar is, bijvoorbeeld omdat ze on-premises of achter een firewall draait. Voor een feed die via internet bereikbaar is, volstaat de standaard cloud-runtime van Azure Data Factory.
Volledige technische beschrijving in de kennisbank →·Laatst gecontroleerd:
Datawarehouse-automatisering die in je eigen Azure draait
Gebouwd voor organisaties op Azure en Power BI. Yres koppelt je bronnen, bewaart de historie en rolt wijzigingen gecontroleerd uit, zonder handwerk.