Anmerkung
Der Zugriff auf diese Seite erfordert eine Genehmigung. Du kannst versuchen, dich anzumelden oder die Verzeichnisse zu wechseln.
Der Zugriff auf diese Seite erfordert eine Genehmigung. Du kannst versuchen , die Verzeichnisse zu wechseln.
Die aktuellen allgemeinen Produkteinschränkungen für DIE API für GraphQL in Microsoft Fabric sind in diesem Artikel aufgeführt. Wir verbessern die API für GraphQL kontinuierlich mit neuen Features. Weitere Informationen zur Zukunft von Microsoft Fabric finden Sie unter Fabric Roadmap.
Wer muss Einschränkungen verstehen?
Das Verständnis von GraphQL-API-Einschränkungen ist von entscheidender Bedeutung für:
- Anwendungsentwickler , die Anwendungen entwerfen, die in Fabric GraphQL-API-Einschränkungen funktionieren
- Dateningenieure , die Strategien zur Datenexposition planen und Plattformgrenzen verstehen
- Lösungsarchitekten definieren den Umfang von Fabric-basierten Lösungen und setzen entsprechende technische Erwartungen
- Fabric-Arbeitsbereichsmitwirkende behandeln Probleme und implementieren Problemumgehungen für aktuelle Einschränkungen
- Projektmanager kommunizieren Fabric-Plattformeinschränkungen an Projektbeteiligte während der Projektplanung
Überprüfen Sie diese Einschränkungen, wenn Sie GraphQL-API-Implementierungen planen oder unerwartetes API-Verhalten beheben.
Datenquellenvorgänge
SQL Analytics-Endpunktdatenquellen unterstützen nur Lesevorgänge. Auf Datenquellen, auf die über SQL Analytics-Endpunkte (z. B. Lakehouses und gespiegelte Datenbanken) zugegriffen wird, werden keine Mutationen unterstützt. Sie können Daten abfragen, aber keine Datensätze über die GraphQL-API erstellen, aktualisieren oder löschen.
Größen- und Leistungsbeschränkungen
In der folgenden Tabelle sind die wichtigsten Größen-, Paginierungs- und Leistungseinschränkungen zusammengefasst.
| Grenzwerttyp | Wert | Description | Zwischenlösung |
|---|---|---|---|
| Standardseitengröße | 100 Elemente | Maximale Anzahl von Elementen, die standardmäßig pro Anforderung zurückgegeben werden | Verwenden Sie die GraphQL-Paginierung, um durch größere Ergebnismengen zu iterieren. |
| Maximale Paginierungsgröße | 100 000 Elemente | Maximale Gesamtanzahl von Elementen, die über die Paginierung abgerufen werden können | Ausgeben mehrerer gefilterter Anforderungen, wenn Sie mehr als 100K-Elemente benötigen (ungewöhnliches Muster in GraphQL) |
| Maximale Antwortgröße | 64 MB | Maximale Größe der API-Antwortnutzlast | Ausgeben mehrerer gefilterter Anforderungen zum Abrufen von Daten in kleineren Blöcken |
| Anforderungszeitlimit | 100 Sekunden | Maximale Ausführungszeit für eine einzelne Anforderung | Optimieren Sie Abfragen oder teilen Sie komplexe Vorgänge in kleinere Anforderungen auf |
| Maximale Abfragetiefe | 10 Ebenen | Maximale Schachtelungsebene von Feldern in einer Abfrage | Reduzieren der Abfrageschachtelung, um Leistungsprobleme durch übermäßiges Abrufen von Daten zu vermeiden |
Einschränkungen für gespeicherte Prozeduren
Gespeicherte Prozeduren in Azure SQL, SQL-Datenbank in Fabric und Data Warehouses weisen spezifische Einschränkungen auf:
- Ergebnissatzbehandlung: Es wird nur das erste von der gespeicherten Prozedur zurückgegebene Resultset verwendet. Mehrere Resultsets werden nicht unterstützt.
-
Metadatenanforderungen: Nur gespeicherte Prozeduren, deren erste Resultsetmetadaten beschrieben
sys.dm_exec_describe_first_result_setwerden können, werden unterstützt. - Parameterrang: Wenn ein Parameter für gespeicherte Prozeduren sowohl in der Konfigurationsdatei als auch in der URL-Abfragezeichenfolge angegeben wird, hat der WERT der URL-Abfragezeichenfolge Vorrang.
-
Eingeschränkte GraphQL-Features: Entitäten, die von gespeicherten Prozeduren unterstützt werden, weisen im Vergleich zu Tabellen- oder Ansichtsentitäten reduzierte Funktionen auf:
- Keine Paginierungsunterstützung
- Keine Sortierung oder Filterung
- Keine primärschlüsselbasierten Abfragen
Bekannte Probleme
Informationen zu bekannten Problemen in der API für GraphQL finden Sie unter Microsoft Fabric Bekannte Probleme.