Найдите ответы на часто задаваемые вопросы API Fabric для GraphQL.
Что такое GraphQL?
GraphQL — это язык запросов для API, который позволяет приложениям запрашивать именно необходимые данные. Основные преимущества:
- Система строгого типа — четко описывает доступные данные
- Точное получение данных — уменьшает избыточность данных благодаря возможности делать конкретные запросы
- Обратная совместимость . Упрощает обновление API без нарушения существующего кода
- Широкий набор инструментов для разработчиков. Позволяет использовать широкий набор средств разработчика
Это более эффективный способ взаимодействия приложений с серверами и базами данных.
Что такое API Microsoft Fabric для GraphQL?
API Microsoft Fabric для GraphQL — это управляемая служба, которая позволяет создавать API GraphQL в секундах.
Поддерживаемые источники данных:
- Хранилища данных Microsoft Fabric
- Microsoft Fabric Lakehouses
- Зеркальные базы данных Microsoft Fabric
- Базы данных SQL Microsoft Fabric
- Базы данных SQL Azure
Он предоставляет единый уровень API для запроса и мутирования данных из этих поддерживаемых источников данных.
Какие операции GraphQL поддерживаются в API Fabric для GraphQL?
В настоящее время поддерживаются только запросы GraphQL (чтение) и мутации (запись). Источники данных, предоставляемые через конечные точки аналитики SQL, доступны только для чтения, поэтому поддерживают только запросы. Для хранилищ данных первичный ключ необходимо определить для автоматического создания мутаций.
Как просмотреть и изменить разрешения в API Fabric для GraphQL?
Разрешения — это компоненты GraphQL, которые предоставляют бизнес-логику для разрешения полей в API и выполнения операций с данными, размещенными в источниках данных.
Автоматическое создание: Структура автоматически создает разрешения при присоединении нового источника данных или выборе новых объектов для предоставления из существующего источника данных.
Кастомизация: В настоящее время невозможно кастомизировать/настраивать резолверы напрямую. Для настраиваемой бизнес-логики в API для GraphQL можно создать хранимую процедуру в источнике данных и предоставить ее в API GraphQL.
Требуется ли api для клиентского приложения GraphQL доступ к источнику данных для выполнения запросов или мутаций?
Проверка подлинности идентификатора Microsoft Entra: API для GraphQL требует, чтобы приложения использовали идентификатор Microsoft Entra для проверки подлинности. Клиентское приложение должно быть зарегистрировано и настроено для выполнения вызовов API в Fabric.
Необходимые разрешения:
- Для приложения, зарегистрированного в Microsoft Entra, требуются разрешения GraphQLApi.Execute.All для службы Power BI. Дополнительные сведения см. в статье "Создание приложения Microsoft Entra" в Azure.
Конфигурация SSO (единого входа): Если API настроен для использования SSO, пользователю или служебному принципалу требуется доступ к обоим:
- API GraphQL (разрешение на выполнение запросов и мутаций )
- Источник данных (доступ на чтение или запись по мере необходимости)
Параметр доступа на уровне рабочей области: Также назначьте пользователя или служебного субъекта членом рабочей области с ролью участника, где расположены элементы API и источника данных. Это обеспечивает необходимый доступ к обоим элементам из одного места. Дополнительные сведения см. в разделе "Предоставление пользователям доступа к рабочим областям".
Конфигурация сохраненных учетных данных: Если API настроен для использования сохраненных учетных данных, пользователю или субъекту-службе требуется доступ только к API (при добавлении разрешений прямого доступа к API выберите параметр "Выполнить запросы и мутации ").
Примеры: Полный пример можно найти с примером кода для субъектов-пользователей и субъектов-служб в Connect Applications.
Разделы справки открыть запрос в службу поддержки ДЛЯ API для GraphQL?
Чтобы получить справку от служба поддержки Майкрософт по любой проблеме, связанной с API Fabric для GraphQL, посетите наш сайт поддержки Fabric и выберите вариант Инжиниринг данных.
Поддерживает ли API для GraphQL приватный канал?
API для GraphQL в настоящее время не поддерживает приватный канал.
Почему мой запрос выполняется плохо при первом выпуске, а затем хорошо работает при последующих запросах?
Существует две основные причины для проявления этого "холодного старта":
Подготовка источника данных:
- Первый запрос может занять больше времени, если источник данных необходимо прогреть из холодного состояния
- Даже если источник данных не является холодным, извлечение данных может оказаться не так эффективным при первом выполнении запроса GraphQL, если источник данных не загружает необходимые данные в памяти.
Инициализация конечной точки API:
- Первый запрос к API для конечной точки GraphQL может занять больше времени, так как система должна загрузить схему и конфигурацию.
- Последующие запросы быстрее, так как система уже разогревается и готова к выполнению ваших запросов
Дополнительные сведения см. в рекомендациях по производительности.
Как предоставить отзывы или предложения по API для GraphQL?
Мы приветствуем ваши отзывы и предложения! Вы можете предоставить отзывы через идеи Fabric. Наша команда активно отслеживает отзывы и предложения, отправленные на этой платформе. Вы также можете обратиться к нам с помощью поддержки Microsoft Fabric для любых конкретных запросов или проблем.