다음을 통해 공유


Power BI Data Connector를 사용하여 분석 연결

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

이 문서에서는 데이터 커넥터를 사용하여 Power BI와 Azure DevOps 간에 원활한 연결을 설정하는 방법을 알아봅니다. 이 통합을 통해 Azure DevOps 데이터에서 중요한 인사이트를 추출하고 Power BI 내에서 매력적인 보고서를 만들 수 있습니다. Power BI Data Connector는 분석 뷰를 사용합니다.

Important

분석 뷰는 Azure Boards 데이터(작업 항목)만 지원합니다. 분석 뷰는 파이프라인과 같은 다른 데이터 형식을 지원하지 않습니다. 보기는 작업 항목의 플랫 목록을 제공하며 작업 항목 계층 구조를 지원하지 않습니다. 이 시점에서 다른 유형의 데이터를 지원하도록 커넥터를 업데이트할 계획이 없습니다. 다른 방법에 대한 자세한 내용은 Power BI 통합 정보를 참조하세요.

필수 조건

Important

Azure DevOps는 대체 자격 증명 인증을 지원하지 않습니다. 대체 자격 증명을 계속 사용하는 경우 보다 안전한 인증 방법으로 전환하는 것이 좋습니다.

분석 보기에 연결

  1. Power BI Desktop을 실행합니다.

  2. 서비스에 로그인합니다. 처음 액세스하려면 로그인하고 자격 증명을 인증해야 합니다. Power BI Desktop은 자격 증명을 저장하므로 한 번만 저장하면 됩니다.

    참고 항목

    Azure DevOps는 OAuth를 사용하는 테넌트 간 시나리오를 지원하지 않습니다. 대신 서비스 주체 및 관리 ID를 사용합니다.

  3. 자격 증명 확인 시 연결을 선택합니다.

    Power BI 연결 대화 상자를 보여 주는 스크린샷.

  4. Data>Online Services 가져오기를 선택한 다음, 클라우드 서비스에 대해 Azure DevOps(보드만 해당)를 선택하거나 온-프레미스에 대해 Azure DevOps Server(보드만 해당)를 선택합니다. 연결을 선택합니다. 분석 뷰는 작업 항목 및 테스트 사례에 대한 쿼리만 지원합니다.

    데이터 가져오기 흐름을 보여 주는 스크린샷

  5. 데이터에 연결할 기본 매개 변수를 지정합니다.

    조직 및 프로젝트 이름 지정을 보여 주는 스크린샷

    조직 및 프로젝트 이름, 온-프레미스 버전을 지정하는 것을 보여 주는 스크린샷.

    • 컬렉션 URL: Azure DevOps Server 인스턴스가 호스트되는 URL을 입력합니다. URL의 예는 .입니다 http://fabrikam-server/AzureDevOpsServer/fabrikam-collection.
    • 팀 프로젝트: 프로젝트 이름만 입력합니다. 예를 들어 Azure DevOps Server 인스턴스http://fabrikam-server/AzureDevOpsServer/fabrikam-collection/Fabrikam-Fiber의 URL이면 Fabrikam-Fiber를 사용합니다.

    Important

    팀 이름을 프로젝트 이름과 혼동하지 마세요. 이는 일반적인 실수입니다. 예를 들어 사용하는 URL이 http://fabrikam-server/AzureDevOpsServer/fabrikam-collection/Fabrikam-Fiber-Git/DeviceFabrikam-Fiber-Git인 경우 프로젝트 이름이고 디바이스는 팀 이름입니다.

    로그인에 성공한 후 Power BI는 사용자 자격 증명에 지정된 프로젝트에 액세스할 수 있는 권한이 있음을 확인합니다. 오류가 발생하는 경우 가장 일반적인 문제에 대한 솔루션에 대한 FAQ를 참조하세요.

