Поделиться через


Источник OData

Сводка

Товар Описание
Статус релиза Общая доступность
Продукция Эксель
Power BI (семантические модели)
Power BI (потоки данных)
Fabric (Dataflow 2-го поколения)
Power Apps (потоки данных)
Dynamics 365 Customer Insights
Службы анализа
Поддерживаемые типы проверки подлинности Анонимный
Windows (требуется шлюз)
Базовый (требуется шлюз)
Веб-API
Учетная запись организации
Справочная документация по функциям OData.Feed, ODataOmitValues.Nulls

Замечание

Некоторые возможности могут присутствовать в одном продукте, но не другие из-за расписаний развертывания и возможностей для конкретного узла.

Поддерживаемые возможности

  • Базовый
  • Продвинутый
    • Части URL-адресов
    • Открыть столбцы типа
  • Выбор связанных таблиц

Замечание

Microsoft Graph не поддерживается. Дополнительные сведения: отсутствие поддержки Microsoft Graph в Power Query

Загрузка данных из канала данных OData в Power Query Desktop

Чтобы загрузить данные из OData в Power Query Desktop:

  1. Выберите OData или OData Feed в интерфейсе получения данных. Взаимодействие с данными в Power Query Desktop зависит от приложений. Дополнительные сведения о Power Query Desktop для вашего приложения см. в разделе Где получить данные.

  2. Нажмите кнопку "Базовый " и введите URL-адрес в текстовом поле. Этот URL-адрес должен быть корнем службы OData, к которой требуется подключиться. Например, введите https://services.odata.org/V4/northwind/northwind.svc/. Затем нажмите кнопку "ОК".

    Выбор URL-адреса OData.

    Если вводимый URL-адрес недопустим, значок предупреждения появится рядом с текстовым полем URL-адреса .

  3. Если это первый раз, когда вы подключаетесь с помощью веб-канала OData, выберите тип проверки подлинности, введите свои учетные данные (при необходимости) и выберите уровень для применения параметров проверки подлинности. В этом случае выберите Подключиться.

    Выбор учетных данных OData.

  4. В диалоговом окне "Навигатор " можно выбрать таблицу, а затем преобразовать данные в редакторе Power Query, выбрав "Преобразовать данные" или загрузить данные, выбрав "Загрузка".

    Выбор веб-таблицы.

    Если у вас несколько таблиц с прямой связью с одной или несколькими уже выбранными таблицами, можно выбрать кнопку "Выбрать связанные таблицы". При выполнении все таблицы, имеющие прямую связь с одной или несколькими уже выбранными таблицами, также будут импортированы.

Загрузка данных из канала OData в Power Query Online

Чтобы загрузить данные из канала OData в Power Query Online:

  1. Выберите параметр "OData" или "OData Feed" в параметрах получения данных. Различные приложения имеют различные способы получения данных в Power Query Online. Дополнительные сведения о том, как воспользоваться функцией получения данных в Power Query Online из вашего приложения, см. в разделе Где получить данные.

    Снимок экрана: окно получения данных с выделенным элементом OData.

  2. В появившемся диалоговом окне OData введите URL-адрес в текстовом поле.

    Снимок экрана: страница входа в OData online.

  3. Если это первый раз, когда вы подключаетесь с помощью веб-канала OData, выберите тип проверки подлинности и введите учетные данные (при необходимости). Затем выберите Далее.

  4. В диалоговом окне "Навигатор " можно выбрать таблицу, а затем преобразовать данные в редакторе Power Query, выбрав "Преобразовать данные".

    Снимок экрана: онлайн-навигатор с алфавитным списком выбранных и отображаемых продуктов.

    Если у вас несколько таблиц с прямой связью с одной или несколькими уже выбранными таблицами, можно выбрать кнопку "Выбрать связанные таблицы". При выполнении все таблицы, имеющие прямую связь с одной или несколькими уже выбранными таблицами, также будут импортированы.

Подключение к Microsoft Graph

Подключение к Microsoft Graph REST API через Power Query не рекомендуется и не поддерживается. Дополнительные сведения: отсутствие поддержки Microsoft Graph в Power Query

Известные проблемы и ограничения

Подключения закрыты при присоединении к OData или веб-источникам

Благодаря архитектуре OData и других веб-соединителей соединения могут быть медленными. Медленное соединение иногда может привести к сбою подключения источника, что привело к ошибке, например "Существующее соединение было принудительно закрыто удаленным узлом". Хотя у вас есть возможность использовать столбцы навигации при слиянии между таблицами из источника OData, при слиянии с не-OData источниками этой возможности нет. Если при слиянии OData или веб-источника возникают такие проблемы и не удается использовать столбец навигации, перед слиянием данных следует применить Table.Buffer к запросу в расширенном редакторе.

Рекомендуется буферизация меньшего размера объединенных запросов для оптимизации производительности. Вы также можете попробовать изменить порядок запросов в объединении для улучшения производительности запроса.

Проверка проблем с подключением

Если вы передаете URL-адрес в соединитель OData, который включает больше, чем просто корень службы (например, если в вашем URL-адресе есть фильтр), при настройке обновления в службе следует выбрать пропуск тестового подключения.

При вводе учетных данных для службы OData в службу Power BI (например, после публикации PBIX, использующего OData.Feed), служба Power BI тестирует учетные данные, но будет игнорировать все параметры запроса, указанные в запросе M. Эти параметры запроса могут быть указаны непосредственно в формуле (например, с помощью строки формул или расширенного редактора) или могут быть добавлены редактором Power Query по умолчанию. Полный список этих параметров запроса можно найти в OData.Feed.

Проверка подлинности в произвольных службах

Некоторые службы поддерживают аутентификацию соединителя OData с помощью OAuth/Microsoft Entra ID из коробки. Однако в большинстве случаев это не будет работать.

При попытке пройти проверку подлинности, если возникает следующая ошибка:

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

Ошибка при подключении к конечной точке, которая не поддерживает OAuth с веб-соединителем.

Обратитесь к владельцу службы. Им потребуется изменить конфигурацию проверки подлинности или создать пользовательский соединитель.

Максимальная длина URL-адреса

Если вы используете соединитель канала OData для подключения к списку SharePoint, списку SharePoint online или Project Online, максимальная длина URL-адреса для этих подключений составляет примерно 2100 символов. Превышение предела символов приводит к ошибке 401. Эта максимальная длина URL-адреса создается в интерфейсной части SharePoint и не может быть изменена.

Чтобы обойти это ограничение, начните с корневой конечной точки OData, а затем перейдите и отфильтруйте внутри Power Query. Power Query фильтрует этот URL-адрес локально, если URL-адрес слишком длинный для обработки SharePoint. Например, начните с:

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

Вместо

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