Fabric API for GraphQL vanlige spørsmål

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
• Rich tooling - Muliggjør bruk av et bredt sett av developer tools

Det er en mer effektiv måte for programmer å kommunisere med servere og databaser på.

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 Data Warehouses
• Microsoft Fabric Lakehouses
• Microsoft Fabric speilede databaser
• Microsoft Fabric SQL-databaser
• Azure SQL Databases

Det gir et enhetlig API-lag for spørring og demping av data fra disse støttede datakildene.

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.

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.

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 registrert i Microsoft Entra krever GraphQLApi.Execute.All tillatelser for Power BI service. For mer informasjon, se Opprett en Microsoft Entra-app i Azure.

Single sign-on (SSO) konfigurasjon: Hvis API-et er konfigurert til å bruke SSO, krever den autentiserte brukeren eller tjenestelederen access til begge:

• GraphQL API-et (Run Queries and Mutations-tillatelse )
• Datakilden (lese- eller skrive-access etter behov)

Workspace-nivå access valg: Alternativt kan du tildele brukeren eller tjenesteprincipalen som arbeidsområdemedlem med en bidragsyterrolle hvor både API- og datakildeelementene er plassert. Dette gir nødvendig access til begge elementene fra ett sted. For mer informasjon, se Gi brukere access til arbeidsområder.

Konfigurasjon av lagrede legitimasjoner: Hvis API-et er konfigurert til å bruke lagrede legitimasjoner, trenger den autentiserte brukeren eller tjenestelederen bare access til API-et (velg Run Queries and Mutations-alternativet når du legger til direkte access-tillatelser i API-et).

Eksempler: Du kan finne et ende-til-ende-eksempel med eksempelkode for både brukerprinsipper og tjenesteprinsipper hos Connect Applications.

For å få hjelp fra Microsoft Support om ethvert problem relatert til Fabric API for GraphQL, besøk vår Fabric Support og velg alternativet Data Engineering.

API for GraphQL støtter foreløpig kun Tenant Level Private Link.

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.

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ørsmål eller bekymringer.

Relatert innhold

Hva er Microsoft Fabric API for GraphQL?