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