Ograniczenia interfejsu API Microsoft Fabric dla GraphQL

Ten artykuł zawiera szczegółowe informacje o bieżących ograniczeniach interfejsu API usługi Microsoft Fabric dla języka GraphQL.

Ograniczenia

Bieżące ogólne ograniczenia produktów dla interfejsu API GraphQL w usłudze Microsoft Fabric zostały wymienione w tym artykule. Stale ulepszamy interfejs API dla języka GraphQL przy użyciu nowych funkcji. Aby uzyskać więcej informacji na temat przyszłości usługi Microsoft Fabric, zobacz Fabric Roadmap.

• Każde źródło danych, które korzysta z punktu końcowego usługi SQL Analytics w celu uzyskania dostępu, obsługuje tylko operacje odczytu względem niego. Na przykład mutacje nie są dostępne dla Lakehouse'ów ani zreplikowanych baz danych.

• Bieżący domyślny rozmiar strony to 100, co oznacza, że każde żądanie zwróci maksymalnie 100 elementów w odpowiedzi. Jeśli zestaw wyników jest większy niż 100, iteruj przez wyniki przy użyciu stronicowania GraphQL.

• Maksymalny rozmiar stronicowania wynosi 100 000. Oznacza to, że istnieje stała maksymalna liczba elementów, które żądanie zwróci, i że można je iterować. Jeśli musisz zwrócić więcej niż 100 000 elementów dla aplikacji, wydaj wiele żądań. Dowiedz się, że ten wzorzec nie jest typowy w języku GraphQL.

• Maksymalny rozmiar odpowiedzi, który obsługujemy, to 64 MB. Oznacza to, że każde żądanie interfejsu API o rozmiarze odpowiedzi większym niż 64 MB zwraca błąd. Aby obejść to ograniczenie, możesz wydać wiele przefiltrowanych żądań.

• Ograniczenia dotyczące procedur składowanych (dotyczy Azure SQL, SQL Database w Microsoft Fabric i magazynach danych):

  • Tylko pierwszy zestaw wyników zwracanych przez procedurę składowaną jest wykorzystywany przez API dla GraphQL.
  • Obsługiwane są wyłącznie te procedury składowane, których metadane dla pierwszego zestawu wyników są opisane przez sys.dm_exec_describe_first_result_set.
  • Jeśli parametr procedury składowanej jest określony zarówno w pliku konfiguracji, jak i w ciągu zapytania adresu URL, parametr w ciągu zapytania adresu URL ma pierwszeństwo.
  • Jednostki wspierane przez procedurę składowaną nie mają wszystkich funkcji automatycznie udostępnianych dla jednostek wspieranych przez tabele lub widoki.
  • Jednostki wspierane przez procedurę składowaną nie obsługują stronicowania, sortowania ani filtrowania. Również takie jednostki nie obsługują zwracania elementów określonych przez wartości klucza podstawowego.

• Limit czasu żądania wynosi obecnie 100 sekund. Oznacza to, że jeśli wydasz żądanie, które generuje zapytanie źródła danych, które trwa dłużej niż 100 sekund, żądanie może zakończyć się niepowodzeniem i błędem.

• Maksymalna obsługiwana głębokość zapytania to 10. Głębokość zapytania to poziom zagnieżdżania pól w zapytaniu, który może mieć wpływ na wydajność, jeśli jest zbyt głęboka z powodu potencjalnej rekursji i nadmiernego pobierania danych.

Znane problemy

Aby zapoznać się z znanymi problemami GraphQL API, odwiedź Microsoft Fabric Znane problemy.

Powiązana zawartość

• interfejs API GraphQL — Omówienie
• Łączenie aplikacji z Fabric API do GraphQL
• API GraphQL — często zadawane pytania