Hitta svar på vanliga frågor om Fabric API för GraphQL-frågor.
Vad är GraphQL?
GraphQL är ett frågespråk för API:er som gör att appar kan begära exakt de data de behöver. Det använder ett starkt typsystem för att tydligt beskriva tillgängliga data, minskar överhämtningen genom att tillåta exakta begäranden, göra API-uppdateringar enklare utan att bryta befintlig kod och möjliggör användning av en bred uppsättning utvecklarverktyg. Det är ett effektivare sätt för program att kommunicera med servrar och databaser.
Vad är Microsoft Fabric API för GraphQL?
Microsoft Fabric API för GraphQL är en hanterad tjänst som gör att du kan skapa ett GraphQL-API på några sekunder för att komma åt data från dina datakällor, till exempel Microsoft Fabric Data Warehouses, Microsoft Fabric Lakehouses, Microsoft Fabric Mirrored Databases, Microsoft Fabric SQL Databases och Azure SQL Databases. Det ger ett enhetligt API-lager för att fråga och mutera data från dessa datakällor som stöds.
Vilka GraphQL-åtgärder stöds i Fabric API för GraphQL?
För närvarande stöds endast GraphQL-frågor (läsning) och mutationer (skrivning). Datakällor som exponeras via SQL Analytics-slutpunkter är skrivskyddade och stöder därför endast frågor. När det gäller informationslager måste en primärnyckel definieras för att mutationer ska genereras automatiskt.
Hur kan jag visa och redigera matchare i Fabric API för GraphQL?
Matchare är GraphQL-komponenter som tillhandahåller affärslogik för att matcha fält i API:et och utföra åtgärder med data som finns i datakällorna. Fabric genererar automatiskt matchare när du kopplar en ny datakälla eller väljer nya objekt som ska exponeras från en befintlig datakälla. För närvarande går det inte att anpassa matchare. För anpassad affärslogik i API för GraphQL kan du skapa en lagrad procedur i datakällan och exponera den i GraphQL-API:et.
Kräver API:et för GraphQL-klientprogrammet åtkomst till datakällan för att kunna utföra frågor eller mutationer?
API för GraphQL kräver att program använder Microsoft Entra-ID för autentisering. Klientprogrammet måste vara registrerat och konfigurerat på ett lämpligt sätt för att köra API-anrop mot Fabric. Appen som är registrerad i Microsoft Entra kräver GraphQLApi.Execute.All behörigheter för Power BI-tjänsten. Mer information finns i Skapa en Microsoft Entra-app i Azure. Förutom Microsoft Entra kräver den autentiserade användaren eller tjänstens huvudnamn i appen som anropar GraphQL-API:et åtkomst till både GraphQL-API:et och datakällan om API:et är konfigurerat att använda enkel inloggning (SSO). Mer specifikt kör du frågor och mutationer i GraphQL-API:et och läser eller skriver åtkomst som krävs i valfri datakälla. Ett annat alternativ är att ha användaren eller tjänstens huvudnamn som medlem i arbetsytan med en deltagarroll där både API:et och datakällans objekt finns, vilket ger nödvändig åtkomst till båda objekten från en enda plats. Mer information finns i Ge användare åtkomst till arbetsytor. Om API:et är konfigurerat för att använda sparade autentiseringsuppgifter behöver det autentiserade användaren eller tjänstens huvudnamn bara ha åtkomst till API:et (Välj Kör frågor och mutationer alternativet när du lägger till direktåtkomstbehörigheter till API:et). Du hittar ett exempel från slutpunkt till slutpunkt med exempelkod för både användarens huvudnamn och tjänstens huvudnamn i Connect Applications.
Hur gör jag för att öppna ett supportärende för API för GraphQL?
Om du vill få hjälp från Microsoft Support om eventuella problem som rör Fabric API för GraphQL går du till vår webbplats för infrastruktursupport och väljer alternativet Dataingenjör ing.
Vilka regioner stöds ännu inte av API:et för GraphQL?
API för GraphQL stöds för närvarande inte i regionen USA, västra 3.
Stöder API för GraphQL Private Link?
API för GraphQL stöder inte Private Link just nu. Vi planerar dock att stödja den här funktionen i framtiden och kommer att tillhandahålla uppdateringar när de blir tillgängliga.
Jag har aktiverat Private Link för min infrastrukturresursklientorganisation. Varför fungerar inte mina GraphQL-objekt?
Om klientinställningen "Blockera offentlig Internetåtkomst" är aktiverad (dvs. offentlig åtkomst är inaktiverad), inaktiveras alla artefakter eller objekt som inte stöds automatiskt, inklusive API för GraphQL. Det innebär att tidigare skapade objekt inte kan nås och inte heller kan nya skapas. Det enda sättet att komma åt dessa objekt är att tillåta offentlig åtkomst.
Varför fungerar min begäran dåligt första gången jag utfärdar den och presterar sedan bra på efterföljande begäranden?
Det finns två huvudsakliga orsaker till det här beteendet. För det första kan den första begäran ta längre tid om en datakälla behöver värmas upp om den är kall. Även om datakällan inte är kall kanske datahämtningen inte är lika effektiv första gången GraphQL utfärdar en fråga, om datakällan inte har de data som behövs inlästa i minnet. Den andra orsaken är att den första begäran till ett API för GraphQL-slutpunkten kan ta längre tid eftersom systemet måste läsa in schemat och konfigurationen för att vara redo att acceptera begäranden. Det här är en engångskostnad och efterföljande begäranden går snabbare eftersom systemet redan är uppvärmt och redo att hantera dina begäranden.
Hur kan jag ge feedback eller förslag för API för GraphQL?
Vi välkomnar din feedback och dina förslag! Du kan ge feedback via Fabric Ideas. Vårt team övervakar aktivt feedbacken och förslagen som skickas via den här plattformen. Du kan också kontakta oss via Microsoft Fabric Support för specifika frågor eller problem.