Power BI 및 OData 쿼리를 사용하여 데이터와 연결

  • 아티클

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Power BI로 데이터를 끌어오려면 OData(Open Data Protocol) 쿼리를 사용하는 것이 좋습니다. OData는 REST API를 빌드하고 사용하는 모범 사례를 정의하는 ISO/IEC 승인 OASIS 표준입니다. 자세한 내용은 OData 설명서를 참조 하세요.

빠르게 시작하려면 OData 쿼리를 사용하는 샘플 보고서의 개요를 검사. 다른 방법에 대한 자세한 내용은 Power BI 통합 개요를 참조하세요.

Power BI는 필터링되거나 집계된 데이터 집합을 Power BI에 반환할 수 있는 OData 쿼리를 실행할 수 있습니다. OData 쿼리에는 두 가지 장점이 있습니다.

  • 모든 필터링은 서버 쪽에서 수행됩니다. 필요한 데이터만 반환되므로 새로 고침 시간이 짧아집니다.
  • 데이터 서버 쪽을 미리 집계할 수 있습니다. OData 쿼리는 작업 항목 롤업 및 빌드 실패율과 같은 집계를 수행할 수 있습니다. 집계는 서버 쪽에서 수행되며 집계 값만 Power BI로 반환됩니다. 사전 집계를 사용하면 모든 세부 데이터를 Power BI로 끌어올 필요 없이 큰 데이터 세트 간에 집계를 수행할 수 있습니다.

이 문서에서는 다음 방법을 설명합니다.

  • OData 쿼리를 작성하고 테스트합니다.
  • Power BI에서 OData 쿼리를 실행합니다.

필수 조건

  • 분석 데이터를 보고 서비스를 쿼리하려면 기본 액세스 이상의 프로젝트 멤버여야 합니다. 기본적으로 모든 프로젝트 멤버에는 분석을 쿼리하고 분석 뷰를 정의할 수 있는 권한이 부여됩니다.
  • 서비스 및 기능 사용 및 일반 데이터 추적 활동과 관련된 다른 필수 구성 요소에 대해 알아보려면 분석에 액세스하기 위한 사용 권한 및 필수 구성 요소를 참조 하세요.

Visual Studio Code를 사용하여 OData 쿼리 작성 및 테스트

OData를 작성하고 테스트하는 가장 쉬운 방법은 OData 확장과 함께 Visual Studio Code를 사용하는 것입니다. Visual Studio Code는 Windows, Mac 및 Linux에서 사용할 수 있는 무료 코드 편집기입니다. OData 확장은 쿼리 작성 및 테스트에 유용한 구문 강조 표시 및 기타 함수를 제공합니다.

Visual Studio Code 및 OData 확장 설치

  1. Visual Studio Code를 설치합니다.

  2. Visual Studio Code를 열고 확장을 선택한 다음 odata를 검색합니다. 결과 목록에서 vscode-odata를 선택한 다음 설치합니다.

  3. 예를 들어 filename.odataVisual Studio Code에서 OData 파일을 만들고 저장합니다. 원하는 대로 이름을 지정하지만 OData 확장 기능을 사용하도록 설정하려면 확장이 있어야 합니다 .odata .

OData 쿼리 작성

  1. OData 쿼리를 작성합니다. 예제 쿼리는 OData 쿼리를 사용하는 샘플 보고서의 개요를 참조하세요.

    다음 쿼리는 특정 영역 경로에서 상위 10개 작업 항목을 반환합니다.

  2. {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} 합니다.

자세한 내용은 OData 쿼리 빠른 참조를 참조하세요.

Visual Studio Code에서 쿼리를 작성한 후에는 구문 강조 표시가 표시됩니다.

구문이 강조 표시된 Visual Studio Code OData 확장을 보여 주는 스크린샷

OData 쿼리 테스트

  1. OData 쿼리를 테스트하려면 쿼리 텍스트의 아무 곳에나 커서를 놓고 명령 팔레트 보기를>선택합니다.

  2. 검색 상자에 odata를 입력하여 모든 OData 명령을 표시합니다.

    Visual Studio Code OData 확장에 대한 명령 팔레트를 보여 주는 스크린샷

  3. OData: 열기를 선택합니다. 이 작업은 여러 줄 쿼리를 한 줄 URL로 결합하여 기본 브라우저에서 엽니다.

    • OData 쿼리 결과 집합은 JSON 형식입니다. 결과를 보려면 브라우저에 대한 JSON 포맷터 확장을 설치합니다. Chrome 및 Microsoft Edge 모두에 몇 가지 옵션을 사용할 수 있습니다.

      Visual Studio Code OData 확장에 대한 JSON 출력을 보여 주는 스크린샷

    • 쿼리에 오류가 있는 경우 Analytics 서비스는 JSON 형식으로 오류를 반환합니다. 예를 들어 이 오류는 쿼리가 존재하지 않는 필드를 선택했음을 표시합니다.

      Visual Studio Code OData 확장에 대한 JSON 오류를 보여 주는 스크린샷

