Szerkesztés

Megosztás a következőn keresztül:


Fabric API a GraphQL-hez – gyakori kérdések

Válaszokat találhat a GraphQL-hez gyakran feltett Fabric API-ra.

Mi az a GraphQL?

A GraphQL az API-k nyílt forráskód lekérdezési nyelve, és futtatókörnyezet, amellyel ezeket a lekérdezéseket a meglévő adatokkal teljesítheti. A GraphQL teljes és érthető leírást nyújt az API-ban lévő adatokról egy erősen gépelt rendszerrel, lehetővé teszi az ügyfelek számára, hogy pontosan azt kérdezzék meg, amire szükségük van, és semmi többre, megkönnyítik az API-k időbeli fejlődését, és hatékony fejlesztői eszközöket tesznek lehetővé.

Mi az a Microsoft Fabric API a GraphQL-hez?

A GraphQL-hez készült Microsoft Fabric API egy felügyelt szolgáltatás, amely lehetővé teszi, hogy másodpercek alatt létrehozhasson egy GraphQL API-t az olyan adatforrásokból származó adatok eléréséhez, mint a Microsoft Fabric Data Warehouses, a Microsoft Fabric Lakehouses, a Microsoft Fabric tükrözött adatbázisok, a Microsoft Fabric SQL Database-adatbázisok és az Azure SQL Database-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. Adattárházak esetén 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. 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. Jelenleg nem lehet 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 hozzáférésre van szüksége az adatforráshoz lekérdezések vagy mutációk végrehajtásához?

A GraphQL API-hoz az alkalmazásoknak Microsoft Entra-azonosítót kell használniuk a hitelesítéshez. Az ügyfélalkalmazást megfelelően kell regisztrálni és konfigurálni ahhoz, hogy API-hívásokat hajtsanak végre a Fabricen. A Microsoft Entra-ban regisztrált alkalmazáshoz GraphQLApi.Execute.All engedély szükséges a Power BI szolgáltatáshoz. További információ: Microsoft Entra-alkalmazás létrehozása az Azure-ban. A Microsoft Entra mellett, ha az API egyszeri bejelentkezés (SSO) használatára van konfigurálva, a GraphQL API-t hívó alkalmazás hitelesített felhasználójának vagy szolgáltatásnevének hozzáférésre van szüksége a GraphQL API-hoz és az adatforráshoz is. Pontosabban lekérdezések és mutációk futtatása a GraphQL API-ban, és ennek megfelelően olvasási vagy írási hozzáférés szükséges a választott adatforrásban. Egy másik lehetőség, hogy a felhasználó vagy a szolgáltatásnév munkaterületi tagként közreműködői szerepkörrel rendelkezik, ahol az API és az adatforrás elemei is találhatók, ami biztosítja a szükséges hozzáférést mindkét elemhez egyetlen helyről. További információt a munkaterületekhez való hozzáférés biztosítása a felhasználóknak című témakörben talál. Ha az API a mentett hitelesítő adatok használatára van konfigurálva, a hitelesített felhasználónak vagy szolgáltatásnévnek csak hozzáféréssel kell rendelkeznie az API-hoz (válassza a Lekérdezések és mutációk futtatása lehetőséget, amikor közvetlen hozzáférési engedélyeket ad hozzá az API-hoz). A Connect Applicationsben egy végpontok közötti példát találhat, amely mintakódot biztosít a felhasználói tagok és a szolgáltatásnevek számára is.

Hogyan nyisson meg egy támogatási jegyet a GraphQL-hez készült API-hoz?

Ha segítségre van szüksége Microsoft ügyfélszolgálata 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 adatmérnök lehetőséget.

Mely régiókat még nem támogatja a GraphQL API?

A GraphQL API jelenleg nem támogatott az USA 3. nyugati régiójában.

Támogatja a Private Linket a GraphQL API?

A GraphQL API jelenleg nem támogatja a Private Linket. Azt tervezzük azonban, hogy a jövőben támogatni fogjuk ezt a funkciót, és amint elérhetővé válnak, frissítéseket biztosítunk.

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 viselkedésnek két fő oka van. Először is az első kérés hosszabb időt vehet igénybe, ha egy adatforrást fel kell melegíteni, ha hideg. 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. A második ok az, hogy a GraphQL-végponthoz tartozó API-ra irányuló első kérés hosszabb időt vehet igénybe, mert a rendszernek be kell töltenie a sémát és a konfigurációt, hogy készen álljon a kérések elfogadására. Ez egyszeri költség, és a későbbi kérések gyorsabbak lesznek, mivel a rendszer már be van melegítve, és készen áll a kérések kiszolgálására.

Hogyan adhatok visszajelzést vagy javaslatokat a GraphQL API-hoz?

Örömmel fogadjuk visszajelzését és javaslatait! Visszajelzést Hálóötletek. Csapatunk aktívan figyeli a platformon keresztül küldött visszajelzéseket és javaslatokat. A Microsoft Fabric támogatási keresztül is kapcsolatba lép velünk bármilyen konkrét kérdés vagy probléma esetén.