Jaa

Mikä on GraphQL:n Microsoft Fabric -ohjelmointirajapinta?

GraphQL on avoimen lähdekoodin kyselykieli ja ajonaikainen API-rajapinnoille, joita ylläpitää GraphQL Foundation. Toisin kuin perinteiset REST-rajapinnat, GraphQL mahdollistaa asiakkaiden pyytää tarkalleen tarvitsemansa tiedot yhdellä kyselyllä, mikä vähentää datan ylihakua ja alihakua.

Microsoft Fabric API for GraphQL tuo tämän tehokkaan standardin Fabric-ekosysteemiin datan käyttökerroksena, jonka avulla voit kysyä useita tietolähteitä nopeasti ja tehokkaasti. API abstraktii taustatietolähteiden yksityiskohdat, joten voit keskittyä sovelluksesi logiikkaan ja antaa kaikki asiakkaan tarvitsemat tiedot yhdellä kutsulla. Yksinkertaisen kyselykielensä ja tehokkaan tulosaineiston käsittelyn ansiosta GraphQL minimoi sovellusten käyttämän ajan datan käyttämiseen Fabricissa.

Miksi käyttää GraphQL:ää Fabric-dataan

Ilman GraphQL:ää Fabric-datan altistaminen sovelluksille vaatii tyypillisesti jonkin näistä lähestymistavoista:

Suorat tietokantayhteydet

  • Sovellukset yhdistyvät suoraan järvitaloihin tai varastoihin SQL-ajureiden (ODBC, JDBC) avulla
  • Sovelluskoodin tiiviisti yhdistäminen tietokantaskeemoihin – skeeman muutokset rikkovat sovelluksia
  • Vaatii yhteysmerkkijonojen, tunnistetietojen ja ajuririippuvuuksien hallintaa jokaisessa sovelluksessa
  • Sovelluskoodiin upotettuja SQL-kyselyitä on vaikea testata ja ylläpitää

Mukautetut REST-rajapinnat

  • Rakenna ja ylläpidä räätälöityjä taustapalveluita kehyksillä kuten ASP.NET tai Node.js
  • Kirjoita ohjainkoodia, reitityslogiikkaa ja datan käyttökerroksia jokaiselle päätepisteelle
  • Luo erilliset API-versiot (v1, v2, v3), kun tietorakenteet muuttuvat
  • Over-fetch data (hae kokonaisia rivejä, kun tarvitset vähän sarakkeita) tai under-fetch (tee useita edestakaisia matkoja saadaksesi liittyvää dataa)

GraphQL ratkaisee nämä haasteet:

  • Taustakoodia ei tarvita: Fabric generoi automaattisesti GraphQL-skeeman, ratkaisijat ja päätepisteet tietolähteistäsi
  • Kysy tarkalleen, mitä tarvitset: Pyydä tietyt kentät yhdellä kyselyllä, poistaen ylihaun ja pienentäen hyötykuorman kokoja
  • Hae liittyvää dataa yhdessä pyynnössä: Kulje suhteita ilman useita edestakaisia matkoja (ei N+1-kyselyongelmaa)
  • Skeeman kehitys rikkomatta muutoksia: Lisää uusia kenttiä vaikuttamatta olemassa oleviin kyselyihin – asiakkaat pyytävät vain sitä, mitä he tietävät
  • Tyypin turvallisuus ja dokumentaatio: Itsedokumentoiva skeema, jossa on sisäänrakennettu itsetutkiskelu ja kehitystyökalut ymmärtävät
  • Yhtenäinen pääsy useisiin lähteisiin: Kyselyt järvitalojen, varastojen ja SQL-tietokantojen välillä yhden päätepisteen kautta

Sovelluskehittäjille GraphQL tarkoittaa nopeampaa kehitystä vähemmällä infrastruktuurilla. Data-insinööreille se tarkoittaa datan altistamista ilman mukautetun API-koodin kirjoittamista ja ylläpitoa.

