Veelgestelde vragen over Fabric-API voor GraphQL

GraphQL is een querytaal voor API's waarmee apps exact de gegevens kunnen aanvragen die ze nodig hebben. Belangrijke voordelen zijn onder andere:

• Sterk type systeem - Beschrijft duidelijk beschikbare gegevens
• Nauwkeurige gegevens ophalen - Vermindert over-ophalen door specifieke aanvragen toe te staan
• Compatibiliteit met eerdere versies : API-updates eenvoudiger maken zonder bestaande code te verbreken
• Uitgebreide hulpprogramma's : maakt het gebruik van een brede set ontwikkelhulpprogramma's mogelijk

Het is een efficiëntere manier voor toepassingen om te communiceren met servers en databases.

Microsoft Fabric API voor GraphQL is een beheerde service waarmee u binnen enkele seconden een GraphQL-API kunt maken.

Ondersteunde gegevensbronnen:

• Microsoft Fabric-datamagazijnen
• Microsoft Fabric Lakehouses
• Gespiegelde databases in Microsoft Fabric
• Microsoft Fabric SQL-databases
• Azure SQL Databases

Het biedt een uniforme API-laag voor het opvragen en dempen van gegevens uit deze ondersteunde gegevensbronnen.

Momenteel worden alleen GraphQL-query's (lezen) en mutaties (schrijfbewerkingen) ondersteund. Gegevensbronnen die worden weergegeven via SQL Analytics-eindpunten, zijn alleen-lezen, waardoor alleen query's worden ondersteund. Voor datawarehouses moet een primaire sleutel worden gedefinieerd voor mutaties die automatisch moeten worden gegenereerd.

Resolvers zijn GraphQL-onderdelen die de bedrijfslogica bieden om velden in de API op te lossen en bewerkingen uit te voeren met gegevens die zich in de gegevensbronnen bevinden.

Automatische generatie: Fabric genereert automatisch resolvers wanneer u een nieuwe gegevensbron koppelt of nieuwe objecten selecteert die moeten worden weergegeven vanuit een bestaande gegevensbron.

Aanpassing: Op dit moment is het niet mogelijk om resolvers rechtstreeks aan te passen. Voor aangepaste bedrijfslogica in API voor GraphQL kunt u een opgeslagen procedure maken in de gegevensbron en deze beschikbaar maken in de GraphQL-API.

Microsoft Entra ID-verificatie: API voor GraphQL vereist dat toepassingen Microsoft Entra ID gebruiken voor verificatie. Uw clienttoepassing moet worden geregistreerd en geconfigureerd om API-aanroepen uit te voeren op Fabric.

Vereiste machtigingen:

• De app die is geregistreerd in Microsoft Entra, vereist GraphQLApi.Execute.All machtigingen voor de Power BI-service. Zie Een Microsoft Entra-app maken in Azure voor meer informatie.

Configuratie van eenmalige aanmelding (SSO): Als de API is geconfigureerd voor gebruik van eenmalige aanmelding, heeft de geverifieerde gebruiker of service-principal toegang nodig tot beide:

• De GraphQL-API (machtiging voor Query's en Mutaties)
• De gegevensbron (lees- of schrijftoegang indien nodig)

Optie voor toegang op werkruimteniveau: U kunt de gebruiker of service-principal ook toewijzen als werkruimtelid met een inzenderrol waar zowel de API als de gegevensbronitems zich bevinden. Dit geeft de vereiste toegang tot beide items vanaf één locatie. Zie Gebruikers toegang geven tot werkruimten voor meer informatie.

Configuratie van opgeslagen referenties: Als de API is geconfigureerd voor het gebruik van opgeslagen referenties, heeft de geverifieerde gebruiker of service-principal alleen toegang tot de API nodig (selecteer de optie Query's en Mutaties uitvoeren bij het toevoegen van machtigingen voor directe toegang aan de API).

Voorbeelden: U vindt een end-to-end-voorbeeld met voorbeeldcode voor zowel gebruikers-principals als service-principals bij Connect Applications.

Als u hulp wilt krijgen van Microsoft Ondersteuning over een probleem met betrekking tot fabric-API voor GraphQL, gaat u naar de ondersteuningssite van Fabric en kiest u de optie Data-engineer ing.

API voor GraphQL biedt momenteel geen ondersteuning voor Private Link.

Er zijn twee belangrijke redenen voor dit 'koude startgedrag':

Opwarmen van gegevensbron:

• De eerste aanvraag kan langer duren als een gegevensbron moet worden opgewarmd vanuit een koude status
• Zelfs als de gegevensbron niet koud is, is het ophalen van gegevens mogelijk niet zo efficiënt wanneer GraphQL voor het eerst een query uitvoert als de gegevensbron niet beschikt over de benodigde gegevens die in het geheugen zijn geladen

Initialisatie van API-eindpunten:

• De eerste aanvraag voor een API voor GraphQL-eindpunt kan langer duren omdat het systeem uw schema en configuratie moet laden
• Volgende aanvragen zijn sneller omdat het systeem al is opgewarmd en klaar is om uw aanvragen te verwerken

Meer informatie vindt u in de aanbevolen procedures voor prestaties.

Wij verwelkomen uw feedback en suggesties! U kunt feedback geven via Fabric Ideas. Ons team bewaakt actief de feedback en suggesties die via dit platform zijn ingediend. U kunt ook contact met ons opnemen via Microsoft Fabric Support- voor specifieke query's of problemen.

Gerelateerde inhoud

Wat is Microsoft Fabric API voor GraphQL?