Compartilhar via


Falta de suporte para o Microsoft Graph no Power Query

A conexão com o Microsoft Graph (às APIs REST) do Power Query não é recomendada ou não é compatível. Assim, recomendamos que os usuários explorem soluções alternativas para recuperar dados de análise baseados no Graph, como a conexão de dados do Microsoft Graph.

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

Este artigo descreve os problemas associados à conectividade do Microsoft Graph a partir do Power Query e explica por que ela não é recomendada.

Autenticação

O fluxo interno de autenticação de Conta Organizacional das 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 Microsoft Entra ID do Power Query solicita o escopo user_impersonation, que não é compatível com o modelo de segurança do Graph. O Graph usa um conjunto avançado de permissões que não estão disponíveis em nossos conectores Web e OData genéricos.

Por motivos de segurança, também não é recomendado implementar seus próprios fluxos de recuperação de credenciais do Microsoft Entra ID diretamente na consulta ou usar credenciais codificadas rigidamente ou incorporadas.

Incompatibilidade das bibliotecas do OData

Determinados pontos de extremidade do Graph e extensões para o Graph podem requerer o uso de bibliotecas e recursos OData que não têm suporte da função OData.Feed interna do Power Query, pois o Graph e o Power Query podem estar usando duas versões diferentes de bibliotecas OData. Esses problemas geralmente resultam em erros ao recuperar o documento $metadata do serviço. Você pode descobrir diretrizes comuns relacionadas à passagem da opção Implementation = "2.0" para a chamada de função OData.Feed para garantir que as bibliotecas OData mais recentes com suporte sejam usadas. Embora essa abordagem resolva certas incompatibilidades do OData, você ainda pode encontrar erros ao longo do tempo, pois o Graph e o Power Query adotam novas versões das bibliotecas OData em momentos diferentes.

Desempenho

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

Usar um conector personalizado

Alguns usuários do Power Query habilitaram a conectividade do Graph por meio de conectores personalizados, limitando a funcionalidade a determinadas partes da API do Graph. Essa abordagem permite que os desenvolvedores de conectores resolvam problemas gerais de autenticação definindo os próprios clientes Microsoft Entra ID com permissões específicas do Graph. Alguns conectores personalizados contornam 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 acabam se deparando com os problemas de desempenho e escalabilidade descritos acima. Os desenvolvedores que adotam essa rota devem ter essas limitações sempre em mente.