Mi az a Microsoft Fabric API a GraphQL-hez?

A GraphQL a GraphQL Foundation által fenntartott API-k nyílt forráskódú lekérdezési nyelve és futtatókörnyezete. A hagyományos REST API-któl eltérően a GraphQL lehetővé teszi az ügyfelek számára, hogy pontosan azokat az adatokat kérik le, amelyekre egyetlen lekérdezésben szükségük van, így csökkentve az adatok túlzott lekérését és alulhívását.

A GraphQL-hez készült Microsoft Fabric API ezt a hatékony szabványt adatelérési rétegként hozza létre a Fabric-ökoszisztémában, amely lehetővé teszi több adatforrás gyors és hatékony lekérdezését. Az API absztrakciókat alkalmaz a háttérbeli adatforrások jellemzőire, így ön az alkalmazás logikájára összpontosít, és egyetlen hívásban adja meg az ügyfél által igényelt összes adatot. Egyszerű lekérdezési nyelvével és hatékony eredményhalmaz-kezelésével a GraphQL minimalizálja az alkalmazások által a Fabricben tárolt adatokhoz való hozzáféréshez szükséges időt.

Miért érdemes a GraphQL for Fabric-adatokat használni?

A GraphQL nélkül a Fabric-adatok alkalmazásoknak való közzététele általában az alábbi módszerek egyikét igényli:

Közvetlen adatbázis-kapcsolatok

Az alkalmazások közvetlenül csatlakoznak a tóházakhoz vagy a raktárakhoz SQL-illesztőprogramokkal (ODBC, JDBC)
Szorosan összekapcsolja az alkalmazáskódot az adatbázissémákhoz – a sémamódosítások megszakítják az alkalmazásokat
Kapcsolati sztringek, hitelesítő adatok és illesztőprogram-függőségek kezelését igényli minden alkalmazásban
Az alkalmazáskódba beágyazott SQL-lekérdezéseket nehéz tesztelni és karbantartani

Egyéni REST API-k

Egyéni háttérszolgáltatások létrehozása és karbantartása olyan keretrendszerekkel, mint ASP.NET vagy Node.js
Vezérlőkód, útválasztási logika és adatelérési rétegek írása minden végponthoz
Külön API-verziók létrehozása (v1, v2, v3) az adatstruktúrák változásakor
Túlzott adatlekérés (amikor kevés oszlopra van szüksége, de teljes sorokat kér le), vagy elégtelen adatlekérés (több körúttal kapcsolódó adatokért)

A GraphQL az alábbi kihívásokat oldja meg:

Nincs szükség háttérkódra: A Fabric automatikusan létrehozza a GraphQL-sémát, a feloldókat és a végpontot az adatforrásokból
Pontosan a szükséges adatok lekérdezése: Adott mezők kérése egyetlen lekérdezésben, a túlhívás kiküszöbölése és a hasznos adatok méretének csökkentése
Kapcsolódó adatok beolvasása egyetlen kérelemben: Több körút nélküli Traverse-kapcsolatok (nincs N+1 lekérdezési probléma)
Sémafejlődés kompatibilitási változások nélkül: Új mezők hozzáadása meglévő lekérdezések befolyásolása nélkül – az ügyfelek csak azt kérik, amit tudnak
Típusbiztonság és dokumentáció: Öndokumentumoló séma beépített bevezetővel, amelyet a fejlesztői eszközök ismernek
Egyesített hozzáférés több forráshoz: Lekérdezés több lakehouse-on, raktáron és SQL-adatbázison keresztül egyetlen végponton keresztül

Az alkalmazásfejlesztők számára a GraphQL gyorsabb fejlesztést jelent kevesebb infrastruktúrával. Az adatmérnökök számára ez azt jelenti, hogy az adatok felfedése egyéni API-kód írása és karbantartása nélkül.

Ki használja az API-t a GraphQL-hez?

A Fabric API for GraphQL a következő célokra lett kialakítva:

Az alkalmazásfejlesztők olyan adatvezérelt webes és mobilalkalmazásokat építenek ki, amelyek Fabric lakehouse- és raktáradatokat használnak fel
Az adatmérnökök modern, rugalmas API-k használatával, egyéni háttérkód írása nélkül írják ki a Fabric-adatokat az alsóbb rétegbeli alkalmazásoknak
Integrációs fejlesztők, amelyek hálóadatokat csatlakoztatnak egyéni alkalmazásokhoz és automatizált munkafolyamatokhoz
Egyéni elemzési alkalmazásokat létrehozó BI-fejlesztők, amelyek a Power BI-t a Fabric-adatokkal egészítik ki
Az adattudósok programozott API-kon keresztül tárják fel a Fabric-adatokat és a gépi tanulási elemzéseket

Ha a Microsoft Fabric egyesített elemzési platformon dolgozik, és elérhetővé kell tennie a lakehouse-, raktár- vagy SQL-adatbázisadatokat az alkalmazások számára, a GraphQL API hatékony, fejlesztőbarát módot kínál a szükséges adatok pontos lekérdezésére.

Jótanács

Szeretné integrálni a Fabric GraphQL API-kat az AI-ügynökökkel? Próbálja ki a Helyi GraphQL MCP-kiszolgáló létrehozása AI-ügynökökhöz című oktatóanyagot, amellyel AI-ügynököket csatlakoztathat a Fabric-adatokhoz a Model Context Protocol használatával.

Adatok közzététele a GraphQL API-n keresztül

Az adatforrások a Microsoft Fabric graphQL-elemének való közzététele egyszerű, és a Fabric portál vizuális felületének használatával percek alatt elvégezhető. A folyamat a következőket foglalja magában:

GraphQL API-elem létrehozása a Fabric-munkaterületen
Kapcsolja össze az adatforrásokat az elérhető lakehouse-ok, raktárak vagy adatbázisok kiválasztásával
Adja meg, hogy mely objektumokat tegye elérhetővé , például táblákat, nézeteket vagy tárolt eljárásokat
Objektumok közötti kapcsolatok definiálása (nem kötelező) a hatékony beágyazott lekérdezések engedélyezéséhez
Engedélyek konfigurálása annak szabályozásához, hogy ki férhet hozzá az API-hoz

A konfigurálás után a Fabric automatikusan létrehozza a GraphQL-sémát, létrehozza a szükséges feloldókat, és megadja a végpont URL-címét. Az API azonnal készen áll a lekérdezések elfogadására – nincs szükség üzembe helyezésre vagy infrastruktúra-beállításra.

Részletes útmutatást a GraphQL-hez készült API létrehozása a Fabricben és az adatok hozzáadása című témakörben talál.

Támogatott adatforrások

Jelenleg a következő támogatott adatforrások érhetők el a Fabric API-n keresztül a GraphQL-hez:

Microsoft Fabric Data Warehouse
Microsoft Fabric SQL-adatbázis
Microsoft Fabric Lakehouse SQL Analytics-végponton keresztül
Microsoft Fabric tükrözött adatbázisok SQL Analytics-végponton keresztül, beleértve a következőket:
- Azure SQL Database
- Azure SQL Managed Instance
- Azure Cosmos DB
- Microsoft Fabric SQL Database
- Azure Databricks
- Snowflake
- Tükrözött adatbázisok megnyitása
Azure SQL-adatbázis
Datamart

Funkciók

A GraphQL-hez készült Microsoft Fabric API átfogó képességeket biztosít, amelyek leegyszerűsítik az alkalmazásokhoz való adathozzáférést. Az automatikus kódlétrehozástól a teljesítménymonitorozásig ezek a funkciók lehetővé teszik a robusztus adat API-k minimális konfigurációval történő létrehozását.

Automatikus sémalétrehozás

Sémafelderítés: Az adatforrásséma automatikus felderítése és leképezése GraphQL-típusokra
Lekérdezés és mutáció generálása: GraphQL-lekérdezéseket és mutációkat hoz létre az adatszerkezet alapján
Feloldó létrehozása: Automatikusan létrehozza azokat a feloldókat, amelyekre szükség van az adatok forrásból való lekéréséhez
Helyi tesztelési kód: Mintakódot hoz létre azonnali teszteléshez és fejlesztéshez

Adatforrások rugalmassága

Több adatforrás: Csatlakozás és lekérdezés több adatforrás között a kiugró lekérdezések támogatásával
Adatbázis-objektumok: Táblák, nézetek és tárolt eljárások teljes támogatása SQL-adatbázisokban és -raktárakban
Szelektív expozíció: Az API-val elérhetővé tenni kívánt objektumok és oszlopok kiválasztása
Kapcsolatmodellezés: Egy-az-egyhez, egy-a-többhöz és több-a-többhöz kapcsolatok létrehozása adatentitás között

Műveletek és monitorozás

Teljesítményfigyelés: Beépített irányítópult és kérelemnaplózás az API viselkedésének és használatának nyomon követéséhez

Sémafejlődés verziószámozás nélkül

A GraphQL a hagyományos verziószámozás elkerülésével egyedi megközelítést alkalmaz az API-fejlesztésre. V1, v2 és v3 végpontok létrehozása helyett a GraphQL API-k folyamatosan fejlődnek:

Additív módosítások: Új típusokat, mezőket és képességeket adhat hozzá a meglévő lekérdezések feltörése nélkül. Az ügyfelek csak a szükséges mezőket kérik le, így az új mezők nincsenek hatással rájuk.
Visszamenőleges kompatibilitás: A meglévő lekérdezések a séma növekedésével is működnek, mivel a GraphQL csak explicit módon kért adatokat ad vissza.
Elavulás az eltávolítással szemben: A mezők elavultként jelölhetők meg, nem pedig azonnal eltávolíthatók, így az ügyfeleknek időt kell adni az alkalmazkodásra.
Egyetlen végpont: Az alkalmazások mindig ugyanahhoz a végponthoz csatlakoznak, a sémamódosításoktól függetlenül.

Ez a megközelítés leegyszerűsíti az API karbantartását és az ügyfelek frissítését a hagyományos verziójú API-khoz képest. Amikor módosítja a GraphQL API-sémát a Fabricben, a meglévő alkalmazások továbbra is működni fognak, amíg új képességeket ad hozzá a meglévő mezők eltávolítása vagy átnevezése helyett. A sémamódosítások kezelésével kapcsolatos további információkért lásd a Fabric API for GraphQL introspection és schema export című témakört.

Interaktív szerkesztési felület

A GraphQL API tartalmaz egy szerkesztőt, amely lehetővé teszi a lekérdezések és mutációk egyszerű fejlesztését és tesztelését. A szerkesztő funkciói a következők:

A lekérdezések és mutációk kimenetének vizualizációját megjelenítő eredménypanel
Lekérdezési és mutációs paraméterek támogatása
Intellisense, amely támogatja a GraphQL szintaxisát és a sémaobjektumok nevét

További információ a GraphQL-szerkesztő használatáról: API for GraphQL editor.

Korlátozások

További információért tekintse meg a GraphQL-korlátozásokkal kapcsolatos API-t .

Visszajelzés

Hasznosnak találta ezt az oldalt?

Last updated on 2026-01-21