Kenen tulisi käyttää API:a GraphQL:lle

Fabricin GraphQL:n API on suunniteltu seuraaviin tarkoituksiin:

  • Sovelluskehittäjät rakentavat datalähtöisiä web- ja mobiilisovelluksia, jotka kuluttavat Fabric-lakehouse- ja varastodataa
  • Data-insinöörit altistavat Fabric-dataa alavirran sovelluksille nykyaikaisten, joustavien API-rajapintojen kautta ilman räätälöityä taustakoodin kirjoittamista
  • Integraatiokehittäjät , jotka yhdistävät Fabric-datan räätälöityihin sovelluksiin ja automatisoituihin työnkulkuihin
  • BI-kehittäjät luovat räätälöityjä analytiikkasovelluksia, jotka täydentävät Power BI:tä Fabric-datalla
  • Data-analyytikot esittelevät Fabric-dataa ja koneoppimisen oivalluksia ohjelmallisten API-rajapintojen kautta

Jos työskentelet Microsoft Fabricin yhtenäisen analytiikka-alustan parissa ja haluat tehdä lakehouse-, varasto- tai SQL-tietokantatiedot sovellusten saataville, GraphQL API tarjoaa tehokkaan ja kehittäjäystävällisen tavan hakea juuri tarvitsemasi data.

Tip

Haluatko integroida Fabric GraphQL API:t tekoälyagentteihin? Kokeile Build a local GraphQL MCP server for AI Agents -opasta yhdistääksesi tekoälyagentit Fabric-tietoihisi Model Context Protocolin avulla.

Tietojen paljastaminen GraphQL-ohjelmointirajapinnan kautta

Datalähteiden altistaminen GraphQL-kohteelle Microsoft Fabricissa on yksinkertaista ja onnistuu muutamassa minuutissa Fabric-portaalin visuaalisen käyttöliittymän avulla. Prosessi sisältää:

  1. Luo GraphQL API -kohde Fabric-työtilassasi
  2. Yhdistä tietolähteesi valitsemalla saatavilla olevista järvitaloista, varastoista tai tietokannoista
  3. Valitse, mitkä objektit paljastat , kuten taulukot, näkymät tai tallennetut proseduurit
  4. Määrittele objektien väliset suhteet (valinnainen) tehokkaan sisäkkäisen kyselyn mahdollistamiseksi
  5. Määritä käyttöoikeudet hallitsemaan, kuka pääsee API:isi käsiksi

Kun Fabric on konfiguroitu, se generoi automaattisesti GraphQL-skeeman, luo tarvittavat ratkaisijat ja antaa sinulle päätepisteen URL-osoitteen. API:si on heti valmis vastaanottamaan kyselyt – käyttöönottoa tai infrastruktuurin käyttöönottoa ei tarvita.

Vaiheittaiset ohjeet löytyvät kohdasta Create an API for GraphQL in Fabric ja lisää data.

Tuetut tietolähteet

Tällä hetkellä seuraavat tuetut tietolähteet näkyvät GraphQL:n Fabric-ohjelmointirajapinnan kautta:

  • Microsoft Fabric -tietovarasto
  • Microsoft Fabric SQL -tietokanta
  • Microsoft Fabric Lakehouse SQL Analytics Endpointin kautta
  • Microsoft Fabric peilatut tietokannat SQL Analytics Endpointin kautta, mukaan lukien:
    • Azure SQL -tietokanta
    • Hallittu Azure SQL -esiintymä
    • Azure Cosmos DB
    • Microsoft Fabric SQL -tietokanta
    • Azure Databricks
    • Snowflake
    • Avaa peilatut tietokannat
  • Azure SQL -tietokanta
  • Tietomart

Ominaisuudet

Microsoft Fabric API for GraphQL tarjoaa kattavat ominaisuudet, jotka helpottavat sovellusten tietojen käyttöä. Automaattisesta koodin generoinnista suorituskyvyn seurantaan nämä ominaisuudet mahdollistavat vahvojen datarajapintojen rakentamisen mahdollisimman vähäisellä konfiguraatiolla.

