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


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

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

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

Внимание

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

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

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

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

Внимание

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

  1. Настройте разрешения, необходимые для доступа к Аналитике.

  2. Запустите Power BI Desktop.

  3. На странице приветствия Power BI Desktop или домашней ленте выберите " Получить данные".

    Снимок экрана: экран-заставка Power BI Desktop, кнопка

  4. Выберите другой>канал>OData Connect.

    Снимок экрана: кнопка

  5. В поддерживаемом браузере введите 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-адрес.

    Снимок экрана: URL-адрес веб-канала OData.

    Примечание.

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

  7. Установите флажки рядом с сущностями, данные которых требуется извлечь.

    Внимание

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

    Снимок экрана: список сущностей на странице навигатора.

  8. Выберите Преобразование данных. Не нажимайте кнопку "Загрузить".

    Внимание

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

    Чтобы предотвратить эту проблему, выполните указанные ниже действия.

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

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

    Снимок экрана: список запросов веб-канала OData Power BI.

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

    Снимок экрана: кнопка Расширенный редактор веб-канала OData Power BI.

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

    Снимок экрана: панель запросов Расширенный редактор.

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

    Снимок экрана: замененная строка.

  10. Нажмите кнопку "Закрыть" и " Применить".