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. Het gebruikt een sterk typesysteem om beschikbare gegevens duidelijk te beschrijven, vermindert het ophalen door nauwkeurige aanvragen toe te staan, maakt API-updates eenvoudiger zonder bestaande code te verbreken en 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.
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 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.
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 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.
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. 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.
Heeft de API voor GraphQL-clienttoepassing toegang nodig tot de gegevensbron om query's of mutaties uit te voeren?
API voor GraphQL vereist dat toepassingen Microsoft Entra ID gebruiken voor verificatie. Uw clienttoepassing moet voldoende zijn geregistreerd en geconfigureerd om API-aanroepen uit te voeren op Basis van Fabric. 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. 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 te hebben met een rol van inzender waar zowel de API- als de gegevensbronitems zich bevinden, waardoor de vereiste toegang tot beide items vanaf één locatie mogelijk is. 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.
Hoe kan ik een ondersteuningsticket voor API voor GraphQL openen?
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.
Welke regio's worden nog niet ondersteund door de API voor GraphQL?
API voor GraphQL wordt momenteel niet ondersteund in de regio VS - west 3.
Biedt API voor GraphQL ondersteuning voor Private Link?
API voor GraphQL biedt momenteel geen ondersteuning voor Private Link. We zijn echter van plan deze functie in de toekomst te ondersteunen en zullen updates bieden zodra ze beschikbaar komen.
Ik heb Private Link ingeschakeld voor mijn Fabric-tenant. Waarom werken mijn GraphQL-items niet?
Als de tenantinstelling 'Openbare internettoegang blokkeren' is ingeschakeld (openbare toegang is uitgeschakeld), worden niet-ondersteunde artefacten of items automatisch uitgeschakeld, inclusief API voor GraphQL. Dit betekent dat eerder gemaakte items niet kunnen worden geopend en dat er geen nieuwe items kunnen worden gemaakt. De enige manier om toegang te krijgen tot deze items is door openbare toegang toe te staan.
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 gedrag. Ten eerste kan het langer duren voordat de eerste aanvraag langer duurt als een gegevensbron moet worden opgewarmd als deze koud is. Zelfs als de gegevensbron niet koud is, is het ophalen van gegevens mogelijk niet zo efficiënt wanneer GraphQL voor het eerst een query uitgeeft, als de gegevensbron niet beschikt over de benodigde gegevens die in het geheugen zijn geladen. De tweede reden is dat de eerste aanvraag voor een API voor GraphQL-eindpunt langer kan duren, omdat het systeem uw schema en configuratie moet laden om klaar te zijn voor het accepteren van aanvragen. Dit zijn eenmalige kosten en latere aanvragen zijn sneller omdat het systeem al is opgewarmd en klaar is om uw aanvragen te verwerken.
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 Support- voor specifieke query's of problemen.