Подключение к данным аналитики с помощью веб-канала OData Power BI

Статья
09/06/2024

Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019

Узнайте, как получить доступ к данным аналитики с помощью веб-канала OData Power BI Desktop.

Внимание

Метод, показанный в этой статье, работает для небольших организаций, так как он всегда извлекает все данные в Power BI. Большая часть фильтрации, указанной в Редактор Power Query, выполняется на стороне клиента. Дополнительные сведения о других подходах см. в разделе "Обзор интеграции Power BI".

Необходимые компоненты

Доступ. Быть членом проекта с по крайней мере базовым доступом.
Разрешения. По умолчанию члены проекта имеют разрешение на запросы аналитики и создания представлений.
Дополнительные сведения о других предварительных требованиях для включения служб и функций и общих действий отслеживания данных см. в разделе "Разрешения и предварительные требования для доступа к аналитике".

Установка Power BI Desktop.

Доступ к веб-каналу OData аналитики

Внимание

Убедитесь, что вы включили или установили расширение Analytics.

Настройте разрешения, необходимые для доступа к Аналитике.
Запустите Power BI Desktop.
На странице приветствия Power BI Desktop или домашней ленте выберите " Получить данные".
Выберите другой>канал>OData Connect.
В поддерживаемом браузере введите URL-адрес в следующем формате https://analytics.dev.azure.com/{OrganizationName}/_odata/{version}/.

Например, если {OrganizationName} — fabrikam, а {version} — версия 1.0, URL-адрес — это https://analytics.dev.azure.com/fabrikam/_odata/v1.0/URL-адрес. Используемая версия зависит от последней поддерживаемой версии для OData аналитики.
Примечание.
- Кроме того, можно ввести URL-адрес с указанным именем Проекта , как показано в следующем примере:
  https://analytics.dev.azure.com/{OrganizationName}/{ProjectName}/_odata/{version}/ Использование этого формата обрезает результаты по указанному проекту во всех сущностях, связанных с этим проектом.
- Область данных всегда находится на уровне проекта по проектированию, поэтому вы не можете подключиться на уровне организации. Если вы хотите получить все данные для всех проектов, необходимо подключиться к одному за раз.
В запросе выполните проверку подлинности в службе.
Установите флажки рядом с сущностями, данные которых требуется извлечь.

Внимание

Не выбирайте сущности, имя которых включает моментальный снимок. Такие сущности содержат состояние каждого рабочего элемента в каждый день после создания рабочего элемента. Для репозиториев любого размера выбор этих сущностей приводит к сбою загрузки десятков миллионов рабочих элементов. Таблицы моментальных снимков предназначены только для агрегирования запросов.
Выберите Преобразование данных. Не нажимайте кнопку "Загрузить".
Внимание

Для каждой выбранной сущности Power Query создает запрос. Необходимо вручную обновить каждый запрос, чтобы предотвратить ошибки регулирования. Power Query пытается устранить значения NULL в виде ошибок, создав дополнительный запрос для каждого обнаруженного значения NULL. Это действие может привести к тысячам запросов, которые могут быстро превысить пороговое значение использования, за пределами которого ваша учетная запись пользователя будет регулироваться.

Чтобы предотвратить эту проблему, выполните указанные ниже действия.
- Указание Power BI ссылаться на OData версии 4.
- Указать службе Аналитики опустить все значения, которые имеют значение NULL, что повышает производительность запросов.
Для каждой сущности, выбранной на предыдущих шагах, сделайте следующее:

a. В списке "Запросы " выберите сущность, запрос которой требуется выполнить. В этом примере выбраны области .

b. На ленте выберите Расширенный редактор.

c. В области запросов прокрутите по горизонтали, чтобы просмотреть [Implementation="2.0"] параметр.

d. Замените [Implementation="2.0"] следующей строкой: [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]
Нажмите кнопку "Закрыть" и " Применить".