Válaszokat találhat a GraphQL-hez gyakran feltett Fabric API-ra.
Mi az a GraphQL?
A GraphQL az API-k lekérdezési nyelve, amellyel az alkalmazások pontosan a szükséges adatokat kérhetik le. A következő fő előnyöket nyújtják:
- Erős típusú rendszer – Egyértelműen leírja a rendelkezésre álló adatokat
- Pontos adatlekérés – Csökkenti a túlzott adatlekérést az adott kérések lehetővé tételével
- Visszamenőleges kompatibilitás – Egyszerűbbé teszi az API-frissítéseket a meglévő kód feltörése nélkül
- Rich tooling – Lehetővé teszi a developer tools széles halmazának használatát
Ez hatékonyabb módja annak, hogy az alkalmazások kommunikáljanak a kiszolgálókkal és az adatbázisokkal.
Mi az a Microsoft Fabric API a GraphQL-hez?
Microsoft Fabric GraphQL API egy felügyelt szolgáltatás, amely lehetővé teszi a GraphQL API másodpercek alatt történő létrehozását.
Támogatott adatforrások:
- Microsoft Fabric adattárházak
- Microsoft Fabric Lakehouses
- Microsoft Fabric tükrözött adatbázisok
- SQL-adatbázisok Microsoft Fabric
- Azure SQL adatbázisok
Egységes API-réteget biztosít a támogatott adatforrásokból származó adatok lekérdezéséhez és mutálásához.
Milyen GraphQL-műveleteket támogat a Fabric API a GraphQL-hez?
Jelenleg csak a GraphQL-lekérdezések (olvasás) és a mutációk (írás) támogatottak. Az SQL Analytics-végpontokon keresztül közzétett adatforrások írásvédettek, így csak a lekérdezéseket támogatják. Az adattárházak esetében meg kell határozni egy elsődleges kulcsot a mutációk automatikus létrehozásához.
Hogyan tekinthetem meg és szerkeszthetim a feloldókat a Fabric API for GraphQL-ben?
A feloldók olyan GraphQL-összetevők, amelyek üzleti logikát biztosítanak az API mezőinek feloldásához és az adatforrásokban található adatokkal végzett műveletek végrehajtásához.
Automatikus létrehozás: A Fabric automatikusan létrehoz feloldókat, amikor új adatforrást csatol, vagy új objektumokat választ ki, hogy egy meglévő adatforrásból legyenek közzétéve.
Testreszabási: Jelenleg nem lehet közvetlenül testre szabni a feloldókat. A GraphQL API-ban testre szabott üzleti logikához létrehozhat egy tárolt eljárást az adatforrásban, és közzéteheti a GraphQL API-ban.
A GraphQL-ügyfélalkalmazás API-jának szüksége van access az adatforrásra lekérdezések vagy mutációk végrehajtásához?
Microsoft Entra ID hitelesítés: A GraphQL API-hoz az alkalmazásoknak Microsoft Entra ID kell használniuk a hitelesítéshez. Az ügyfélalkalmazást regisztrálni kell, és úgy kell konfigurálni, hogy API-hívásokat hajtson végre a Fabricen.
Szükséges engedélyek:
- A Microsoft Entra-ban regisztrált alkalmazáshoz a Power BI szolgáltatás számára GraphQLApi.Execute.All engedély szükséges. További információ: Microsoft Entra-alkalmazás létrehozása Azure.
Az egyszeri bejelentkezés (SSO) konfigurációja: Ha az API SSO használatára van konfigurálva, a hitelesített felhasználónak vagy szolgáltatásnévnek hozzáférésre van szüksége mindkettőhöz:
- A GraphQL API (Lekérdezések és mutációk futtatása engedély)
- Az adatforrás (szükség esetén olvasási vagy írási hozzáférés)
Munkatérszintű hozzáférési beállítás: Másik lehetőségként rendelje hozzá a felhasználót vagy a szolgáltatásprincipálist munkaterület-tagként egy közreműködői szerepkörrel, ahol az API és az adatforrás elemei is találhatók. Ez biztosítja a szükséges hozzáférést mindkét elemhez egyetlen helyről. További információ: Felhasználók hozzáférésének biztosítása munkaterületekhez.
Mentett hitelesítő adatok konfigurációja: Ha az API mentett hitelesítő adatok használatára van konfigurálva, a hitelesített felhasználónak vagy szolgáltatásnévnek csak access kell az API-hoz (válassza a Lekérdezések és mutációk futtatása lehetőséget, amikor közvetlen access engedélyeket ad hozzá az API-hoz).
Példák: A Connect Applications-ban találhat egy teljes körű példát, amely mintakódot tartalmaz mind a felhasználói példányok, mind a szolgáltatási példányok számára.
Hogyan nyissak egy támogatási jegyet a GraphQL API-hoz?
Ha segítségre van szüksége Microsoft Support a Fabric API for GraphQL-hez kapcsolódó problémákról, látogasson el a Fabric támogatási webhelyére és válassza a Data Engineering lehetőséget.
A GraphQL API támogatja a Private Linket?
A GraphQL API jelenleg csak Tenant szintű Private Link támogat.
Miért teljesít rosszul a kérésem az első alkalommal, amikor kiadom, majd jól teljesít a későbbi kéréseken?
Ennek a "hideg indítás" viselkedésnek két fő oka van:
Adatforrások bemelegítésének beállítása:
- Az első kérés hosszabb időt vehet igénybe, ha egy adatforrást hideg állapotból kell bemelegíteni
- Még ha az adatforrás nem is hideg, előfordulhat, hogy az adatlekérés nem lesz olyan hatékony, amikor a GraphQL először ad ki lekérdezést, ha az adatforrás nem tölti be a szükséges adatokat a memóriába
API-végpont inicializálása:
- A GraphQL-végponthoz tartozó API első kérése hosszabb időt vehet igénybe, mert a rendszernek be kell töltenie a sémát és a konfigurációt
- A további kérések gyorsabbak, mert a rendszer már be van melegítve, és készen áll a kérések kiszolgálására
További információt a teljesítményre vonatkozó ajánlott eljárásokban talál.
Hogyan adhatok visszajelzést vagy javaslatokat a GraphQL API-hoz?
Örömmel fogadjuk visszajelzését és javaslatait! Visszajelzést adhat a Fabric Ideas segítségével. Csapatunk aktívan figyeli a platformon keresztül küldött visszajelzéseket és javaslatokat. A Microsoft Fabric Ügyfélszolgálaton keresztül is kapcsolatba lép velünk az esetlegesen felmerülő kérdések vagy problémák esetén.