Прочитать на английском

Поделиться через


Отсутствие поддержки Microsoft Graph в Power Query

ПодключениеREST API Microsoft Graph из Power Query не рекомендуется или не поддерживается. Вместо этого мы рекомендуем пользователям изучить альтернативные решения для получения аналитических данных на основе Graph, таких как Подключение к данным Microsoft Graph.

Вы можете найти, что некоторые вызовы REST к конечным точкам API Microsoft Graph работают через Web.Contents или OData.Feed функции, но эти подходы не являются надежными в качестве долгосрочных решений.

В этой статье описываются проблемы, связанные с подключением Microsoft Graph из Power Query, и объясняется, почему это не рекомендуется.

Проверка подлинности

Встроенный поток проверки подлинности учетной записи организации для функций Power Query Web.ContentsOData.Feed несовместим с большинством конечных точек Graph. В частности, клиент Идентификатора Microsoft Entra в Power Query запрашивает user_impersonation область, которая несовместима с моделью безопасности Graph. Graph использует широкий набор разрешений, недоступных через наши универсальные соединители Web и OData.

Реализация собственных потоков извлечения учетных данных идентификатора Microsoft Entra непосредственно из запроса или использования жестких или внедренных учетных данных также не рекомендуется по соображениям безопасности.

Несовместимость библиотек OData

Для некоторых конечных точек и расширений Graph может потребоваться использование библиотек и функций OData, которые не поддерживаются встроенной OData.Feed функцией Power Query, так как Graph и Power Query могут использовать две разные версии библиотек OData. Эти проблемы обычно приводят к ошибкам, извлекающим документ службы $metadata . Вы можете обнаружить общие рекомендации, связанные с передачей Implementation = "2.0" параметра OData.Feed вызову функции, чтобы обеспечить использование последних поддерживаемых библиотек OData. В то время как этот подход разрешает определенные несовместимости OData, с течением времени могут возникать ошибки, так как Graph и Power Query принимают новые версии библиотек OData в разное время.

Производительность

API Microsoft Graph предназначен для поддержки многих сценариев приложений, но является неоптимальным для получения крупномасштабных данных, необходимых для большинства сценариев аналитики. Если вы пытаетесь получить большие объемы данных из API Graph, могут возникнуть проблемы с производительностью. Подробные сведения о применимости сценария см. в документации по Graph.

Использование пользовательского соединителя

Некоторые пользователи Power Query включили подключение Graph через пользовательские соединители, ограничивая их функциональные возможности определенными частями API Graph. Этот подход позволяет разработчикам соединителей устранять общие проблемы проверки подлинности, определяя собственный клиент идентификатора Microsoft Entra с определенными разрешениями Graph. Некоторые пользовательские соединители работают над проблемами OData с помощью Web.Contents поддержки OData и имитации поддержки OData в логике соединителя. Однако этот подход не рекомендуется, так как пользователи часто обращаются к проблемам производительности и масштабируемости, описанным выше. Разработчики, которые принимают этот маршрут, должны продолжаться с этими ограничениями.