Найдите ответы на часто задаваемые вопросы API Fabric для GraphQL.
Что такое GraphQL?
GraphQL — это язык запросов для API, который позволяет приложениям запрашивать именно необходимые данные. Основные преимущества:
- Система строгого типа — четко описывает доступные данные
- Точное получение данных — уменьшает избыточность данных благодаря возможности делать конкретные запросы
- Обратная совместимость . Упрощает обновление API без нарушения существующего кода
- Rich tooling — позволяет использовать широкий набор инструментов разработчика.
Это более эффективный способ взаимодействия приложений с серверами и базами данных.
Что такое API Microsoft Fabric для GraphQL?
Microsoft Fabric API для GraphQL — это управляемая служба, которая позволяет создавать API GraphQL в секундах.
Поддерживаемые источники данных:
- хранилища данных Microsoft Fabric
- Microsoft Fabric Lakehouses
- зеркальные базы данных Microsoft Fabric
- базы данных SQL Microsoft Fabric
- Базы данных Azure SQL
Он предоставляет единый уровень API для запроса и мутирования данных из этих поддерживаемых источников данных.
Какие операции GraphQL поддерживаются в API Fabric для GraphQL?
В настоящее время поддерживаются только запросы GraphQL (чтение) и мутации (запись). Источники данных, предоставляемые через конечные точки аналитики SQL, доступны только для чтения, поэтому поддерживают только запросы. Для хранилищ данных первичный ключ необходимо определить для автоматического создания мутаций.
Как просмотреть и изменить разрешения в API Fabric для GraphQL?
Резолверы — это компоненты GraphQL, которые предоставляют бизнес-логику для обработки полей в API и выполнения операций с данными, находящимися в источниках данных.
Автоматическое создание: Структура автоматически создает разрешения при присоединении нового источника данных или выборе новых объектов для предоставления из существующего источника данных.
Кастомизация: В настоящее время невозможно кастомизировать/настраивать резолверы напрямую. Для настраиваемой бизнес-логики в API для GraphQL можно создать хранимую процедуру в источнике данных и предоставить ее в API GraphQL.
Требуется ли API для клиентского приложения GraphQL доступ к источнику данных для выполнения запросов или мутаций?
Аутентификация Microsoft Entra ID: API для GraphQL требует, чтобы приложения использовали Microsoft Entra ID для аутентификации. Клиентское приложение должно быть зарегистрировано и настроено для выполнения вызовов API в Fabric.
Необходимые разрешения:
- Для работы приложения, зарегистрированного в Microsoft Entra, требуются разрешения GraphQLApi.Execute.All для службы Power BI. Дополнительные сведения см. в разделе Создание приложения Microsoft Entra в Azure.
Single sign-on (SSO) configuration: Если API настроен на использование единого входа, то прошедший проверку подлинности пользователь или субъект-служба требует доступа к обоим:
- API GraphQL (разрешение на выполнение запросов и мутаций )
- Источник данных (доступ на чтение или запись по мере необходимости)
Опция доступа уровня рабочей области: Кроме того, назначьте пользователя или участника службы в качестве члена рабочей области с ролью участника, где находятся элементы API и источника данных. Это предоставляет необходимый доступ к обоим элементам из одного места. Дополнительные сведения см. в разделе Предоставление доступа пользователям к рабочим областям.
Конфигурация сохранённых учетных данных: Если API настроен на использование сохранённых учетных данных, аутентифицированному пользователю или служебной учетной записи требуется доступ только к API (выберите параметр Выполнение запросов и мутаций при добавлении прямых разрешений доступа к API).
Примеры: Полный пример можно найти с примером кода для субъектов-пользователей и субъектов-служб в Connect Applications.
Как создать заявку в службу поддержки по API для GraphQL?
Чтобы получить справку от Microsoft Support по любой проблеме, связанной с API Fabric для GraphQL, посетите наш сайт поддержки Fabric Support и выберите вариант Data Engineering.
Поддерживает ли API для GraphQL Private Link?
API для GraphQL поддерживает только Tenant Level Private Link в настоящее время.
Почему мой запрос выполняется плохо при первом выпуске, а затем хорошо работает при последующих запросах?
Существует две основные причины для проявления этого "холодного старта":
Подготовка источника данных:
- Первый запрос может занять больше времени, если источник данных необходимо прогреть из холодного состояния
- Даже если источник данных не является холодным, извлечение данных может оказаться не так эффективным при первом выполнении запроса GraphQL, если источник данных не загружает необходимые данные в памяти.
Инициализация конечной точки API:
- Первый запрос к API для конечной точки GraphQL может занять больше времени, так как система должна загрузить схему и конфигурацию.
- Последующие запросы быстрее, так как система уже разогревается и готова к выполнению ваших запросов
Дополнительные сведения см. в рекомендациях по производительности.
Как предоставить отзывы или предложения по API для GraphQL?
Мы приветствуем ваши отзывы и предложения! Вы можете предоставить отзывы через Fabric Ideas. Наша команда активно отслеживает отзывы и предложения, отправленные на этой платформе. Вы также можете обратиться к нам через службу поддержки Microsoft Fabric для любых конкретных запросов или проблем.