Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Текущие общие ограничения продуктов для API для GraphQL в Microsoft Fabric перечислены в этой статье. Мы постоянно совершенствуем API для GraphQL с новыми функциями. Дополнительные сведения о будущем Microsoft Fabric см. в дорожной карте Microsoft Fabric .
Кто должен понимать ограничения
Основные сведения об ограничениях API GraphQL важны для следующих аспектов:
- Разработчики приложений , разрабатывающие приложения, работающие в ограничениях API GraphQL Fabric
- Инженеры данных планируют стратегии раскрытия данных и понимание границ платформы
- Архитекторы решений для определения решений на основе Fabric и настройки соответствующих технических ожиданий
- Участники рабочей области Fabric устраняют проблемы и реализуют обходные пути для текущих ограничений
- Руководители проектов сообщают об ограничениях платформы Fabric заинтересованным сторонам в процессе планирования проекта
Ознакомьтесь с этими ограничениями при планировании реализации API GraphQL или устранении неполадок с непредвиденным поведением API.
Операции источника данных
Источники данных конечной точки SQL Analytics поддерживают только операции чтения. Источники данных, доступные через конечные точки SQL Analytics (такие как Lakehouses и зеркальные базы данных), не поддерживают изменения. Данные можно запрашивать, но не может создавать, обновлять или удалять записи с помощью API GraphQL.
Ограничения размера и производительности
В следующей таблице представлена сводка о размере ключа, пагинации и ограничениях производительности.
| Тип ограничения | Ценность | Description | Обходной путь |
|---|---|---|---|
| Размер страницы по умолчанию | 100 элементов | Максимальное количество элементов, возвращаемых для каждого запроса по умолчанию | Используйте GraphQL пагинацию для итерации через большие результирующие наборы |
| Максимальный размер разбиения на страницы | 100 000 элементов | Максимальное общее количество элементов, которые можно получить с помощью разбиения на страницы | Выполняйте несколько отфильтрованных запросов, если вам требуется более 100K элементов (необычная схема в GraphQL). |
| Максимальный размер ответа | 64 МБ | Максимальный размер полезных данных ответа API | Выдача нескольких фильтруемых запросов для получения данных в небольших блоках |
| Время ожидания запроса | 100 секунд | Максимальное время выполнения для одного запроса | Оптимизируйте запросы или разбивайте сложные операции на более мелкие запросы |
| Максимальная глубина запроса | 10 уровней | Максимальный уровень вложенности полей в запросе | Уменьшить вложенность запросов, чтобы избежать проблем с производительностью при чрезмерном получении данных. |
Ограничения хранимых процедур
Хранимые процедуры в Azure SQL, Базе данных SQL в Fabric и хранилищах данных имеют определенные ограничения:
- Обработка результирующих наборов: используется только первый результирующий набор, возвращаемый хранимой процедурой. Несколько наборов результатов не поддерживаются.
-
Требования к метаданным: поддерживаются только хранимые процедуры, метаданные первого результирующего набора которых можно описать с помощью
sys.dm_exec_describe_first_result_set. - Приоритет параметров: если параметр хранимой процедуры указан как в файле конфигурации, так и в строке ЗАПРОСА URL-адреса значение строки ЗАПРОСА URL-адреса имеет приоритет.
-
Ограниченные функции GraphQL: сущности, поддерживаемые хранимыми процедурами, имеют ограниченные возможности по сравнению с табличными или просматриваемыми сущностями:
- Поддержка разбиения на страницы не поддерживается
- Нет упорядочивания или фильтрации
- Поиск на основе первичного ключа отсутствует
Известные проблемы
См. раздел о известных проблемах Microsoft Fabric в API для GraphQL по ссылке .