Falta de suporte para Microsoft Graph no Power Query

A ligação a APIs REST do Microsoft Graph a partir do Power Query não é recomendada nem suportada. Em vez disso, recomendamos que os utilizadores explorem soluções alternativas para obter dados analíticos baseados no Graph, como o Microsoft Graph Data Connect.

Pode descobrir que consegue fazer com que certas chamadas REST para endpoints da Microsoft Graph API funcionem através das Web.Contents ou das OData.Feed funções, mas estas abordagens não são fiáveis como soluções a longo prazo.

Este artigo descreve os problemas associados à conectividade Microsoft Graph no Power Query e explica porque não é recomendado.

Authentication

O fluxo de autenticação da Conta Organizacional incorporado para as funções Web.Contents e OData.Feed no Power Query não é compatível com a maioria dos endpoints do Graph. Especificamente, o cliente Microsoft Entra ID do Power Query solicita o user_impersonation âmbito, que não é compatível com o modelo de segurança do Microsoft Graph. O Graph utiliza um conjunto rico de permissões que não estão disponíveis através dos nossos conectores genéricos Web e OData.

Implementar os seus próprios fluxos de recuperação de credenciais do Microsoft Entra ID diretamente a partir da sua consulta, ou usar credenciais codificadas ou incorporadas, também não é recomendado por razões de segurança.

Incompatibilidade das bibliotecas OData

Certos endpoints e extensões do Graph podem exigir o uso de bibliotecas e funcionalidades OData que não são suportadas pela função OData.Feed incorporada no Power Query, porque o Graph e o Power Query podem estar a utilizar duas versões diferentes das bibliotecas OData. Estes problemas geralmente resultam em erros na recuperação do documento do serviço $metadata. Pode encontrar orientações comuns sobre como passar a opção Implementation = "2.0" para a função chamada OData.Feed, garantindo que são utilizadas as bibliotecas OData mais recentes e suportadas. Embora esta abordagem resolva certas incompatibilidades OData, pode ainda assim encontrar erros ao longo do tempo, à medida que o Graph e o Power Query adotam novas versões das bibliotecas OData em diferentes momentos.

Performance

A Microsoft Graph API foi concebida para suportar muitos cenários de aplicação, mas é subótima para a recuperação de dados em grande escala necessária para a maioria dos cenários de análise. Se tentar recuperar grandes quantidades de dados das APIs Graph, pode encontrar problemas de desempenho. Detalhes sobre a aplicabilidade de cenários podem ser encontrados na documentação do Graph.

Utilização de um conector personalizado

Alguns utilizadores do Power Query ativaram a conectividade do Graph através de conectores personalizados, limitando a sua funcionalidade a certas partes da API do Graph. Esta abordagem permite aos programadores de conectores resolver questões gerais de autenticação definindo o seu próprio cliente Microsoft Entra ID com permissões específicas para o Graph. Alguns conectores personalizados contornam os desafios do OData usando Web.Contents e simulando suporte ao OData dentro da lógica dos seus conectores. No entanto, esta abordagem não é recomendada, pois os utilizadores frequentemente enfrentam os problemas de desempenho e escalabilidade descritos acima. Os promotores que seguirem este caminho devem continuar tendo estas limitações em mente.