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

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

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2020

Чтобы извлечь данные в Power BI, рекомендуется использовать запросы Open Data Protocol (OData). OData — это стандарт, установленный Организацией по улучшению структурированных информационных стандартов (OASIS) и утвержденный Международной организацией по стандартизации и Международной электротехническая комиссия (ISO/IEC). OData определяет рекомендации по созданию и использованию REST API. Дополнительные сведения см. в документации по OData.

Чтобы быстро приступить к работе, ознакомьтесь с обзором примеров отчетов с помощью запросов OData. Дополнительные сведения о других подходах см. в разделе "Сведения об интеграции Power BI".

Power BI может выполнять запросы OData, которые могут возвращать отфильтрованный или агрегированный набор данных в Power BI. Запросы OData имеют два преимущества:

  • Все фильтрация выполняется на стороне сервера. Возвращаются только необходимые данные, что приводит к более короткому времени обновления.
  • На стороне сервера данные можно предварительно агрегировать. Запрос OData может выполнять агрегации, такие как сводка рабочих элементов и показатели сбоев сборки. Агрегаты выполняются на стороне сервера, и в Power BI возвращаются только статистические значения. С помощью предварительной статистической обработки можно выполнять агрегирование между большими наборами данных, не требуя извлечения всех подробных данных в Power BI.

Изучив это руководство, вы:

  • Написание и проверка запросов OData.
  • Запустите запрос OData из Power BI.

Предварительные условия

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

Использование Visual Studio Code для записи и тестирования запросов OData

Самый простой способ записи и тестирования OData — использовать Visual Studio Code с расширением OData. Visual Studio Code — это бесплатный редактор кода, доступный в Windows, Mac и Linux. Расширение OData обеспечивает выделение синтаксиса и другие функции, которые полезны для написания и тестирования запросов.

Установка Visual Studio Code и расширение OData

  1. Установка Visual Studio Code.

  2. Откройте Visual Studio Code, выберите расширения и найдите odata. В списке результатов выберите vscode-odata и установите это расширение.

  3. В Visual Studio Code создайте файл OData, создав пустой файл с расширением Odata. Вы можете присвоить ему имя, например filename.odata. Но он должен иметь расширение .odata, чтобы включить функционал расширения OData.

Напишите запрос OData

Напишите запрос OData. Примеры запросов см. в разделе "Обзор примеров отчетов с помощью запросов OData".

Следующий запрос возвращает первые 10 рабочих элементов в рамках определенной области. Чтобы использовать этот запрос, замените {organization}, {project} и {area path} на ваши значения.

https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItems?
      $select=WorkItemId,Title,WorkItemType,State,CreatedDate
      &$filter=startswith(Area/AreaPath,'{area path}')
      &$orderby=CreatedDate desc
      &$top=10

Чтобы выполнять запросы между проектами, опустим /{project} полностью.

Дополнительные сведения см. в примерах отчетов и кратком справочном индексе.

После написания запроса в Visual Studio Code вы увидите выделение синтаксиса.

Снимок экрана: файл OData в Visual Studio Code. Каждый тип элемента кода имеет собственный цвет.

Тестирование запроса OData

  1. Чтобы протестировать запрос OData, поместите курсор в любое место в тексте запроса, а затем выберите "Просмотреть>палитру команд".

  2. В поле поиска введите odata , чтобы открыть команды OData.

    Снимок экрана: палитра команд для расширения OData Visual Studio Code.

  3. Выберите OData: Открыть. Это действие объединяет многострочный запрос в однострочный URL-адрес, запускает запрос и открывает результаты в браузере по умолчанию.

    • Результирующий набор запросов OData находится в формате JSON. Чтобы просмотреть результаты, установите расширение форматирования JSON для браузера. Для Chrome и Microsoft Edge доступны несколько вариантов.

      Снимок экрана: браузер, в котором показаны выходные данные JSON запроса OData, отображаемого в удобочитаемом формате.

    • Если запрос имеет ошибку, служба Аналитики возвращает ошибку в формате JSON. Например, следующая ошибка указывает, что запрос выбирает поле, которое не существует.

      Снимок экрана: браузер, в котором показаны выходные данные JSON в доступном для чтения формате. Сообщение в выходных данных указывает на ошибку в запросе OData.

Убедившись, что запрос работает правильно, его можно запустить из Power BI.

Выполнение запроса OData из Power BI

Чтобы запустить запрос OData из Power BI, выполните действия, описанные в следующих разделах.

Объединение многострочного запроса OData в однострочный запрос

Прежде чем использовать запрос в Power BI, необходимо преобразовать многострочный запрос OData в однострочный запрос. Чтобы использовать OData: объединить команду для этой цели, сделайте следующее:

  1. Создайте копию файла OData, содержащего текст многострочного запроса. Этот шаг рекомендуется, так как нет способа преобразовать однострочный запрос обратно в доступный для чтения многострочный запрос.

  2. В Visual Studio Code откройте копию файла OData и поместите курсор в любое место в тексте запроса.

  3. Выберите Вид>Палитра команд. В поле поиска введите odata. Затем в списке результатов выберите OData: Объединить.

    Многострочный запрос преобразуется в однострочный запрос.

    Снимок экрана: файл OData в Visual Studio Code. Файл содержит многострочный запрос, за которым следует однострочный вариант запроса.

  4. Скопируйте всю строку для использования в следующем разделе.

Выполнение запроса из Power BI

  1. В Power BI выберите Получить данные>Канал OData. Дополнительные сведения см. в статье "Создание отчета Power BI с помощью запроса OData".

    Снимок экрана Power BI с выделенными пунктами

  2. В окне веб-канала OData в поле URL-адреса вставьте запрос OData, скопированный в предыдущем разделе, и нажмите кнопку "ОК".

    Снимок экрана: диалоговое окно веб-канала OData. Поле URL-адреса содержит однострочный запрос OData.

    Power BI отображает страницу предварительного просмотра.

    Снимок экрана: страница предварительного просмотра в Power BI с кнопками для загрузки и преобразования данных. В таблице перечислены сведения о нескольких рабочих элементах.

Указание параметров запроса

  1. На странице предварительного просмотра выберите "Преобразовать данные ", чтобы открыть редактор Power Query.

    Снимок экрана редактора Power Query. В таблице перечислены данные канала OData для нескольких рабочих элементов.

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

    Снимок экрана: лента Power BI. Выделен расширенный редактор.

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

    Снимок экрана: окно расширенного редактора. Конец запроса отображается, а параметр реализации выделен.

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

    [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]

    Снимок экрана: окно расширенного редактора. Конец запроса отображается. Он содержит строку замены и выделен.

    Это изменение помогает предотвратить ошибки регулирования. Новые значения имеют следующий эффект:

    • Они поручают Power BI ссылаться на OData версии 4.
    • Они указывают службе Аналитики опустить все значения, которые имеют значение NULL, что повышает производительность запросов.

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

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

    • Переименуйте Query1 запрос как что-то более конкретное.
    • Преобразование столбцов в определенный тип. Power BI автоматически обнаруживает тип, но может потребоваться преобразовать столбцы в определенный тип данных.
    • Добавьте вычисляемые столбцы.
    • Удалите столбцы.
    • Разверните столбцы в определенные поля.

Создание отчета с помощью данных

Нажмите кнопку "Закрыть" и " Применить" , чтобы сохранить параметры и извлечь данные в Power BI. После обновления данных можно создать отчет, как обычно, в Power BI.

Снимок экрана: лента Power BI. Выделена кнопка

Связанный контент