Automaattinen skeeman generointi

  • Skeeman löytäminen: Automaattisesti löytää ja kartoittaa tietolähdeskeemat GraphQL-tyyppeihin
  • Kyselyjen ja mutaatioiden generointi: Luo GraphQL-kyselyitä ja mutaatioita tietorakenteesi perusteella
  • Resolverin generointi: Generoi automaattisesti resolverit, joita tarvitaan datan hakemiseen lähteistäsi
  • Paikallinen testauskoodi: Tuottaa esimerkkikoodia välittömään testaukseen ja kehitykseen

Tietolähteiden joustavuus

  • Useita tietolähteitä: Yhdistä ja kysy useiden tietolähteiden välillä fan-out-kyselytuella
  • Tietokantaobjektit: Täysi tuki taulukoille, näkymille ja tallennetuille proseduureille SQL-tietokannoissa ja varastoissa
  • Valikoiva altistus: Valitse tietyt objektit ja sarakkeet, jotka näkyvät API:n kautta
  • Suhdemallinnus: Luo yksi-yhteen-, yksi-moneen ja moneen-moneen suhteita dataentiteettien välille

Toiminta ja seuranta

  • Suorituskyvyn seuranta: Sisäänrakennettu hallintapaneeli ja pyyntöjen lokitus API:n käyttäytymisen ja käytön seuraamiseen

Skeeman kehitys ilman versiointia

GraphQL lähestyy API:n kehitystä ainutlaatuisella tavalla välttämällä perinteistä versiointia. Sen sijaan, että luotaisiin v1-, v2- ja v3-päätepisteitä, GraphQL-rajapinnat kehittyvät jatkuvasti:

  • Additiiviset muutokset: Voit lisätä uusia tyyppejä, kenttiä ja ominaisuuksia rikkomatta olemassa olevia kyselyjä. Asiakkaat pyytävät vain tarvitsemansa kentät, joten uudet kentät eivät vaikuta heihin.
  • Taaksepäin yhteensopivuus: Olemassa olevat kyselyt toimivat edelleen, vaikka skeema kasvaa, koska GraphQL palauttaa vain nimenomaisesti pyydettyjä tietoja.
  • Vanhentuminen poiston sijaan: Kentät voidaan merkitä vanhentuneiksi sen sijaan, että ne poistettaisiin heti, jolloin asiakkaat voivat sopeutua.
  • Yksi päätepiste: Sovellukset yhdistävät aina samaan päätepisteeseen, riippumatta skeeman muutoksista.

Tämä lähestymistapa yksinkertaistaa API:n ylläpitoa ja asiakaspäivityksiä verrattuna perinteisiin versioituihin API-rajapintoihin. Kun muokkaat GraphQL API -skeemaasi Fabricissa, olemassa olevat sovellukset toimivat niin kauan kuin lisäät uusia ominaisuuksia sen sijaan, että poistat tai nimeäisit olemassa olevia kenttiä uudelleen. Lisätietoja skeemamuutosten hallinnasta löytyy Fabric API for GraphQL introspektion ja skeeman vienti.

Vuorovaikutteinen muokkauskokemus

GraphQL:n API sisältää editorin, jonka avulla voit kehittää ja testata kyselyitäsi ja mutaatioitasi helposti. Editorin ominaisuuksia ovat:

  • Tulosruutu, jossa visualisoidaan kyselyiden ja mutaatioiden tulos
  • Kysely- ja mutaatioparametrien tuki
  • Intellisense, joka tukee GraphQL-syntaksia ja skeemaobjektien nimiä

Lisätietoja GraphQL-editorin käytöstä löytyy osoitteesta API for GraphQL editori.

Rajoitukset

Katso lisätietoja API :sta GraphQL-rajoitukset .

Liittyvä sisältö

  • Last updated on