분석 보기 선택

  1. 공유 뷰 폴더를 확장하고 분석 보기를 선택한 다음 로드를 선택합니다. 데이터 커넥터는 사용 가능한 분석 보기 목록을 제공합니다. 각 보기는 Power BI로 끌어올 수 있는 데이터 집합을 나타냅니다. 사용자 지정 분석 뷰를 만들 수도 있습니다.

    다음 이미지는 기본 분석 뷰를 보여 줍니다. 보기 목록은 프로젝트를 만드는 데 사용되는 프로세스 모델에 따라 다를 수 있습니다. "오늘"이 추가된 보기를 제외하고 나열된 모든 보기는 기록 추세 데이터를 제공합니다.

    다음 예제에서는 제품 백로그 항목을 필터링하는 스토리 - 지난 30일을 선택합니다.

    분석 선택 보기가 있는 탐색기 대화 상자를 보여 주는 스크린샷

    참고 항목

    이전 섹션에서 보기를 확인했기 때문에 뷰가 로드되어야 합니다. 뷰가 로드되지 않는 경우 데이터 세트가 너무 커서 가장 가능성이 높습니다. 웹 포털의 분석 보기 아래 보기 로 돌아가서 필터를 조정하여 데이터 세트의 크기를 줄입니다.

  2. 보기를 선택합니다.

    기본 보기가 있는 탐색기 대화 상자를 보여 주는 스크린샷

    참고 항목

    탐색기에서 선택한 보기에 대해 표시된 미리 보기는 선택한 필드 수와 데이터 세트의 크기에 따라 잘립니다. 데이터는 미리 보기에 대해서만 잘리며 전체 데이터 새로 고침에는 영향을 주지 않습니다.

    • 작업 항목 - 오늘 테이블을 선택하고 미리 보기가 로드되기를 기다립니다. 프로젝트의 모든 작업 항목의 현재 상태를 나타냅니다.
    • 작업 항목 - 오늘 테이블 옆에 있는 확인란을 선택하고 로드를 선택합니다.

    참고 항목

    분석 뷰 는 서버에서 Power BI를 사용하여 정의된 필터를 적용하지 않습니다. Power BI에 적용된 모든 필터는 최종 사용자에게 표시되는 데이터를 제한하지만 분석에서 검색되는 데이터의 양을 줄이지는 않습니다. 필터가 데이터 세트의 크기를 줄이려는 경우 보기를 사용자 지정하여 적용합니다.

  3. 데이터가 로드되기를 기다립니다. 테이블 이름 아래에 직접 표시되는 상태 메시지를 확인하여 진행률을 확인할 수 있습니다. 오류가 표시되는 경우 가장 일반적인 문제에 대한 해결 방법은 FAQ 섹션을 참조하세요.

    쿼리 변경 내용 로드 적용 대화 상자를 보여 주는 스크린샷.

  4. 데이터 모델을 검토합니다. 모델이 로드되는 동안 Power BI Data Connector데이터 세트 디자인을 검토합니다.

보고서 만들기

로드된 데이터를 기반으로 보고서를 만듭니다. 로드 작업이 완료되면 사용자 지정 보고서를 만들어 데이터를 탐색할 수 있습니다. 일반적인 보고서의 예는 데이터 커넥터 - 예제 보고서를 참조 하세요.

Power BI Desktop 보고서 보기를 보여 주는 스크린샷

FAQ

Power BI Data Connector 및 Analytics 오류 메시지에 대한 일반적인 질문에 대한 답변을 찾습니다.

Q: 커넥터에서 오는 오류 메시지를 어떻게 읽어야 하나요?

A: 일반적으로 추가 컨텍스트 정보를 포함하기 때문에 커넥터에서 오는 오류 메시지를 읽는 데 어려움을 느낄 수 있습니다. 로드 작업이 실패하면 메시지가 "서버에 대한 수정 사항을 저장하지 못했습니다..."로 시작합니다. 이 메시지가 표시되면 [DataSource.Error] Azure DevOps...:를 검색합니다. 다음 예제에서는 커넥터에서 반환된 오류 메시지를 보여줍니다. 오류 메시지의 가장 중요한 부분은 "쿼리 결과가 최대 크기를 초과합니다. 추가 필터를 적용하여 레코드 수를 줄입니다."

