OData 쿼리를 사용하는 샘플 보고서 개요

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

이 문서에서는 가장 인기 있는 보고서에 대한 샘플을 제공합니다.

모든 샘플 보고서 문서에서는 다음 섹션과 정보를 제공합니다.

  • 샘플 쿼리 - Power BI로 데이터를 끌어오는 데 사용되는 Power BI 쿼리 및 원시 OData 쿼리
  • Power BI 변환 - 데이터를 보고 가능한 형식으로 변환하는 단계
  • 보고서 만들기 - 데이터에서 간단한 보고서를 만드는 단계
  • 추가 쿼리 - 유사하지만 다른 보고서에 대한 다른 샘플 쿼리입니다.

사전 요구 사항

  • 기본 액세스 이상의 프로젝트 멤버여야 합니다. 프로젝트 멤버로 추가되지 않은 경우 지금 추가합니다. 관련자를 제외한 프로젝트에 액세스할 수 있는 모든 사용자는 분석 보기를 볼 수 있습니다.
  • 분석 데이터를 사용할 수 있도록 하려면 해당 서비스를 사용하도록 설정해야 합니다. 예를 들어 작업 추적 데이터를 쿼리하려면 보드 를 사용하도록 설정해야 합니다. 사용하지 않도록 설정하면 분석 보기 가 표시되지 않습니다. 서비스를 다시 사용하도록 설정하려면 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 서비스에 액세스할 수 있는 권한 부여를 참조하세요.

Power BI 쿼리

Power BI 쿼리에 OData 쿼리를 포함하는 다음 단계를 빠르게 시작합니다. 쿼리는 다음과 같이 Power BI의 고급 쿼리 편집기에 직접 붙여넣을 수 있습니다.

  1. 데이터 가져오기를 선택한 다음 빈 쿼리를 선택합니다.

    Power BI - 빈 쿼리

  2. Power BI 쿼리 편집기에서 고급 편집기 선택합니다.

    Power BI - 고급 편집기 선택

  3. 고급 편집기 창이 열립니다.

    Power BI - 고급 편집기

  4. 내용을 이 문서의 맨 위에 나열된 연결된 문서에 제공된 샘플 쿼리 중 하나로 바꿉니다.

    Power BI - 고급 편집기 - 붙여넣은 쿼리

  5. 샘플 쿼리에는 {organization} 및 {project}와 같은 값으로 대체해야 하는 문자열이 있습니다.

    • {organization} - 조직 이름
    • {project} - 팀 프로젝트 이름입니다. 또는 프로젝트 간 쿼리의 경우 "/{project}"를 완전히 생략합니다.

    샘플 쿼리에 따라 다음과 같이 바꿀 다른 문자열이 하나 이상 있을 수 있습니다.

    • {areapath} - 영역 경로입니다. 형식: Project\Level1\Level2
    • {iterationpath} - 반복 경로입니다. 형식: Project\Level1\Level2
    • {startdate} - 추세 보고서를 시작할 날짜입니다. 형식: YYYY-MM-DDZ. 예: 2019-04-01Z 2019-4월-01을 나타냅니다. 따옴표로 묶지 마세요.

    Power BI - 고급 편집기 - 쿼리의 문자열 바꾸기

  6. 쿼리를 실행하려면 완료를 선택합니다.

    계정에 연결한 적이 없는 경우 Power BI에서 인증을 요구할 수 있습니다. 자세한 내용은 클라이언트 인증 옵션을 참조하세요.

원시 OData 쿼리

OData 쿼리는 Power BI에서 사용하기 전에 OData 쿼리를 별도로 수정하고 테스트하려는 경우에 제공됩니다. 이 메서드는 더 많은 유연성을 제공하지만 Power BI 및 OData 쿼리를 사용하여 Connect에 설명된 대로 Power BI에서 OData 쿼리를 사용하기 전에 다른 단계를 포함합니다.

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