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. Tärkeimpiä etuja ovat seuraavat:
- Vahva tyyppijärjestelmä – Kuvaa selkeästi saatavilla olevat tiedot
- Tarkka tiedonhaku – Vähentää ylihakua sallimalla tietyt pyynnöt
- Taaksepäin yhteensopivuus – Helpottaa API-päivityksiä rikkomatta olemassa olevaa koodia
- Rikkaat työkalut - Mahdollistaa laajan valikoiman developer tools
Se on sovellusten tehokkaampi tapa viestiä palvelimien ja tietokantojen kanssa.
Mikä on Microsoft Fabric API GraphQL:lle?
Microsoft Fabric API for GraphQL on hallittu palvelu, jonka avulla voit luoda GraphQL-rajapinnan sekunneissa.
Tuetut tietolähteet:
- Microsoft Fabric Data Warehouses
- Microsoft Fabric Lakehouses
- Microsoft Fabric peilatut tietokannat
- Microsoft Fabric SQL Databases
- Azure SQL Databases
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ä. Data Warehousesissa mutaatioiden automaattiseen generointiin tarvitaan ensisijaisen avain.
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.
Automaattinen generointi: Fabric generoi automaattisesti ratkaisijoita aina, kun liität uuden tietolähteen tai valitset uusia objekteja avoimeksi olemassa olevasta tietolähteestä.
Muokkaus: Tällä hetkellä resolvereita ei voi muokata suoraan. GraphQL-ohjelmointirajapinnan mukautetun liiketoimintalogiikan avulla voit luoda tallennetun toimintosarjan tietolähteeseen ja paljastaa sen GraphQL-ohjelmointirajapinnassa.
Vaatiiko GraphQL-asiakassovelluksen API access tietolähteeseen kyselyjen tai mutaatioiden suorittamiseksi?
Microsoft Entra ID autentikointi: GraphQL:n API vaatii sovelluksia käyttämään Microsoft Entra ID tunnistautumiseen. Asiakassovelluksesi täytyy rekisteröidä ja konfiguroida suorittamaan API-kutsuja Fabricia vastaan.
Tarvittavat käyttöoikeudet:
- Microsoft Entraan rekisteröity sovellus vaatii GraphQLApi.Execute.All -oikeudet Power BI service:lle. Lisätietoja löytyy osoitteesta Luo Microsoft Entra -sovellus Azure.
Kertakirjautumisen (SSO) konfiguraatio: Jos API on konfiguroitu käyttämään SSO:ta, todennettu käyttäjä tai palvelupäähenkilö vaatii access molempiin:
- GraphQL-rajapinta (Suorita kyselyt ja mutaatiot )
- Tietolähde (luku- tai kirjoitusaccess tarpeen mukaan)
Workspace-tason access-vaihtoehto: Vaihtoehtoisesti voit määrittää käyttäjä tai palvelupäähenkilö työtilan jäseneksi, jolla on contributor role jossa sekä API:n että tietolähdeelementit sijaitsevat. Tämä antaa vaaditun access molempiin esineisiin samasta paikasta. Lisätietoja löytyy osoitteesta Anna käyttäjille access työtilat.
Saved credentials configuration: Jos API on konfiguroitu käyttämään tallennettuja tunnistetietoja, autentikoidun käyttäjän tai palvelupäähenkilön tarvitsee vain access API:lle (valitse Suorita kyselyt ja mutaatiot kun lisäät suorat access-oikeudet API:iin).
Esimerkkejä: Voit löytää päästä päähän -esimerkin, jossa on esimerkkikoodi sekä käyttäjäperiaatteille että palveluperiaatteilleConnect Applicationsista.
How do I avaan tukipyynnön API:lle GraphQL:lle?
Jos haluat Microsoft Support:ltä apua kaikissa Fabric API for GraphQL -ongelmiin liittyen, vieraile Fabric Support -sivustollamme ja valitse Data Engineering -vaihtoehto.
Tukeeko API GraphQL:lle Private Link?
API for GraphQL tukee tällä hetkellä vain Tenant Level Private Link -toimintoja.
Miksi pyyntöni toimii huonosti, kun ensimmäisen kerran myönnän sen, ja suoriutun sitten hyvin myöhemmissä pyynnöissä?
Tälle "kylmäkäynnistykselle" on kaksi pääsyytä:
Datalähteen lämmittely:
- Ensimmäinen pyyntö voi kestää kauemmin, jos tietolähde täytyy lämmittää kylmästä tilasta
- Vaikka tietolähde ei olisi kylmä, tietojen hakeminen ei välttämättä ole yhtä tehokasta ensimmäisellä kerralla, kun GraphQL lähettää kyselyn, jos tietolähteellä ei ole tarvittavaa dataa ladattu muistiin
API:n päätepisteen alustus:
- Ensimmäinen pyyntö API:lle GraphQL-päätepisteelle saattaa kestää kauemmin, koska järjestelmän täytyy ladata skeemasi ja konfiguraatiosi
- Seuraavat pyynnöt ovat nopeampia, koska järjestelmä on jo lämmitetty ja valmis palvelemaan pyyntöjäsi
Lisätietoja suorituskyvyn parhaista käytännöistä löytyy.
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 myös ottaa meihin yhteyttä Microsoft Fabric Support kautta erityisissä kysymyksissä tai huolissasi.