다음을 통해 공유


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

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

Power BI로 데이터를 끌어오려면 OData(Open Data Protocol) 쿼리를 사용하는 것이 좋습니다. OData는 OASIS(구조적 정보 표준 발전 기구)에서 설립하고 국제표준화기구 및 국제전기기술위원회(ISO/IEC)의 승인을 받은 표준입니다. OData는 REST API를 빌드하고 사용하는 모범 사례를 정의합니다. 자세한 내용은 OData 설명서를 참조 하세요.

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

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

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

이 자습서에서는 다음을 수행합니다.

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

필수 조건

범주 요구 사항
접근 수준 - 프로젝트 멤버.
- 적어도 기본 접근 권한.
사용 권한 기본적으로 프로젝트 멤버는 분석을 쿼리하고 뷰를 만들 수 있는 권한이 있습니다. 서비스 및 기능 사용 및 일반 데이터 추적 활동과 관련된 기타 필수 구성 요소에 대한 자세한 내용은 Analytics에 액세스하기 위한 사용 권한 및 필수 구성 요소를 참조 하세요.

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. 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에서 쿼리를 작성한 후에는 구문 강조 표시가 표시됩니다.

Visual Studio Code의 OData 파일을 보여 주는 스크린샷 코드 요소의 각 형식에는 고유한 색이 있습니다.

OData 쿼리 테스트

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

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

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

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

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

      읽을 수 있는 형식으로 표시된 OData 쿼리의 JSON 출력을 보여 주는 브라우저의 스크린샷

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

      JSON 출력을 읽을 수 있는 형식으로 보여 주는 브라우저의 스크린샷 출력의 메시지는 OData 쿼리의 오류를 나타냅니다.

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

Power BI에서 OData 쿼리 실행

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

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

Power BI에서 쿼리를 사용하려면 먼저 여러 줄 OData 쿼리를 한 줄 쿼리로 변환해야 합니다. 이 목적을 위해 OData: Combine 명령을 사용하려면 다음 단계를 수행합니다.

  1. 여러 줄 쿼리 텍스트가 포함된 OData 파일의 복사본을 만듭니다. 한 줄 쿼리를 읽을 수 있는 여러 줄 쿼리로 다시 변환할 방법이 없기 때문에 이 단계를 사용하는 것이 좋습니다.

  2. Visual Studio Code에서 OData 파일의 복사본을 열고 쿼리 텍스트의 아무 곳에나 커서를 놓습니다.

  3. 보기>명령 팔레트를 선택합니다. 검색 상자에 odata를 입력 합니다. 그런 다음, 결과 목록에서 OData: 결합을 선택합니다.

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

    Visual Studio Code의 OData 파일 스크린샷 파일에는 여러 줄 쿼리와 쿼리의 한 줄 버전이 포함됩니다.

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

Power BI에서 쿼리 실행

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

    데이터 가져오기 및 OData 피드가 강조 표시된 Power BI의 스크린샷

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

    OData 피드 대화 상자의 스크린샷. URL 상자에는 한 줄 OData 쿼리가 포함됩니다.

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

    데이터를 로드하고 변환하기 위한 단추가 있는 Power BI의 미리 보기 페이지 스크린샷 표에는 여러 작업 항목에 대한 정보가 나열됩니다.

쿼리 옵션 지정

  1. 미리 보기 페이지에서 데이터 변환 을 선택하여 파워 쿼리 편집기를 엽니다.

    파워 쿼리 편집기의 스크린샷. 표에는 여러 작업 항목에 대한 OData 피드 데이터가 나열되어 있습니다.

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

    Power BI 리본의 스크린샷. 고급 편집기가 강조 표시됩니다.

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

    고급 편집기 창의 스크린샷. 쿼리의 끝이 표시되고 구현 매개 변수가 강조 표시됩니다.

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

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

    고급 편집기 창의 스크린샷. 쿼리의 끝이 표시됩니다. 대체 문자열을 포함하고 강조 표시됩니다.

    이 변경은 속도 제한 오류를 방지하는 데 도움이 됩니다. 새 값은 다음과 같은 효과를 갖습니다.

    • OData 버전 4를 참조하도록 Power BI에 지시합니다.
    • Null인 값을 생략하도록 Analytics 서비스에 지시하여 쿼리 성능을 향상시킵니다.

    파워 쿼리는 발생하는 모든 null 값에 대해 다른 쿼리를 생성하여 null 값을 오류로 해결하려고 시도합니다. 이 작업을 수행하면 수천 개의 쿼리가 발생할 수 있습니다. 이러한 쿼리는 사용자 계정이 제한되는 사용량 임계값을 빠르게 초과할 수 있습니다.

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

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

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

닫기 및 적용을 선택하여 설정을 저장하고 데이터를 Power BI로 끌어오세요. 데이터가 새로 고쳐지면 Power BI에서 일반적으로 수행하는 것처럼 보고서를 만들 수 있습니다.

Power BI 리본의 스크린샷. 닫기 및 적용 단추가 강조 표시됩니다.