Compartilhar via


Feed OData

Resumo

Elemento Descrição
Estado da liberação Disponibilidade geral
Produtos Distinguir-se
Power BI (modelos semânticos)
Power BI (fluxos de dados)
Tecido (Dataflow Gen2)
Power Apps (fluxos de dados)
Dynamics 365 Customer Insights
Analysis Services
Tipos de autenticação com suporte Anônimo
Windows (requer Gateway)
Básico (requer Gateway)
Web API
Conta organizacional
Documentação de referência da função OData.Feed, ODataOmitValues.Nulls

Observação

Alguns recursos podem estar presentes em um produto, mas não em outros devido a agendas de implantação e recursos específicos do host.

Capacidades suportadas

  • Básico
  • Avançado
    • Partes de URL
    • Colunas de tipo aberto
  • Selecionar tabelas relacionadas

Observação

Não há suporte para o Microsoft Graph. Mais informações: Falta de suporte para o Microsoft Graph no Power Query

Carregar dados de um feed OData no Power Query Desktop

Para carregar dados de um Feed OData no Power Query Desktop:

  1. Selecione OData ou OData Feed na experiência de obtenção de dados. A experiência para obter dados no Power Query Desktop varia entre aplicativos. Para obter mais informações sobre a experiência de obter dados do Power Query Desktop para seu aplicativo, acesse Onde obter dados.

  2. Escolha o botão Básico e insira um endereço de URL na caixa de texto. Essa URL deve ser a raiz do serviço OData ao qual você deseja se conectar. Por exemplo, digite https://services.odata.org/V4/northwind/northwind.svc/. Em seguida, selecione OK.

    Captura de tela da caixa de diálogo de conexão do Feed OData com a URL de exemplo OData inserida.

    Se o endereço de URL inserido for inválido, um ícone de aviso será exibido ao lado da caixa de texto da URL .

  3. Se você estiver se conectando usando o Feed OData pela primeira vez, selecione o tipo de autenticação, insira suas credenciais (se necessário) e selecione o nível ao qual aplicar as configurações de autenticação. Depois, selecione Conectar.

    Captura de tela da caixa de diálogo de autenticação em que você insere suas credenciais do OData.

  4. Na caixa de diálogo Navegador , você pode selecionar uma tabela e, em seguida, transformar os dados no editor do Power Query selecionando Transformar Dados ou carregar os dados selecionando Carregar.

    Captura de tela do Navegador com a lista alfabética de produtos selecionados.

    Se você tiver várias tabelas que tenham uma relação direta com uma ou mais das tabelas já selecionadas, selecione o botão Selecionar Tabelas Relacionadas . Quando você faz isso, todas as tabelas que têm uma relação direta com uma ou mais das tabelas já selecionadas também são importadas.

Carregar dados de um feed OData no Power Query Online

Para carregar dados de um Feed OData no Power Query Online:

  1. Selecione a opção OData ou OData Feed na experiência de obtenção de dados. Diferentes aplicativos têm maneiras distintas de acessar a experiência de obter dados no Power Query Online. Para obter mais informações sobre como acessar a experiência de dados do Power Query Online a partir do seu aplicativo, acesse Onde obter dados.

    Captura de tela da janela de obtenção de dados com o OData enfatizado.

  2. Na caixa de diálogo OData exibida, insira uma URL na caixa de texto.

    Captura de tela da página de entrada online do OData.

  3. Se você estiver se conectando usando o Feed OData pela primeira vez, selecione o tipo de autenticação e insira suas credenciais (se necessário). Em seguida, selecione Avançar.

  4. Na caixa de diálogo Navegador , você pode selecionar uma tabela e transformar os dados no editor do Power Query selecionando Transformar Dados.

    Captura de tela do navegador online com a lista alfabética de produtos selecionados e exibidos.

    Se você tiver várias tabelas que tenham uma relação direta com uma ou mais das tabelas já selecionadas, selecione o botão Selecionar Tabelas Relacionadas . Quando você faz isso, todas as tabelas que têm uma relação direta com uma ou mais das tabelas já selecionadas também são importadas.

Conectando-se ao Microsoft Graph

Não é recomendado ou há suporte para conectar-se às APIs REST do Microsoft Graph a partir do Power Query. Para obter mais informações, acesse Falta de suporte para o Microsoft Graph no Power Query.

Problemas e limitações conhecidos

Conexões encerradas ao conectar-se a OData/fontes da Web

Devido à arquitetura do OData e de outros conectores Web, as junções podem ser lentas. Uma junção lenta às vezes pode fazer com que a origem falhe na conexão, resultando em um erro como "Uma conexão existente foi fechada à força pelo host remoto". Embora você tenha a opção de usar colunas de navegação ao mesclar entre tabelas de uma origem OData, você não tem essa opção ao mesclar com fontes não OData. Se você estiver vendo esses problemas ao mesclar uma fonte OData ou Web e não conseguir usar uma coluna de navegação, deverá aplicar Table.Buffer à consulta no editor avançado, antes de mesclar os dados.

É recomendável armazenar em buffer o menor número de consultas que estão sendo mescladas para otimizar o desempenho. Você também pode tentar alternar a ordem das consultas na junção para otimizar a consulta.

Problemas de conexão em teste

Nos casos em que você está passando uma URL para o conector OData que não é apenas a raiz do serviço (por exemplo, se houver um filtro na URL), ao configurar a atualização no serviço, você deverá selecionar Ignorar Teste de Conexão.

Quando você insere credenciais para um serviço OData no serviço do Power BI (por exemplo, depois de publicar um PBIX que usa OData.Feed), o serviço do Power BI testa as credenciais, mas ignora todas as opções de consulta especificadas na consulta M. Essas opções de consulta podem ter sido especificadas diretamente na fórmula (por exemplo, usando a barra de fórmulas ou o editor avançado) ou podem ter sido adicionadas pelo editor do Power Query por padrão. Você pode encontrar a lista completa dessas opções de consulta no OData.Feed.

Autenticação para serviços arbitrários

Alguns serviços suportam a capacidade do conector OData de autenticar diretamente com OAuth/Microsoft Entra ID. No entanto, essa capacidade não funciona na maioria dos casos.

Ao tentar autenticar, se ocorrer o seguinte erro:

We were unable to connect because this credential type isn’t supported for this resource. Please choose another credential type.

Captura de tela do erro ao se conectar a um ponto de extremidade que não dá suporte ao OAuth com o conector Web.

Contate o proprietário do serviço. Eles precisam alterar a configuração de autenticação ou criar um conector personalizado.

Tamanho máximo da URL

Se você estiver usando o conector do feed OData para se conectar a uma lista do SharePoint, à lista online do SharePoint ou ao Project Online, o comprimento máximo da URL para essas conexões será de aproximadamente 2.100 caracteres. Exceder o limite de caracteres resulta em um erro 401. Esse comprimento máximo de URL é criado no front-end do SharePoint e não pode ser alterado.

Para contornar essa limitação, parta do ponto de extremidade raiz do OData e, em seguida, navegue e filtre no Power Query. O Power Query filtra essa URL localmente quando a URL é muito longa para o SharePoint manipular. Por exemplo, comece com:

OData.Feed("https://contoso.sharepoint.com/teams/sales/_api/ProjectData")

Em vez de

OData.Feed("https://contoso.sharepoint.com/teams/sales/_api/ProjectData/Projects?select=_x0031_MetricName...etc...")