Veelgestelde vragen over Fabric-API voor GraphQL

GraphQL is een opensource-querytaal voor API's en een runtime voor het uitvoeren van deze query's met uw bestaande gegevens. GraphQL biedt een volledige en begrijpelijke beschrijving van de gegevens in uw API met een sterk getypt systeem, biedt clients de mogelijkheid om precies te vragen wat ze nodig hebben en niets meer, maakt het eenvoudiger om API's in de loop van de tijd te ontwikkelen en krachtige ontwikkelhulpprogramma's mogelijk te maken.

Microsoft Fabric-API voor GraphQL is een beheerde service waarmee u binnen enkele seconden een GraphQL-API kunt maken voor toegang tot gegevens uit uw gegevensbronnen, zoals Microsoft Fabric Data Warehouses, Microsoft Fabric Lakehouses, Microsoft Fabric Mirrored Databases, Microsoft Fabric SQL Databases en Azure SQL Databases. Het biedt een uniforme API-laag voor het opvragen en dempen van gegevens uit deze ondersteunde gegevensbronnen. Fabric-API voor GraphQL is momenteel in preview.

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. In het geval van 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. Fabric genereert automatisch resolvers wanneer u een nieuwe gegevensbron koppelt of nieuwe objecten selecteert die moeten worden weergegeven vanuit een bestaande gegevensbron. Op dit moment is het niet mogelijk om resolvers 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.

API voor GraphQL vereist dat toepassingen Microsoft Entra gebruiken voor verificatie. Uw clienttoepassing moet voldoende zijn geregistreerd en geconfigureerd om API-aanroepen uit te voeren op Basis van Fabric. Voor de app die is geregistreerd in Microsoft Entra, zijn Item.Execute.All-machtigingen vereist voor de Power BI-service. Zie Een Microsoft Entra-app maken in Azure voor meer informatie. Naast Microsoft Entra, als de API is geconfigureerd voor gebruik van eenmalige aanmelding (SSO), heeft de geverifieerde gebruiker of service-principal in de app die de GraphQL-API aanroept, toegang nodig tot zowel de GraphQL-API als de gegevensbron. Meer specifiek voer query's en mutatiemachtigingen uit in de GraphQL-API en lees- of schrijftoegang die vereist is in de gegevensbron van de keuze dienovereenkomstig. Een andere optie is om de gebruiker of service-principal als werkruimtelid met een inzenderrol te hebben waar zowel de API- als de gegevensbronitems zich bevinden, die de vereiste toegang biedt tot beide items vanaf één locatie. Zie Gebruikers toegang geven tot werkruimten voor meer informatie. Als de API is geconfigureerd voor het gebruik van opgeslagen referenties, moet de geverifieerde gebruiker of service-principal alleen toegang hebben tot de API (Selecteer Query's en mutaties uitvoeren optie bij het toevoegen van machtigingen voor directe toegang aan de API). 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 wordt momenteel niet ondersteund in de regio VS - west 3.

Gerelateerde inhoud

Wat is Microsoft Fabric API voor GraphQL?