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. Den bruker et sterkt typesystem til å tydelig beskrive tilgjengelige data, reduserer overhenting ved å tillate nøyaktige forespørsler, gjør API-oppdateringer enklere uten å bryte eksisterende kode, og muliggjør bruk av et bredt sett med 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 å opprette en GraphQL-API i løpet av sekunder for å få tilgang til data fra datakilder som Microsoft Fabric Data Warehouses, Microsoft Fabric Lakehouses, Microsoft Fabric Mirrored Databases, Microsoft Fabric SQL Databases og Azure SQL Databases. 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. Når det gjelder datalagre, må det defineres en primærnøkkel for at mutasjoner skal genereres automatisk.
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. Fabric genererer automatisk løsere når du legger ved en ny datakilde eller velger nye objekter som skal vises fra en eksisterende datakilde. Det er for øyeblikket ikke mulig å tilpasse løsere. 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?
API for GraphQL krever at programmer bruker Microsoft Entra ID for godkjenning. Klientprogrammet må være registrert og konfigurert tilstrekkelig til å utføre API-kall mot Fabric. 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. I tillegg til Microsoft Entra, hvis API-en er konfigurert til å bruke enkel pålogging (SSO), krever den godkjente brukeren eller tjenestekontohaveren i appen som kaller GraphQL-API-en , tilgang til både GraphQL-API-en og datakilden. Mer spesifikt kjøre spørringer og mutasjoner tillatelse i GraphQL API og lese eller skrive tilgang kreves i datakilden av valget tilsvarende. Et annet alternativ er å ha bruker- eller tjenestekontohaveren som medlem av arbeidsområdet med en bidragsyterrolle der både API-en og datakildeelementene er plassert, noe som gir nødvendig tilgang til begge elementene fra ett sted. Hvis du vil ha mer informasjon, kan du se Gi brukere tilgang til arbeidsområder. Hvis API-en er konfigurert til å bruke lagret legitimasjon, trenger den godkjente brukeren eller tjenestekontohaveren bare å ha tilgang til API-en (Velg Kjør spørringer og mutasjoner alternativet når du legger til direkte tilgangstillatelser til API-en). Du finner et eksempel fra ende til ende med eksempelkode for både brukerkontohavere og tjenestekontohavere 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. Vi planlegger imidlertid å støtte denne funksjonen i fremtiden og vil gi oppdateringer etter hvert som de blir tilgjengelige.
Jeg aktiverte Privat kobling for Fabric-leieren min. Hvorfor fungerer ikke GraphQL-elementene mine?
Hvis tenantinnstillingen «Blokker offentlig internett-tilgang» er aktivert (det vil eksempel: offentlig tilgang er deaktivert), deaktiveres eventuelle artefakter eller elementer som ikke støttes automatisk, inkludert API for GraphQL. Dette betyr at tidligere opprettede elementer ikke kan åpnes, og det kan heller ikke opprettes nye elementer. Den eneste måten å få tilgang til disse elementene på, er å gi offentlig tilgang.
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 hovedårsaker til denne virkemåten. Først kan den første forespørselen ta lengre tid hvis en datakilde må varmes opp hvis den er kald. Selv om datakilden ikke er kald, kan det hende at datahenting ikke er like effektiv første gang GraphQL utsteder en spørring, hvis datakilden ikke har de nødvendige dataene lastet inn i minnet. Den andre årsaken er at den første forespørselen til en API for GraphQL-endepunktet kan ta lengre tid fordi systemet må laste inn skjemaet og konfigurasjonen for å være klar til å godta forespørsler. Dette er en engangskostnad, og etterfølgende forespørsler er raskere fordi systemet allerede er varmet opp og klar til å betjene forespørslene dine. 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.