Fabric-ohjelmointirajapinta GraphQL-rakennenäkymälle ja Schema Explorerille
GraphQL-rakenne, joka perustuu GraphQL Schema Definition Language (SDL) -kieleen, määrittää ohjelmointirajapinnassa näkyvien tietojen muodon. Se on abstraktiokerros, joka tarjoaa joustavuutta kuluttajille, kun he piilottavat taustan toteutustietoja. Rakenne perustuu kenttiä sisältävien objektityyppien kokoelmaan.
Rakennenäkymä
Voit käyttää rakennenäkymää valitsemalla Rakenne Tietojen kehitys -näytön vasemmasta alakulmasta. Näkymä näyttää GraphQL SDL:n tekstipohjaisen version, joka sisältää luodut tyypit, kentät ja toiminnot.
Seuraava kuva on esimerkki rakennenäkymästä, joka sisältää laajan luettelon tässä rakenteessa käytettävissä olevista objekteista.
Muistiinpano
Rakennenäkymä on vain luku -tilassa. Voit muokata objekteja vain rakenteen hallinnassa.
Rakenteen hallinta
Rakenteen hallinta sijaitsee vasemmalla olevassa ruudussa, ja se on myös käytettävissä, kun käytät editoria kyselynäkymässä. Resurssienhallinnan avulla käyttäjät voivat nopeasti visualisoida ohjelmointirajapinnassa määritettyjä käytettävissä olevia tyyppejä ja kenttiä sekä kyselyitä ja mutaatioita.
Kaikki GraphQL-tyypit, jotka ovat käytettävissä tietolähteeseen yhdistettäessä valitsemistasi objekteista, näkyvät Rakenteen hallinta -luettelossa. Tyypit näkyvät sen tietolähteen nimen alla, josta ne johdettiin. Seuraavassa kuvassa näet SalesOrderDetail-tyypin, joka on johdettu SalesOrderDetail-taulukosta AdventureWorks SQL -analytiikan päätepisteessä.
Tyyppien lisäksi GraphQL:n Fabric-ohjelmointirajapinta luo automaattisesti kyselyjä ja mutaatioita kaikille uusille objekteille, jotka haluat paljastaa.
AdventureWorks-esimerkissä kyselyluettelon laajentaminen näyttää tietolähteelle automaattisesti luodut kyselyt.
Jos haluat nähdä ohjelmointirajapinnan automaattisesti luomat mutaatiot, laajenna mutaatiosolmu Rakennehallinta-puussa.
Objektien muokkaaminen Schema Explorerin avulla
Schema Explorerin avulla voit muokata objekteja sen jälkeen, kun ohjelmointirajapinta on luonut ne puolestasi. Seuraavassa esimerkissä valitaan kolme pistettä AdventureWorks-tietokannasta johdettujen SalesOrderDetail-tyyppien vierestä:
Tyypit-kohdassa on käytettävissä seuraavat asetukset:
- Päivitä rakenne : tämän avulla voit päivittää rakenteen tietolähteen uusilla objekteilla.
- Nimeä uudelleen : tämä muuttaa objektin nimeä. HUOMAA: Tämä muutos vaikuttaa vain ohjelmointirajapinnan rakenteeseen eikä vaikuta alkuperäiseen tietolähdeobjektiin, josta se on johdettu.
- Poista rakkeesta : Tämä poistaa objektin GraphQL-rakenteen sisältä, jotta et voi enää viitata siihen.
- Suhteiden hallinta – Pääset suhteiden hallintatoimintoon. Lisätietoja on artikkelissa Suhteiden hallinta Fabric-ohjelmointirajapinnassa GraphQL:lle.
- Ominaisuudet – Näyttää lisätietoja objektista.
Kyselyjen ja mutaatioiden ottaminen käyttöön ja poistaminen käytöstä
Kyselyiden ja mutaatioiden ota käyttöön tai poista käytöstä -ominaisuus tarjoaa järjestelmänvalvojille ja kehittäjille avatun ohjelmointirajapinnan käytön hallinnan. Sen avulla voit aktivoida tai poistaa tiettyjen kyselyjen ja mutaatioiden aktivoinnin tai deaktivoinnin GraphQL-rakenteessa. Tämän avulla voit hallita ohjelmointirajapinnan ominaisuuksia dynaamisesti muokkaamatta koodia tai ottamalla käyttöön muutoksia.
Kyselyillä ja mutaatioilla rakenteen hallinnassa on kaksi muuta vaihtoehtoa:
- Disable – estää pyyntöjä suorittamasta kyselyä tai mutaatiota. Jos suoritusta yritetään, palautetaan virhe. Kun kysely tai mutaatio on poistettu käytöstä, rakenne ladataan uudelleen ja kysely tai mutaatio näkyy harmaana rakenteen hallinnassa.
- Enable – ota aiemmin poistettu käytöstä oleva kysely tai mutaatio uudelleen. Kohteen suorittaminen on heti käytettävissä, kun rakenteen uudelleenlataustoiminto suoritetaan, kun olet valinnut Ota käyttöön -asetuksen.
Huomaa, että tallennetuista toimintosarjoista automaattisesti luodut kyselyt tai mutaatiot voidaan vain poistaa. Kun ne on poistettu, ne voidaan lisätä uudelleen käyttämällä Nouda tiedot - tai Päivitä rakenne -asetuksia.