Vind antwoorden op veelgestelde Fabric-API voor GraphQL-vragen.
Wat is 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
- Rich tooling - Maakt het gebruik van een breed assortiment aan ontwikkelaarstools mogelijk
Het is een efficiëntere manier voor toepassingen om te communiceren met servers en databases.
Wat is Microsoft Fabric API voor GraphQL?
Microsoft Fabric API voor GraphQL is een beheerde service waarmee u binnen enkele seconden een GraphQL-API kunt maken.
Ondersteunde gegevensbronnen:
- Microsoft Fabric Data Warehouses
- Microsoft Fabric Lakehouses
- Microsoft Fabric-gespiegelde databases
- Microsoft Fabric SQL-databases
- Azure SQL databases
Het biedt een uniforme API-laag voor het opvragen en muteren van gegevens uit deze ondersteunde gegevensbronnen.
Welke GraphQL-bewerkingen worden ondersteund in fabric-API voor GraphQL?
Momenteel worden alleen GraphQL-query's (lezen) en mutaties (schrijfbewerkingen) ondersteund. Gegevensbronnen die worden weergegeven via SQL Analytics-eindpunten zijn in alleen-lezen modus, waardoor ze alleen queries ondersteunen. Voor datawarehouses moet een primaire sleutel worden gedefinieerd voor mutaties die automatisch moeten worden gegenereerd.
Hoe kan ik resolvers weergeven en bewerken in fabric-API voor GraphQL?
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.
Vereist de API voor een GraphQL-clienttoepassing toegang tot de gegevensbron om queries of mutaties uit te voeren?
Microsoft Entra ID authentication:-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 Maak een Microsoft Entra-app in Azure voor meer informatie.
Single sign-on (SSO)-configuratie: Als de API is geconfigureerd voor het gebruik van SSO, vereist de geverifieerde gebruiker of service-principal toegang tot beide:
- De GraphQL-API (machtiging voor Query's en Mutaties)
- De gegevensbron (lees- en schrijfrechten indien nodig)
Werkruimteniveau toegangsoptie: U kunt de gebruiker of service-principal ook toewijzen als lid van de werkruimte met een bijdragegeverrol waar zich zowel de API-items als de gegevensbronnen bevinden. Dit geeft de vereiste access aan beide items vanaf één plaats. Voor meer informatie, zie Gebruikers toegang geven tot werkruimten.
Configuratie van opgeslagen referenties: Als de API is geconfigureerd voor het gebruik van opgeslagen referenties, heeft de geverifieerde gebruiker of service-principal alleen access nodig voor de API (selecteer Query's en Mutaties optie bij het toevoegen van directe access machtigingen aan de API).
Voorbeelden: U vindt een end-to-end-voorbeeld met voorbeeldcode voor zowel gebruikers-principals als service-principals bij Connect Applications.
Hoe open ik een ondersteuningsticket voor de API van GraphQL?
Ga naar de Fabric Support-site en kies de optie Data Engineering om hulp te krijgen van Microsoft Support over problemen met betrekking tot fabric-API voor GraphQL.
Biedt API voor GraphQL ondersteuning voor Private Link?
API voor GraphQL ondersteunt momenteel alleen Tenant Level Private Link.
Waarom presteert mijn aanvraag slecht wanneer ik deze de eerste keer uitgeeft en presteer dan goed bij volgende aanvragen?
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.
Hoe kan ik feedback of suggesties geven voor API voor GraphQL?
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 Ondersteuning voor specifieke query's of problemen.