Megjegyzés
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhat bejelentkezni vagy módosítani a címtárat.
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhatja módosítani a címtárat.
A Microsoft Fabric graphQL API-jának jelenlegi általános termékkorlátozásait ebben a cikkben találja. Folyamatosan fejlesztjük a GraphQL API-t új funkciókkal. A Microsoft Fabric jövőjéről további információt a Fabric ütemtervénekcímű cikkben talál.
Kinek kell megértenie a korlátozásokat?
A GraphQL API korlátainak megértése elengedhetetlen a következőkhöz:
- A Fabric GraphQL API korlátain belül működő alkalmazásokat tervező alkalmazásfejlesztők
- Adatmérnökök adatexpozíciós stratégiák tervezése és a platform határainak megértése
- A megoldástervezők a Fabric-alapú megoldások hatókörét és a megfelelő műszaki elvárásokat támasztják
- Fabric munkaterület közreműködőinek hibaelhárításai és kerülőmegoldások megvalósítása a jelenlegi korlátozások kezelése érdekében
- Projektmenedzserek kommunikálnak a Fabric platform korlátaival az érdekelt feleknek a projekttervezés során
Tekintse át ezeket a korlátozásokat a GraphQL API-implementációk tervezésekor vagy a váratlan API-viselkedés hibaelhárítása során.
Adatforrásműveletek
Az SQL Analytics-végpont adatforrásai csak olvasási műveleteket támogatnak. Az SQL Analytics-végpontokon (például Lakehouse-okon és tükrözött adatbázisokon) keresztül elért adatforrások nem támogatják a mutációkat. Adatokat kérdezhet le, de nem hozhat létre, nem frissíthet vagy törölhet rekordokat a GraphQL API-n keresztül.
Méret- és teljesítménykorlátok
Az alábbi táblázat a kulcsméretet, a lapozást és a teljesítménykorlátozásokat foglalja össze:
| Korlát típusa | Érték | Description | Megoldás |
|---|---|---|---|
| Alapértelmezett oldalméret | 100 elem | Kérésenként visszaadott elemek maximális száma alapértelmezés szerint | Nagyobb eredményhalmazok iterációja a GraphQL-lapozással |
| Maximális oldalszámozás méret | 100 000 elem | A lapozással lekérhető összes elem maximális száma | Több szűrt kérés kiadása, ha több mint 100 000 elemre van szüksége (nem gyakori minta a GraphQL-ben) |
| A válasz maximális mérete | 64 MB | Az API válasz payload maximális mérete | Több szűrt kérés kiadása kisebb adattömbökben lévő adatok lekéréséhez |
| Kérés-időtúllépés | 100 másodperc | Egyetlen kérelem maximális végrehajtási ideje | Lekérdezések optimalizálása vagy összetett műveletek kisebb kérelmekre bontása |
| Lekérdezési mélység maximuma | 10 szint | Mezők maximális beágyazási szintje egy lekérdezésben | A lekérdezések beágyazásának csökkentése a túlzott adatlekérés miatti teljesítményproblémák megelőzése érdekében |
| Csatolt objektumok maximális száma | 1000 objektum | Forrásokból GraphQL-elemhez csatolható objektumok maximális száma | Több forráshoz használjon több elemet; egyetlen forrás esetében fontolja meg a kötényeket vagy más absztrakciós módszereket |
A tárolt eljárások korlátozásai
Az Azure SQL-ben, az SQL Database-ben a Fabricben és az Adattárházakban tárolt eljárásokra meghatározott korlátozások vonatkoznak:
- Eredményhalmaz kezelése: A rendszer csak a tárolt eljárás által visszaadott első eredménykészletet használja. Többféle eredményhalmaz nem támogatott.
-
Metaadatokra vonatkozó követelmények: Csak azok a tárolt eljárások támogatottak, amelyek első eredményhalmazának metaadatait
sys.dm_exec_describe_first_result_setle lehet írni. - Paraméter elsőbbsége: Ha a konfigurációs fájlban és az URL-lekérdezési sztringben is meg van adva tárolt eljárásparaméter, az URL-lekérdezési sztring értéke elsőbbséget élvez.
-
Korlátozott GraphQL-funkciók: A tárolt eljárások által támogatott entitások a tábla- vagy nézetalapú entitásokhoz képest csökkentett képességekkel rendelkeznek:
- Nincs lapozási támogatás
- Nincs rendelés vagy szűrés
- Nincsenek elsődleges kulcsalapú keresések
Ismert problémák
A GraphQL API ismert problémáinak megtekintéséhez látogasson el a Microsoft Fabric ismert problémái oldalra.