Partilhar via

Feed OData

  • Artigo

Resumo

Item Description
Estado de Lançamento Disponibilidade Geral
Produtos Excel
Power BI (modelos semânticos)
Power BI (Fluxos de Dados)
Malha (Dataflow Gen2)
Power Apps (Fluxos de Dados)
Dynamics 365 Customer Insights
Analysis Services
Tipos de autenticação suportados Anónimo
Windows (requer Gateway)
Básico (requer Gateway)
API da Web
Conta Organizacional
Documentação de referência da função OData.Feed, ODataOmitValues.Nulls

Nota

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ásica
  • Avançado
    • Partes de URL
    • Abrir colunas de texto
  • Selecionar tabelas relacionadas

Nota

O Microsoft Graph não é suportado. Para obter 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 obter dados. A experiência de obtenção de dados no Power Query Desktop varia entre aplicações. Para obter mais informações sobre a experiência de obter dados do Power Query Desktop para a sua aplicação, aceda a Onde obter dados.

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

    Seleção de URL OData.

    Se o endereço URL introduzido for inválido, será apresentado um Ícone de aviso.ícone de aviso junto à caixa de texto URL.

  3. Se esta for a primeira vez que você está se conectando usando o OData Feed, 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. Em seguida, selecione Conectar.

    Seleção de credenciais OData.

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

    Seleção de tabelas da Web.

    Se você tiver várias tabelas que tenham uma relação direta com uma ou mais das tabelas já selecionadas, poderá selecionar o botão Selecionar Tabelas Relacionadas . Quando o fizer, todas as tabelas que têm uma relação direta com uma ou mais das tabelas já selecionadas também serã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 obter dados. Diferentes aplicações têm formas diferentes de aceder à experiência de obtenção de dados do Power Query Online. Para obter mais informações sobre como aceder à experiência de obter dados do Power Query Online a partir da sua aplicação, aceda a Onde obter dados.

    Captura de tela da janela obter dados com OData enfatizado.

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

    Captura de ecrã da página de início de sessão online do OData.

  3. Se esta for a primeira vez que você está se conectando usando o OData Feed, selecione o tipo de autenticação e insira suas credenciais (se necessário). Em seguida, selecione Seguinte.

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

    Captura de ecrã do navegador online com a lista alfabética de produtos selecionados e apresentados.

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

Conectando-se ao Microsoft Graph

A ligação a APIs REST do Microsoft Graph a partir do Power Query não é recomendada nem suportada. Para obter mais informações: Falta de suporte para o Microsoft Graph no Power Query

Limitações e Problemas Conhecidos

Associações

Devido à arquitetura do OData e outros conectores da Web, as junções podem não ter desempenho. Embora você tenha a opção de usar colunas de navegação ao mesclar entre tabelas de uma fonte OData, não tem essa opção ao mesclar com fontes que não sejam Odata.

Se você estiver vendo problemas de desempenho ao mesclar uma fonte OData, aplique Table.Buffer à sua consulta OData no editor avançado, antes de mesclar os dados.

Problemas de conexão de 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 você tiver um filtro na URL), ao configurar a atualização no serviço, você deve selecionar Ignorar conexão de teste.

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 testará as credenciais, mas ignorará 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 em OData.Feed.

Autenticação em serviços arbitrários

Alguns serviços suportam a capacidade do conector OData de autenticar com autenticação OAuth/Microsoft Entra ID pronta para uso. No entanto, isso não funcionará 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.

Erro ao conectar-se a um ponto de extremidade que não suporta OAuth com o conector da Web.

Entre em contato com o proprietário do serviço. Eles precisarão alterar a configuração de autenticação ou criar um conector personalizado.

Comprimento máximo do URL

Se você estiver usando o conector de feed OData para se conectar a uma lista do SharePoint, lista do SharePoint online ou Project Online, o comprimento máximo da URL para essas conexões é de aproximadamente 2100 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 esta limitação, comece com o ponto de extremidade OData raiz e, em seguida, navegue e filtre dentro do Power Query. O Power Query filtra este URL localmente quando o URL é demasiado longo 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...")