Find svar på ofte stillede Fabric-API'er til GraphQL-spørgsmål.
Hvad er GraphQL?
GraphQL er et forespørgselssprog til API'er, der gør det muligt for apps at anmode om præcis de data, de har brug for. Det bruger et stærkt typesystem til tydeligt at beskrive tilgængelige data, reducerer overhentning ved at tillade præcise anmodninger, gør API-opdateringer lettere uden at ødelægge eksisterende kode og gør det muligt at bruge et bredt sæt udviklerværktøjer. Det er en mere effektiv måde for programmer at kommunikere med servere og databaser på.
Hvad er Microsoft Fabric API til GraphQL?
Microsoft Fabric API til GraphQL er en administreret tjeneste, der giver dig mulighed for at oprette en GraphQL-API på få sekunder for at få adgang til data fra dine datakilder, f.eks. Microsoft Fabric Data Warehouses, Microsoft Fabric Lakehouses, Microsoft Fabric Mirrored Databases, Microsoft Fabric SQL Databases og Azure SQL Databases. Det giver et samlet API-lag til forespørgsel og mutering af data fra disse understøttede datakilder.
Hvilke GraphQL-handlinger understøttes i Fabric API til GraphQL?
Det er kun GraphQL-forespørgsler (læse) og mutationer (skrivning), der understøttes i øjeblikket. Datakilder, der eksponeres via SQL Analytics-slutpunkter, er skrivebeskyttede og understøtter derfor kun forespørgsler. I forbindelse med data warehouses skal der defineres en primær nøgle, for at mutationer genereres automatisk.
Hvordan kan jeg få vist og redigere fortolkere i Fabric API til GraphQL?
Resolvers er GraphQL-komponenter, der leverer forretningslogik til at løse felter i API'en og udføre handlinger med data, der findes i datakilderne. Fabric genererer automatisk løsningsprogrammer, når du tilknytter en ny datakilde eller vælger nye objekter, der skal vises fra en eksisterende datakilde. I øjeblikket er det ikke muligt at tilpasse fortolkere. I forbindelse med brugerdefineret forretningslogik i API til GraphQL kan du oprette en lagret procedure i datakilden og vise den i GraphQL-API'en.
Kræver API'en til GraphQL-klientprogrammet adgang til datakilden for at kunne udføre forespørgsler eller mutationer?
API til GraphQL kræver, at programmer bruger Microsoft Entra ID til godkendelse. Dit klientprogram skal registreres og konfigureres tilstrækkeligt til at udføre API-kald mod Fabric. Den app, der er registreret i Microsoft Entra, kræver GraphQLApi.Execute.All tilladelser til Power BI-tjenesten. Du kan få flere oplysninger under Opret en Microsoft Entra-app i Azure. Ud over Microsoft Entra kræver den godkendte bruger eller tjenesteprincipal i den app, der kalder GraphQL-API'en, adgang til både GraphQL-API'en og datakilden, hvis API'en er konfigureret til at bruge enkeltlogon (SSO). Mere specifikt tilladelsen Kør forespørgsler og mutationer i GraphQL-API'en og læse- eller skriveadgang kræves i den valgte datakilde i overensstemmelse hermed. En anden mulighed er at have brugeren eller tjenesteprincipalen som medlem af arbejdsområdet med en bidragyderrolle, hvor både API- og datakildeelementer er placeret, hvilket giver den nødvendige adgang til begge elementer fra et enkelt sted. Du kan få flere oplysninger under Giv brugere adgang til arbejdsområder. Hvis API'en er konfigureret til at bruge gemte legitimationsoplysninger, skal den godkendte bruger eller tjenesteprincipal blot have adgang til API'en (vælg indstillingen Kør forespørgsler og mutationer, når der føjes direkte adgangstilladelser til API'en). Du kan finde et eksempel fra ende til anden med eksempelkode for både brugerprincipaler og tjenesteprincipaler i Connect Applications.
Hvordan gør jeg åbne en supportanmodning til API til GraphQL?
Hvis du vil have hjælp fra Microsoft Support om et hvilket som helst problem, der er relateret til Fabric API til GraphQL, skal du gå til vores Fabric Support-websted og vælge indstillingen Dataudvikler ing.
Understøtter API til GraphQL Privat link?
API til GraphQL understøtter ikke Privat link på nuværende tidspunkt. Vi planlægger dog at understøtte denne funktion i fremtiden og vil levere opdateringer, efterhånden som de bliver tilgængelige.
Jeg har aktiveret Privat link til min Fabric-lejer. Hvorfor fungerer mine GraphQL-elementer ikke?
Hvis lejerindstillingen "Bloker offentlig internetadgang" er aktiveret (dvs. offentlig adgang er deaktiveret), deaktiveres alle artefakter eller elementer, der ikke understøttes, automatisk, herunder API til GraphQL. Det betyder, at der ikke er adgang til tidligere oprettede elementer, og at der heller ikke kan oprettes nye. Den eneste måde at få adgang til disse elementer på er ved at tillade offentlig adgang.
Hvorfor fungerer min anmodning dårligt, første gang jeg udsteder den, og klarer den derefter godt på efterfølgende anmodninger?
Der er to primære årsager til denne funktionsmåde. For det første kan den første anmodning tage længere tid, hvis en datakilde skal varmes op, hvis den er kold. Selvom datakilden ikke er kold, er datahentning muligvis ikke så effektiv, første gang GraphQL udsteder en forespørgsel, hvis datakilden ikke har de nødvendige data indlæst i hukommelsen. Den anden årsag er, at den første anmodning til en API til GraphQL-slutpunktet kan tage længere tid, fordi systemet skal indlæse skemaet og konfigurationen for at være klar til at acceptere anmodninger. Dette er en engangsomkostning, og efterfølgende anmodninger er hurtigere, fordi systemet allerede er varmet op og klar til at imødekomme dine anmodninger. Du kan finde flere oplysninger i bedste praksis for ydeevne.
Hvordan kan jeg give feedback eller forslag til API til GraphQL?
Vi glæder os over din feedback og dine forslag! Du kan give feedback via Fabric Ideas. Vores team overvåger aktivt den feedback og de forslag, der indsendes via denne platform. Du kan også kontakte os via Microsoft Fabric Support for specifikke forespørgsler eller bekymringer.