Sdílet prostřednictvím

Omezení rozhraní Microsoft Fabric API pro GraphQL

Aktuální obecná omezení produktů pro rozhraní API pro GraphQL v Microsoft Fabric jsou uvedená v tomto článku. Rozhraní API pro GraphQL neustále vylepšujeme novými funkcemi. Další informace o budoucnosti Microsoft Fabric naleznete v tématu Plán infrastruktury.

Kdo potřebuje pochopit omezení

Porozumění omezení rozhraní GraphQL API jsou zásadní pro:

  • Vývojáři aplikací navrhující aplikace, které fungují v rámci rozhraní omezení Fabric GraphQL API.
  • Datoví inženýři plánují strategie expozice dat a chápou hranice platforem
  • Architekti řešení vymezují řešení založená na Fabric a nastavují odpovídající technická očekávání.
  • Přispěvatelé pracovních prostorů Fabric řeší problémy a provádějí náhradní řešení pro současná omezení
  • Projektoví manažeři komunikující s omezeními platformy Fabric zúčastněným stranám během plánování projektů

Projděte si tato omezení při plánování implementací rozhraní GraphQL API nebo řešení potíží s neočekávaným chováním rozhraní API.

Operace zdroje dat

Zdroje dat koncového bodu SQL Analytics podporují pouze operace čtení. Zdroje dat přístupné prostřednictvím koncových bodů SQL Analytics (jako jsou Lakehouses a zrcadlené databáze) nepodporují mutaci. Data můžete dotazovat, ale nemůžete vytvářet, aktualizovat ani odstraňovat záznamy prostřednictvím rozhraní GraphQL API.

Omezení velikosti a výkonu

Následující tabulka shrnuje velikost klíče, stránkování a omezení výkonu:

Typ limitu Hodnota Description Řešení problému
Výchozí velikost stránky 100 položek Počet položek vrácených na požadavek ve výchozím nastavení je maximálně. Použijte stránkování GraphQL k iteraci skrze větší sady výsledků
Maximální velikost stránkování 100 000 položek Maximální celkový počet položek, které lze načíst prostřednictvím stránkování Vytvořte více filtrovaných požadavků, pokud potřebujete více než 100 tisíc položek (neobvyklý vzor v GraphQL)
Maximální velikost odpovědi 64 MB Maximální velikost datové části odpovědi rozhraní API Zadejte několik filtrovaných požadavků pro načtení dat v menších částech.
Časový limit požadavku vypršel 100 sekund Maximální doba provádění pro jeden požadavek Optimalizace dotazů nebo rozdělení složitých operací na menší požadavky
Maximální hloubka dotazu 10 úrovní Maximální úroveň vnoření polí v dotazu Omezení vnoření dotazů, aby nedocházelo k problémům s výkonem při nadměrném načítání dat

Omezení uložených procedur

Uložené procedury v Azure SQL, SQL Database ve Fabric a datových skladech mají specifická omezení.

  • Zpracování sady výsledků: Použije se pouze první sada výsledků vrácená uloženou procedurou. Více sad výsledků není podporováno.
  • Požadavky na metadata: Podporují se pouze uložené procedury, jejichž metadata sady výsledků mohou být popsána sys.dm_exec_describe_first_result_set .
  • Priorita parametru: Pokud je parametr uložené procedury zadán v konfiguračním souboru i v řetězci dotazu adresy URL, má přednost hodnota řetězce dotazu ADRESY URL.
  • Omezené funkce GraphQL: Entity zálohované uloženými procedurami mají ve srovnání s tabulkami nebo entitami založenými na zobrazení omezené možnosti:
    • Žádná podpora stránkování
    • Bez řazení nebo filtrování
    • Žádná vyhledávání založená na primárním klíči

Známé problémy

Informace o známých problémech v rozhraní API pro GraphQL najdete v tématu známé problémy Microsoft Fabric.

Související obsah

  • Last updated on