Etsi vastauksia usein kysyttyihin Fabric-ohjelmointirajapintaan GraphQL-kysymyksiä varten.
Mikä on GraphQL?
GraphQL on ohjelmointirajapinnoille tarkoitettu kyselykieli, jonka avulla sovellukset voivat pyytää juuri tarvitsemiaan tietoja. Se käyttää vahvaa tyyppijärjestelmää kuvaamaan selvästi saatavilla olevia tietoja, vähentää yli noutamista sallimalla tarkat pyynnöt, helpottaa ohjelmointirajapinnan päivityksiä rikkomatta olemassa olevaa koodia ja mahdollistaa laajan kehittäjätyökalujen joukon käytön. Se on sovellusten tehokkaampi tapa viestiä palvelimien ja tietokantojen kanssa.
Mikä on GraphQL:n Microsoft Fabric -ohjelmointirajapinta?
Microsoft Fabric -ohjelmointirajapinta GraphQL:lle on hallittu palvelu, jonka avulla voit luoda GraphQL-ohjelmointirajapinnan sekunneissa päästäksesi käsiksi tietolähteisiisi, kuten Microsoft Fabric -tietovarastoihin, Microsoft Fabric Lakehousesiin, Microsoft Fabric Mirrored -tietokantoihin, Microsoft Fabric SQL -tietokantoihin ja Azure SQL -tietokantoihin. Se tarjoaa yhtenäisen ohjelmointirajapintakerroksen näiden tuettujen tietolähteiden tietojen kyselemiseen ja mutaatioon.
Mitä GraphQL-toimintoja GraphQL:n Fabric-ohjelmointirajapinnassa tuetaan?
Tällä hetkellä tuetaan vain GraphQL-kyselyitä (luku) ja mutaatioita (kirjoitus). SQL Analytics -päätepisteiden kautta paljastetut tietolähteet ovat vain luku -tilassa, joten ne tukevat vain kyselyitä. Tietovarastojen tapauksessa on määritettävä perusavain, jotta mutaatiot voidaan luoda automaattisesti.
Miten voin tarkastella ja muokata resolver-rakenteita GraphQL:n Fabric-ohjelmointirajapinnassa?
Resolvers ovat GraphQL-komponentteja, jotka tarjoavat liiketoimintalogiikan ohjelmointirajapinnan kenttien ratkaisemiseen ja toimintojen suorittamiseen tietolähteissä olevien tietojen avulla. Fabric luo ratkaisevat kohteet automaattisesti aina, kun liität uuden tietolähteen tai valitset aiemmin luodusta tietolähteestä näytettävät uudet objektit. Tällä hetkellä ratkaisejia ei voi mukauttaa. GraphQL-ohjelmointirajapinnan mukautetun liiketoimintalogiikan avulla voit luoda tallennetun toimintosarjan tietolähteeseen ja paljastaa sen GraphQL-ohjelmointirajapinnassa.
Edellyttääkö GraphQL-asiakassovelluksen ohjelmointirajapinta tietolähteen käyttöoikeutta kyselyjen tai mutaatioiden suorittamiseksi?
GraphQL-ohjelmointirajapinta edellyttää, että sovellukset käyttävät Microsoft Entra -tunnusta todentamiseen. Asiakassovellus on rekisteröitävä ja määritettävä riittävästi API-kutsujen suorittamiseksi Fabricia vastaan. Microsoft Entraan rekisteröity sovellus edellyttää GraphQLApi.Execute.All -käyttöoikeuksia Power BI -palveluun. Lisätietoja on artikkelissa Microsoft Entra -sovelluksen luominen Azuressa. Jos ohjelmointirajapinta on määritetty käyttämään kertakirjautumista (SSO) Microsoft Entran lisäksi, GraphQL-ohjelmointirajapintaa kutsuvan sovelluksen todennettu käyttäjä tai palvelun päänimi edellyttää käyttöoikeutta sekä GraphQL-ohjelmointirajapintaan että tietolähteeseen. Tarkemmin sanottuna Suorita kyselyitä ja mutaatioita -käyttöoikeudet GraphQL-ohjelmointirajapinnassa ja lue tai kirjoita käyttöoikeus, joka vaaditaan valitsemassasi tietolähteessä. Toinen vaihtoehto on antaa käyttäjän tai palvelun päänimen olla työtilan jäsen, jolla on osallistujan rooli,, jossa sekä ohjelmointirajapinta että tietolähdekohteet sijaitsevat, mikä antaa vaaditun käyttöoikeuden molempiin kohteisiin yhdestä paikasta. Lisätietoja on artikkelissa Työtilojen käyttöoikeuksien antaminen käyttäjille. Vaihtoehtoisesti jos ohjelmointirajapinta on määritetty käyttämään tallennettuja tunnistetietoja, todennetun käyttäjän tai palvelun päänimen tarvitsee vain käyttää ohjelmointirajapintaa (Valitse Suorita kyselyt ja mutaatiot -vaihtoehto, kun lisäät suoria käyttöoikeuksia ohjelmointirajapintaan). Löydät päästä päähän -esimerkin, jossa on esimerkkikoodi sekä käyttäjien päänimille että palvelun päänimille kohdasta Sovellusten yhdistäminen.
Miten voin avata GraphQL-ohjelmointirajapinnan tukipalvelupyynnön?
Jos haluat ohjeita Microsoft-tuesta mistä tahansa GraphQL:n Fabric-ohjelmointirajapintaan liittyvistä ongelmasta, siirry Fabric-tukisivustollemme ja valitse Tietotekniikka-vaihtoehto.
Mitä alueita GraphQL-ohjelmointirajapinta ei vielä tue?
GraphQL-ohjelmointirajapintaa ei tällä hetkellä tueta Länsi-Yhdysvallat 3 -alueella.
Tukeeko GraphQL-ohjelmointirajapinta yksityistä linkkiä?
GraphQL:n ohjelmointirajapinta ei tue yksityistä linkkiä tällä hetkellä. Aiomme kuitenkin tukea tätä ominaisuutta tulevaisuudessa ja tarjota päivityksiä, kun ne tulevat saataville.
Olen ottanut yksityisen linkin käyttöön Fabric-vuokraajalleni. Miksi GraphQL-kohteeni eivät toimi?
Jos vuokraaja-asetus Estä julkinen Internet-yhteys on käytössä (eli julkinen käyttö on poistettu käytöstä), kaikki artefaktit tai kohteet, joita ei tueta, poistetaan automaattisesti käytöstä, mukaan lukien GraphQL:n ohjelmointirajapinta. Tämä tarkoittaa sitä, että aiemmin luotuja kohteita ei voi käyttää eikä uusia luoda. Ainoa tapa käyttää näitä kohteita on sallia julkinen käyttö.
Miksi pyyntöni toimii huonosti, kun ensimmäisen kerran myönnän sen, ja suoriutun sitten hyvin myöhemmissä pyynnöissä?
Tähän toimintaan on kaksi pääsyytä. Ensimmäinen pyyntö voi kestää kauemmin, jos tietolähde täytyy lämmittää, jos se on kylmä. Vaikka tietolähde ei olisikaan kylmä, tietojen noutaminen ei ehkä ole yhtä tehokasta, kun GraphQL lähettää kyselyn ensimmäisen kerran, jos tietolähteellä ei ole tarvittavia muistiin ladattuja tietoja. Toinen syy on se, että ensimmäinen pyyntö GraphQL-päätepisteen ohjelmointirajapintaan voi kestää kauemmin, koska järjestelmän on ladattava rakenne ja määritys, jotta se voi hyväksyä pyynnöt. Se tulee kertakustannuksena, ja myöhemmät pyynnöt ovat nopeampia, koska järjestelmä on jo lämmitetty ja valmis palvelemaan pyyntöjäsi.
Miten voin antaa palautetta tai ehdotuksia GraphQL:n ohjelmointirajapinnalle?
Otamme palautteesi ja ehdotuksesi vastaan! Voit antaa palautetta Fabric Ideaskautta. Tiimimme valvoo aktiivisesti tämän ympäristön kautta lähetettyjä ehdotuksia. Voit ottaa meihin yhteyttä myös Microsoft Fabric -tuen, jos sinulla on tiettyjä kyselyjä tai huolenaiheita.