쿼리가 올바르게 작동하는지 확인한 후 Power BI에서 실행할 수 있습니다.

Power BI에서 OData 쿼리 실행

Power BI에서 OData 쿼리를 실행하려면 다음 섹션의 단계를 수행합니다.

여러 줄 OData 쿼리를 한 줄 쿼리로 결합

Power BI에서 쿼리를 사용하려면 먼저 여러 줄 OData 쿼리를 한 줄 쿼리로 변환해야 합니다. 이렇게 하는 가장 간단한 방법은 OData 확장과 함께 Visual Studio Code를 사용하고 OData: Combine 명령을 사용하는 것입니다.

참고 항목

filename.odata 파일에서 먼저 여러 줄 쿼리 텍스트의 복사본을 만든 다음, OData: 복사본에서 결합을 실행할 수 있습니다. 한 줄 쿼리를 읽을 수 있는 여러 줄 쿼리로 다시 변환할 방법이 없으므로 먼저 이 단계를 수행합니다.

  1. Visual Studio Code에서 쿼리 텍스트의 아무 곳에나 쿼리를 배치한 다음 명령 팔레트 보기를>선택합니다. 검색 상자에 odata를 입력 합니다. 그런 다음, 결과 목록에서 OData: 결합을 선택합니다.

    여러 줄 쿼리가 한 줄 쿼리로 변환됩니다.

    한 줄 쿼리에 결합된 Visual Studio Code OData 확장을 보여 주는 스크린샷

  2. 다음 섹션에서 사용할 전체 줄을 복사합니다.

Power BI에서 쿼리 실행

  1. 데이터>OData 피드 가져오기를 선택합니다. 자세한 내용은 OData 쿼리를 사용하여 Power BI 보고서 만들기를 참조 하세요.

    Power BI OData 피드 명령을 보여 주는 스크린샷

  2. OData 피드 창의 URL 상자에 이전 섹션에서 복사한 OData 쿼리를 붙여넣은 다음 확인을 선택합니다.

    .

    Power BI는 미리 보기 페이지를 표시합니다.

    Power BI OData 피드의 미리 보기 페이지를 보여 주는 스크린샷.

쿼리 옵션 지정

  1. 미리 보기 페이지에서 편집을 선택하여 Power Query 편집기 엽니다.

    Power BI OData 피드에 대해 열려 있는 Power Query 편집기 보여 주는 스크린샷

  2. 리본에서 고급 편집기 선택합니다.

    Power BI OData 피드에 대해 선택된 고급 편집기 보여 주는 스크린샷

  3. 가로로 스크롤하여 쿼리 창에서 매개 변수를 봅니 [Implementation="2.0"] 다.

    고급 편집기 오른쪽으로 스크롤된 Power BI OData 피드를 보여 주는 스크린샷.

  4. 다음 문자열로 바꿉다 [Implementation="2.0"] .

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

    대체 문자열을 보여 주는 스크린샷.

    참고 항목

    제한 오류를 방지하려면 다음 작업을 수행합니다.

    • OData v4를 참조하도록 Power BI에 지시합니다.
    • 쿼리 성능을 향상시키는 null 값을 생략하도록 Analytics 서비스에 지시합니다. 파워 쿼리는 발생하는 모든 null 값에 대해 다른 쿼리를 생성하여 null 값을 오류로 해결하려고 시도합니다. 이 작업을 수행하면 수천 개의 쿼리가 발생할 수 있으며, 이는 사용자 계정이 제한되는 범위를 벗어나는 사용량 임계값을 빠르게 초과합니다.

    Power BI가 Azure DevOps Analytics Service에 대해 OData 쿼리를 성공적으로 실행하려면 다음 작업이 필요합니다.

  5. 확인을 선택하여 고급 편집기 닫고 Power BI Power Query 편집기 돌아갑니다. Power Query 편집기 사용하여 다음과 같은 선택적 작업을 수행할 수 있습니다.

    • 쿼리 이름을 Query1 좀 더 구체적인 것으로 바꿉니다.
    • 열을 특정 형식으로 변환합니다. Power BI는 형식을 자동으로 검색하지만 열을 특정 데이터 형식으로 변환할 수 있습니다.
    • 계산 열을 추가합니다.
    • 열 제거.
    • 열을 특정 필드로 확장합니다.

데이터를 사용하여 보고서 만들기

닫기 및 적용을 선택하여 설정을 저장하고 데이터를 Power BI로 끌어오세요. 데이터를 새로 고친 후 Power BI에서 정상적으로 보고서를 만들 수 있습니다.

Power BI 닫기 및 적용 단추를 보여 주는 스크린샷