Часто задаваемые вопросы об API Fabric для GraphQL

Найдите ответы на часто задаваемые вопросы API Fabric для GraphQL.

Примечание.

API Microsoft Fabric для GraphQL находится в предварительной версии.

Что такое GraphQL?

GraphQL — это язык запросов открытый код для API и среды выполнения для выполнения этих запросов с существующими данными. GraphQL предоставляет полное и понятное описание данных в API с строго типизированной системой, дает клиентам возможность запрашивать именно то, что им нужно, и ничего больше, упрощает развитие API с течением времени и обеспечивает мощные средства разработчика.

Что такое API Microsoft Fabric для GraphQL?

API Microsoft Fabric для GraphQL — это управляемая служба, которая позволяет создавать API GraphQL в секундах для доступа к данным из таких источников данных, как хранилища данных Microsoft Fabric, Microsoft Fabric Lakehouses и зеркальные базы данных Microsoft Fabric. Он предоставляет единый уровень API для запроса и мутирования данных из этих поддерживаемых источников данных. API Fabric для GraphQL в настоящее время находится в предварительной версии.

Какие операции GraphQL поддерживаются в API Fabric для GraphQL?

В настоящее время поддерживаются только запросы GraphQL (чтение) и мутации (запись). Источники данных, предоставляемые через конечные точки аналитики SQL, доступны только для чтения, поэтому поддерживают только запросы. В случае с хранилищами данных первичный ключ необходимо определить для автоматического создания мутаций.

Как просмотреть и изменить разрешения в API Fabric для GraphQL?

Разрешения — это компоненты GraphQL, которые предоставляют бизнес-логику для разрешения полей в API и выполнения операций с данными, размещенными в источниках данных. Структура автоматически создает разрешения при присоединении нового источника данных или выборе новых объектов для предоставления из существующего источника данных. В настоящее время невозможно настроить сопоставители. Для настраиваемой бизнес-логики в API для GraphQL можно создать хранимую процедуру в источнике данных и предоставить ее в API GraphQL.

Требуется ли api для клиентского приложения GraphQL доступ к источнику данных для выполнения запросов или мутаций?

API для GraphQL требует, чтобы приложения использовали Microsoft Entra для проверки подлинности. Клиентское приложение должно быть зарегистрировано и настроено надлежащим образом для выполнения вызовов API к Fabric. Для приложения, зарегистрированного в Entra, требуются разрешения Item.Execute.All и Datamart.ReadWrite.All API для служба Power BI (важно, чтобы области могли изменяться во время общедоступной предварительной версии). Дополнительные сведения см. в статье "Создание приложения Microsoft Entra" в Azure. Помимо Entra, прошедший проверку подлинности пользователь в приложении, вызывающего API GraphQL, должен быть членом рабочей области с ролью участника, где находятся элементы API и источника данных. Дополнительные сведения см. в разделе "Предоставление пользователям доступа к рабочим областям". Субъекты-службы в настоящее время не поддерживаются. Полный пример можно найти в примере кода в Connect Applications.

Разделы справки открыть запрос в службу поддержки ДЛЯ API для GraphQL?

Чтобы получить справку от служба поддержки Майкрософт по любой проблеме, связанной с API Fabric для GraphQL, посетите наш сайт поддержки Fabric и выберите вариант Инжиниринг данных.