Udostępnij za pośrednictwem


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 z nowymi funkcjami. 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 lakehouses lub dublowanych baz danych.
  • Bieżący maksymalny 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 wyniki przy użyciu stronicowania 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 filtrowanych żądań lub użyć stronicowania.
  • Ograniczenia dotyczące procedur składowanych (dotyczy usług Azure SQL, SQL Database w środowisku Fabric i magazynach danych):
    • Tylko pierwszy zestaw wyników zwracanych przez procedurę składowaną jest wykorzystywany przez API dla GraphQL.
    • Obsługiwane są tylko te procedury składowane, których metadane dla pierwszego zestawu wyników opisanego 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.
    • Encje wspierane przez procedurę składowaną nie obsługują stronicowania, sortowania ani filtrowania. Takie jednostki nie obsługują zwracania elementów określonych przez wartości klucza podstawowego.

Znane problemy

W przypadku znanych problemów z interfejsem API dla programu GraphQL odwiedź Microsoft Fabric Znane problemy.