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

아티클
09/27/2022
읽는 데 15분 걸림

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

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

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

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

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

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

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

사전 요구 사항

기본 액세스 이상의 프로젝트 멤버여야 합니다. 프로젝트 멤버로 추가되지 않은 경우 지금 추가합니다. 관련자를 제외한 프로젝트에 액세스할 수 있는 모든 사용자는 분석 보기를 볼 수 있습니다.
분석 데이터를 사용할 수 있도록 하려면 해당 서비스를 사용하도록 설정해야 합니다. 예를 들어 작업 추적 데이터를 쿼리하려면 보드 를 사용하도록 설정해야 합니다. 사용하지 않도록 설정하면 분석 보기 가 표시되지 않습니다. 서비스를 다시 사용하도록 설정하려면 Azure DevOps 서비스 설정 또는 해제를 참조하세요.
분석 보기를 사용하려면 개별 사용자 또는 조직에 대해 분석 뷰 미리 보기 기능을 사용하도록 설정합니다.
또한 *View Analytics 사용 권한을 허용으로 설정해야 합니다. 자세한 내용은 Analytics 서비스에 액세스할 수 있는 권한 부여를 참조하세요.
Azure DevOps용 Power BI를 사용하거나 Analytics에 대한 OData 쿼리를 실행하려면 View Analytics 권한이 허용으로 설정되어 있어야 합니다. 기본적으로 기본 액세스 권한이 있는 모든 참가자에게 액세스 권한이 부여됩니다. 공유 분석 보기를 편집하려면 *공유 분석 보기 편집 권한이 허용으로 설정되어 있어야 합니다. 자세한 내용은 Analytics 서비스에 액세스할 수 있는 권한 부여를 참조하세요.

기본 액세스 이상의 프로젝트 멤버여야 합니다. 프로젝트 멤버로 추가되지 않은 경우 지금 추가합니다. 관련자를 제외한 프로젝트에 액세스할 수 있는 모든 사용자는 분석 보기를 볼 수 있습니다.
Analytics가 설치되어 있는지 확인한 다음, 그렇지 않은 경우 사용하도록 설정합니다. 확장을 추가하거나 서비스를 사용하도록 설정하려면 계정 소유자 또는 프로젝트 컬렉션 관리자 그룹의 구성원이어야 합니다.
분석 데이터를 사용할 수 있도록 하려면 해당 서비스를 사용하도록 설정해야 합니다. 예를 들어 작업 추적 데이터를 쿼리하려면 보드 를 사용하도록 설정해야 합니다. 사용하지 않도록 설정하면 분석 보기 가 표시되지 않습니다. 서비스를 다시 사용하도록 설정하려면 Azure DevOps 서비스 설정 또는 해제를 참조하세요.
분석 보기를 사용하려면 개별 사용자 또는 조직에 대해 분석 뷰 미리 보기 기능을 사용하도록 설정합니다.
또한 *View Analytics 사용 권한을 허용으로 설정해야 합니다. 자세한 내용은 Analytics 서비스에 액세스할 수 있는 권한 부여를 참조하세요.
Azure DevOps용 Power BI를 사용하거나 Analytics에 대한 OData 쿼리를 실행하려면 View Analytics 권한이 허용으로 설정되어 있어야 합니다. 기본적으로 기본 액세스 권한이 있는 모든 참가자에게 액세스 권한이 부여됩니다. 공유 분석 뷰를 편집하려면 공유 분석 보기 편집 권한이 허용으로 설정되어 있어야 합니다. 자세한 내용은 Analytics 서비스에 액세스할 수 있는 권한 부여를 참조하세요.

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

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

Visual Studio Code 설치

Visual Studio Code 다운로드하고 설치하려면 Visual Studio Code 다운로드 페이지로 이동합니다.

OData 확장 설치

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

.odata 파일 만들기

Visual Studio Code 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} 합니다.

Analytics에 대해 OData 쿼리를 작성하는 방법에 대한 자세한 내용은 OData 쿼리 빠른 참조를 참조하세요.

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

Visual Studio Code OData 확장 - 구문 강조 표시

OData 쿼리 테스트

OData 쿼리를 테스트하려면 쿼리 텍스트의 아무 곳에나 커서를 놓고명령 팔레트보기를> 선택합니다. 검색 상자에 odata 를 입력하여 모든 OData 명령을 표시합니다.

Visual Studio Code OData 확장 - 명령 팔레트

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

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

Visual Studio Code OData 확장 - JSON 출력

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

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

Power BI에서 OData 쿼리 실행

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

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

참고

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

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

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

Visual Studio Code OData 확장 - 한 줄 쿼리에 결합

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

Power BI에서 쿼리 실행

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

Power BI -

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

Power BI - OData 피드 - 쿼리에 붙여넣기

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

Power BI - OData 피드 - Power BI 데이터 미리 보기

쿼리 옵션 지정

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

Power BI - OData 피드 - Power Query 편집기

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

Power BI - OData 피드 - 고급 편집기 선택

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

Power BI - OData 피드 - 고급 편집기 - 오른쪽으로 스크롤

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

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

문자열을 바꿉다.

참고

다음 작업은 이 예방 조치를 수행하는 데 도움이 됩니다.

제한 오류를 방지합니다. Power Query 발생하는 모든 null 값에 대한 추가 쿼리를 생성하여 null 값을 오류로 해결하려고 시도합니다. 이로 인해 수천 개의 쿼리가 발생할 수 있으며, 이는 사용자 계정이 제한되는 것 이상으로 사용량 임계값을 빠르게 초과합니다.

이 문제를 방지하려면 다음을 수행합니다.

OData v4를 참조하도록 Power BI에 지시합니다.
쿼리 성능을 향상시키는 null 값을 생략하도록 Analytics 서비스에 지시합니다.

참고

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

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

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

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

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