Поделиться через

Ограничения API Microsoft Fabric для GraphQL

В этой статье описаны текущие ограничения в API Microsoft Fabric для GraphQL.

Ограничения

Текущие общие ограничения продуктов для API для GraphQL в Microsoft Fabric перечислены в этой статье. Мы постоянно совершенствуем API для GraphQL с новыми функциями. Дополнительные сведения о будущем Microsoft Fabric см. в дорожной карте Microsoft Fabric .

  • Любой источник данных, использующий конечную точку АНАЛИТИКИ SQL для доступа к нему, поддерживает только операции чтения. Например, модификации недоступны для лейкхаусов или зеркальных баз данных.

  • Текущий размер страницы по умолчанию составляет 100, что означает, что каждый запрос возвращает не более 100 элементов в ответе. Если результирующий набор превышает 100, выполните итерацию по результатам с помощью GraphQL Pagination.

  • Максимальный размер разбиения на страницы составляет 100 000. Это означает, что имеется фиксированное максимальное количество элементов, которые возвращаются запросом, и по которым вы можете выполнять итерацию. Если вам нужно вернуть более 100K элементов для приложения, выполните несколько запросов. Учтите, что этот паттерн не является обычным в GraphQL.

  • Максимальный размер ответа, который мы поддерживаем, составляет 64 МБ. Это означает, что любой запрос API с размером ответа, превышающим 64 МБ, возвращает ошибку. Чтобы обойти это ограничение, можно выполнить несколько отфильтрованных запросов.

  • Ограничения для хранимых процедур (применяется к Azure SQL, базе данных SQL в Fabric и хранилищах данных):

    • Только первый результирующий набор, возвращаемый хранимой процедурой, используется API для GraphQL.
    • Поддерживаются только те хранимые процедуры, метаданные которых описаны в первом результирующем наборе, предоставленном функцией sys.dm_exec_describe_first_result_set.
    • Если параметр хранимой процедуры указан как в файле конфигурации, так и в строке ЗАПРОСА URL-адреса, параметр в строке запроса URL-адреса имеет приоритет.
    • Сущности, поддерживаемые хранимой процедурой, не имеют всех возможностей, которые автоматически предоставляются для сущностей, поддерживаемых таблицами или представлениями.
    • Сущности, основанные на хранимых процедурах, не поддерживают пагинацию, упорядочивание или фильтрацию. Такие сущности не поддерживают возврат элементов, указанных значениями первичного ключа.

  • Время ожидания запроса в настоящее время составляет 100 секунд. Это означает, что если вы отправите запрос, который вызывает выполнение запроса к источнику данных, занимающего более 100 секунд, ваш запрос может завершиться неудачно.

  • Максимальная глубина запроса, поддерживаемая, составляет 10. Глубина запроса — это уровень вложенности полей в запросе, который может повлиять на производительность, если слишком глубокая из-за потенциальной рекурсии и чрезмерного получения данных.

Известные проблемы

См. раздел о известных проблемах Microsoft Fabric в API для GraphQL по ссылке .

Связанное содержимое

  • Last updated on