Falta de suporte para o 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 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 achar que pode fazer com que determinadas chamadas REST para pontos de extremidade da API do Microsoft Graph funcionem através das Web.Contents funções 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 razão não é recomendado.

Autenticação

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

A implementação de seus próprios fluxos de recuperação de credenciais do Microsoft Entra ID diretamente da sua consulta ou o uso de credenciais codificadas ou incorporadas também não é recomendado por motivos de segurança.

Incompatibilidade das bibliotecas OData

Determinados pontos de extremidade do Graph e extensões do Graph podem exigir o uso de bibliotecas OData e recursos que não são suportados pela função interna OData.Feed do Power Query porque o Graph e o Power Query podem estar usando duas versões diferentes das bibliotecas OData. Esses problemas geralmente resultam em erros ao recuperar o documento do $metadata serviço. Você pode descobrir orientações comuns relacionadas à passagem da Implementation = "2.0" opção para a chamada de OData.Feed função para garantir que as bibliotecas OData suportadas mais recentes sejam usadas. Embora essa abordagem resolva certas incompatibilidades do OData, você ainda pode encontrar erros ao longo do tempo à medida que 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 oferecer suporte a muitos cenários de aplicativos, mas não é ideal para a 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 utilizadores do Power Query ativaram a conectividade do Graph através de conectores personalizados, limitando a 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 Microsoft Entra ID com permissões específicas do Graph. Alguns conectores personalizados contornam desafios OData usando Web.Contents e simulando o suporte a OData dentro de sua lógica de 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 seguirem esse caminho devem continuar com essas limitações em mente.