Finn svar på vanlige API-er for GraphQL-spørsmål.
Hva er GraphQL?
GraphQL er et spørringsspråk for API-er som lar apper be om nøyaktig de dataene de trenger. Viktige fordeler inkluderer:
- Sterktypesystem – Beskriver klart tilgjengelige data
- Presis datahenting – Reduserer overhenting ved å tillate spesifikke forespørsler
- Bakoverkompatibilitet – Gjør API-oppdateringer enklere uten å ødelegge eksisterende kode
- Rike verktøy – Muliggjør bruk av et bredt sett av utviklerverktøy
Det er en mer effektiv måte for programmer å kommunisere med servere og databaser på.
Hva er Microsoft Fabric API for GraphQL?
Microsoft Fabric API for GraphQL er en administrert tjeneste som gjør det mulig å lage et GraphQL API på sekunder.
Støttede datakilder:
- Microsoft Fabric-datalagre
- Microsoft Fabric Lakehouses
- Microsoft Fabric speilede databaser
- Microsoft Fabric SQL-databaser
- Azure SQL Databaser
Det gir et enhetlig API-lag for spørring og demping av data fra disse støttede datakildene.
Hvilke GraphQL-operasjoner støttes i Fabric API for GraphQL?
Bare GraphQL-spørringer (lest) og mutasjoner (skrive) støttes for øyeblikket. Datakilder som vises via SQL Analytics-endepunkter, er skrivebeskyttet og støtter derfor bare spørringer. For Data Warehouses må en primærnøkkel defineres for at mutasjoner automatisk skal genereres.
Hvordan kan jeg vise og redigere resolvers i Fabric API for GraphQL?
Løsere er GraphQL-komponenter som gir forretningslogikken for å løse felt i API-en og utføre operasjoner med data som er bosatt i datakildene.
Automatisk generering: Fabric genererer automatisk resolvere hver gang du kobler til en ny datakilde eller velger nye objekter som skal eksponeres fra en eksisterende datakilde.
Tilpasning: For øyeblikket er det ikke mulig å tilpasse resolvere direkte. For tilpasset forretningslogikk i API for GraphQL kan du opprette en lagret prosedyre i datakilden og vise den i GraphQL-API-en.
Krever API-en for GraphQL-klientprogrammet tilgang til datakilden for å kunne utføre spørringer eller mutasjoner?
Microsoft Entra ID-autentisering: API for GraphQL krever at applikasjoner bruker Microsoft Entra ID for autentisering. Klientapplikasjonen din må registreres og konfigureres til å utføre API-kall mot Fabric.
Nødvendige tillatelser:
- Appen som er registrert i Microsoft Entra krever GraphQLApi.Execute.All tillatelser for Power BI-tjenesten. Hvis du vil ha mer informasjon, kan du se Opprette en Microsoft Entra-app i Azure.
Single sign-on (SSO)-konfigurasjon: Hvis API-et er konfigurert til å bruke SSO, krever den autentiserte brukeren eller tjenesteprincipalen tilgang til begge:
- GraphQL API-et (Run Queries and Mutations-tillatelse )
- Datakilden (lese- eller skrivetilgang etter behov)
Tilgang på arbeidsplassnivå: Alternativt kan du tildele brukeren eller tjenesteprincipalen som et arbeidsområdemedlem med en bidragsyterrolle hvor både API- og datakildeelementer er plassert. Dette gir nødvendig tilgang til begge gjenstandene fra ett sted. Hvis du vil ha mer informasjon, kan du se Gi brukere tilgang til arbeidsområder.
Konfigurasjon av lagrede legitimasjoner: Hvis API-et er konfigurert til å bruke lagrede legitimasjoner, trenger den autentiserte brukeren eller tjenestelederen kun tilgang til API-et (velg alternativet Kjør spørringer og mutasjoner når du legger til direkte tilgangstillatelser til API-et).
Eksempler: Du kan finne et ende-til-ende-eksempel med eksempelkode for både brukerprinsipper og tjenesteprinsipper hos Connect Applications.
Hvordan åpne en støtteforespørsel for API for GraphQL?
Hvis du vil ha hjelp fra Microsoft Kundestøtte om ethvert problem relatert til Fabric API for GraphQL, kan du gå til nettstedet for stoffstøtte og velge alternativet Dataingeniør ing.
Støtter API for GraphQL Private Link?
API for GraphQL støtter ikke Private Link for øyeblikket.
Hvorfor utfører forespørselen min dårlig første gang jeg utsteder den, og utfører deretter godt på etterfølgende forespørsler?
Det er to hovedgrunner til denne «kaldstart»-atferden:
Oppvarming av datakilden:
- Den første forespørselen kan ta lengre tid hvis en datakilde må varmes opp fra en kald tilstand
- Selv om datakilden ikke er kald, kan datahenting være mindre effektiv første gang GraphQL sender en forespørsel hvis datakilden ikke har nødvendige data lastet inn i minnet
API-endepunktsinitialisering:
- Den første forespørselen til et API for GraphQL-endepunkt kan ta lengre tid fordi systemet må laste inn skjemaet og konfigurasjonen din
- Påfølgende forespørsler går raskere fordi systemet allerede er oppvarmet og klart til å imøtekomme dine forespørsler
Du finner mer informasjon i anbefalte fremgangsmåter for ytelse.
Hvordan kan jeg gi tilbakemelding eller forslag til API for GraphQL?
Vi tar gjerne imot tilbakemeldinger og forslag! Du kan gi tilbakemelding gjennom Fabric Ideas. Teamet vårt overvåker aktivt tilbakemeldingene og forslagene som sendes inn gjennom denne plattformen. Du kan også kontakte oss via Microsoft Fabric Support for spesifikke spørringer eller bekymringer.