Feed OData

  • Artigo

Resumo

Item Descrição
Estado da liberação Disponibilidade geral
Produtos Excel
Power BI (Modelos semânticos)
Power BI (Fluxos de dados)
Malha (fluxo de dados Gen2)
Power Apps (Fluxos de dados)
Dynamics 365 Customer Insights
Analysis Services
Tipos de autenticação compatíveis Anônimo
Windows (requer Gateway)
Básico (requer Gateway)
API Web
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 cronogramas de implantação e funcionalidades específicas do host.

Funcionalidades com suporte

  • Basic
  • Avançado
    • Partes da URL
    • Abrir colunas de tipo
  • 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 do OData no Power Query Desktop:

  1. Selecione a opção OData ou OData Feed na experiência para obter dados. A experiência para obter dados no Power Query Desktop varia entre aplicativos. Para saber mais informações sobre a experiência para obter dados no 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 http://services.odata.org/V4/northwind/northwind.svc/. Em seguida, selecione OK.

    Seleção de URL OData.

    Se o endereço do URL inserido for inválido, um ícone de aviso Ícone de Aviso. aparecerá ao lado da caixa de texto URL.

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

    Seleção de credenciais OData.

  4. No diálogo do Navegador, é possível selecionar uma tabela e transformar os dados no editor do Power Query ao selecionar Transformar Dados ou carregar os dados ao selecionar Carregar.

    Seleção de tabela da Web.

    Se você tiver várias tabelas que têm uma relação direta com uma ou mais das tabelas já selecionadas, poderá selecionar o botão Selecionar Tabelas Relacionadas. Quando você fizer isso, 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 do OData no Power Query Online:

  1. Selecione a opção OData ou OData Feed na experiência para obter dados. Cada aplicativo acessa de uma forma diferente a experiência para obter dados do Power Query Online. Para saber mais informações sobre como acessar a experiência para obter dados do Power Query Online pelo seu aplicativo, acesse Onde obter dados.

    Captura de tela da janela Obter dados com OData enfatizada.

  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 essa for a primeira vez que você estiver se conectando usando o Feed do OData, selecione o tipo de autenticação e insira suas credenciais (se necessário). Em seguida, selecione Avançar.

  4. No diálogo do Navegador, é possível selecionar uma tabela e transformar os dados no editor do Power Query ao selecionar 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 têm uma relação direta com uma ou mais das tabelas já selecionadas, poderá selecionar o botão Selecionar Tabelas Relacionadas. Quando você fizer isso, todas as tabelas que têm uma relação direta com uma ou mais das tabelas já selecionadas também serão importadas.

Conectar-se ao Microsoft Graph

A conexão com o Microsoft Graph (às APIs REST) do Power Query não é recomendada ou não é compatível. Mais informações: Falta de suporte para o Microsoft Graph no Power Query

Limitações e problemas conhecidos

Junções

Devido à arquitetura do OData e de 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 origem OData, você não tem essa opção ao mesclar com fontes não Odata.

Se você estiver vendo problemas de desempenho ao mesclar uma fonte OData, deverá aplicar Table.Buffer à 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ê deverá 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 no OData.Feed.

Autenticação em serviços arbitrários

Alguns serviços dão suporte à capacidade do conector para OData de utilizar a 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 durante a conexão com um ponto de extremidade que não oferece suporte ao OAuth com o conector Web.

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

Tamanho máximo da URL

Se você estiver usando o conector de feed OData para se conectar a uma lista do SharePoint, à lista online do SharePoint ou 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, comece com o ponto de extremidade raiz do OData e navegue e filtre dentro de Power Query. 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...")