Falta de suporte para o Microsoft Graph no Power Query

Não é recomendado ou há suporte para conectar-se às APIs REST do Microsoft Graph a partir do Power Query. Em vez disso, recomendamos que os usuários explorem soluções alternativas para recuperar dados de análise com base no Graph, como a conexão de dados do Microsoft Graph.

Você pode descobrir que pode fazer determinadas chamadas REST para os pontos de extremidade da API do Microsoft Graph funcionarem por meio das funções Web.Contents ou OData.Feed, mas essas abordagens não são confiáveis como soluções duradouras.

Este artigo descreve os problemas associados à conectividade do Microsoft Graph do Power Query e explica por que ele não é recomendado.

Authentication

O fluxo interno de autenticação de Conta Organizacional para as funções Web.Contents e OData.Feed do Power Query não é compatível com a maioria dos pontos de extremidade do Graph. Especificamente, o cliente do Microsoft Entra ID no Power Query solicita o escopo user_impersonation, que não é compatível com o modelo de segurança do Microsoft Graph. O Graph usa um conjunto avançado de permissões que não estão disponíveis por meio de nossos conectores Web e OData genéricos.

Implementar seus próprios fluxos de recuperação de credenciais do Microsoft Entra ID diretamente de sua consulta, ou usar credenciais codificadas ou integradas, também não é recomendado por motivos de segurança.

Incompatibilidade das bibliotecas OData

Determinados endpoints e extensões do Graph podem exigir o uso de bibliotecas e recursos OData que não são compatíveis com a função embutida OData.Feed no Power Query, pois o Graph e o Power Query podem estar usando versões diferentes das bibliotecas OData. Esses problemas geralmente resultam em erros ao recuperar o documento do $metadata serviço. Você pode descobrir diretrizes comuns relacionadas a passar a opção Implementation = "2.0" na chamada da função OData.Feed para garantir que as bibliotecas OData com suporte mais recentes sejam usadas. Embora essa abordagem resolva certas incompatibilidades do OData, você ainda poderá encontrar erros ao longo do tempo, pois o Graph e o Power Query adotam novas versões das bibliotecas OData em momentos diferentes.

Performance

A API do Microsoft Graph foi projetada para dar suporte a muitos cenários de aplicativo, mas é inferior à recuperação de dados em grande escala necessária para a maioria dos cenários de análise. Se você tentar recuperar grandes quantidades de dados de APIs do Graph, poderá encontrar problemas de desempenho. Detalhes sobre a aplicabilidade do cenário podem ser encontrados na documentação do Graph.

Usando um conector personalizado

Alguns usuários do Power Query habilitaram a conectividade do Graph por meio de conectores personalizados, limitando sua funcionalidade a determinadas partes da API do Graph. Essa abordagem permite que os desenvolvedores de conectores resolvam problemas gerais de autenticação definindo seu próprio cliente de ID do Microsoft Entra com permissões específicas do Graph. Alguns conectores personalizados solucionam os desafios do OData usando Web.Contents e simulando o suporte do OData dentro da lógica do conector. No entanto, essa abordagem não é recomendada, pois os usuários frequentemente atingem os problemas de desempenho e escalabilidade descritos acima. Os desenvolvedores que tomam essa rota devem continuar com essas limitações em mente.