쿼리 결과가 최대 크기 오류 메시지를 초과하는 것을 보여 주는 스크린샷

Q: 어떻게 할까요? "쿼리 결과가 최대 크기를 초과합니다. 추가 필터를 적용하여 레코드 수를 줄이시겠습니까?

A: 분석에서 검색된 레코드 수가 250,000을 초과하면 다음 오류가 발생합니다.

"서버에 대한 수정 사항을 저장하지 못했습니다. 오류 반환: 'OLE DB 또는 ODBC 오류: [DataSource.Error] VSTS: 요청 실패: 원격 서버에서 오류:(400) 잘못된 요청을 반환했습니다. (쿼리 결과가 최대 크기를 초과합니다. 추가 필터를 적용하여 레코드 수를 줄입니다.'"

이 오류는 일반적으로 프로젝트에 많은 수의 작업 항목이 있는 경우에 발생합니다. 보기를 사용자 지정하여 데이터 세트의 크기를 줄입니다. Power BI에서 사용하기 전에 이 단계를 수행합니다.

쿼리 결과가 최대 크기 오류를 초과했음을 보여 주는 스크린샷

Q: "사용자에게 권한이 부여되지 않음" 오류를 해결할 어떻게 할까요? 있나요?

A: 권한이 없는 프로젝트에 액세스하려고 하면 이 오류가 발생할 수 있습니다. Power BI에서 자격 증명을 인식하지 못하는 경우에도 이를 확인할 수 있습니다. 사용 권한을 확인하려면 분석 및 분석 뷰에 액세스할 수 있는 권한 설정을 참조 하세요. 자격 증명 문제인 경우 관리자에게 문의하여 문제를 해결하는 데 도움이 될 수 있는지 확인합니다. 자세한 내용은 Power BI 보안, 사용자 인증Power BI의 로그인 문제 해결을 참조하세요.

액세스 거부 오류를 보여 주는 스크린샷.

참고 항목

Power BI는 Microsoft Entra ID를 사용하여 Power BI 서비스 로그인하는 사용자를 인증하고, 사용자가 인증이 필요한 리소스에 액세스하려고 할 때마다 Power BI 로그인 자격 증명을 사용합니다. 사용자는 Power BI 계정을 설정하는 데 사용되는 이메일 주소를 사용하여 Power BI 서비스 로그인합니다. Power BI는 사용자가 데이터에 연결하려고 할 때마다 리소스에 전달되는 유효 사용자 이름으로 해당 로그인 이메일을 사용합니다. 그러면 유효한 사용자 이름이 사용자 계정 이름매핑되고 인증이 적용되는 관련 Windows 도메인 계정으로 확인됩니다.

Q: "리소스에 대한 액세스가 금지됨" 오류를 해결할 어떻게 할까요? 있나요?

A: 특정 프로젝트에 액세스할 수 있지만 분석 보기 권한이 없는 경우 이 오류가 발생할 수 있습니다. 프로젝트 관리자와 협력하여 이러한 권한을 얻습니다. 보안 모델에 대한 자세한 내용은 Analytics 보안을 참조하세요.

리소스에 대한 액세스가 금지되었다는 오류 메시지를 보여 주는 스크린샷.

Q: "프로젝트 'X'가 없거나 액세스할 수 있는 권한이 없습니다." 오류를 해결할 어떻게 할까요? 있나요?

A: 이 오류는 프로젝트 이름입력한 값이 프로젝트에 해당하지 않음을 나타냅니다. 사용자가 만드는 일반적인 실수는 프로젝트 이름을 팀 이름과 혼동하는 것입니다.

예를 들어 사용하는 URL이 https://dev.azure.com/fabrikam-fiber-inc/Fabrikam-Fiber-Git/DeviceFabrikam-Fiber-Git인 경우 프로젝트 이름이고 매개 변수에 사용해야 합니다. 디바이스 는 팀 이름입니다.

프로젝트를 찾을 수 없음 오류를 보여 주는 스크린샷.