Azure DevOps에 대 한 데이터 웨어하우스 및 analysis services 큐브 수동 처리

Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 - TFS 2013
Azure DevOps Server의 이전 이름은 Visual Studio Team Foundation Server였습니다.

TFS (Team Foundation Server) 관계형 데이터베이스 (Tfs_Warehouse) 또는 SQL Server Analysis Services 큐브 (Tfs_Analysis)를 수동으로 처리할 수 있습니다.

  • 보고서에 최신 데이터가 필요 합니다.
  • 오류가 발생 한 경우
  • 스키마 충돌을 해결 한 후

일반적인 작업 중에 웨어하우스는 작업 저장소가 변경된 후 2분 안에 처리되고 큐브는 2시간마다 처리됩니다. 웨어하우스를 수동으로 처리 하 여 쿼리와 보고서가 웨어하우스에 종속 된 데이터로 최신 상태를 유지할 수 있습니다.

Warehouse Control 웹 서비스를 사용 하 여 웨어하우스 또는 큐브를 처리 하거나 다른 유지 관리 작업을 수행 합니다. 두 데이터베이스를 전체 다시 빌드 하려는 경우 관리 콘솔 또는 TFSConfig RebuildWarehouse 명령을사용 합니다.

Warehouse Control Web Services page

참고

큐브를 수동으로 처리 하려면 SQL Server Management Studio (SSMS)를 사용 하지 마십시오. 이 도구를 사용한 큐브 처리는 지원되지 않습니다.

웨어하우스 또는 큐브 처리

웨어하우스 또는 큐브 처리는 얼마나 많은 데이터가 관련되어 있는지에 따라 수 분에서 수 시간까지 걸릴 수 있습니다. 어느 한 데이터베이스를 처리하기 전에 실행하려는 동기화 작업에 대한 처리 상태를 확인합니다. 상태에서 유휴 상태를 반환 하는지 확인 합니다.

웹 서비스에 액세스하려면

  1. TFS의 응용 프로그램 계층 서버에서 Administrators 보안 그룹의 멤버가 아닌 경우 지금 추가 하세요.

    또한 서버 수준 관리 웨어하우스 권한이 허용으로 설정 되어 있어야 합니다.

  2. 응용 프로그램 계층 서버에 로그인 하 고 지원 되는 웹 브라우저에서 다음 URL을 입력 하 여 Warehouse Control 웹 서비스를 엽니다.

    http://localhost:8080/DefaultCollection/TeamFoundation/Administration/v3.0/WarehouseControlService.asmx

     http://localhost:8080/VirtualDirectory/DefaultCollection/TeamFoundation/Administration/v3.0/WarehouseControlService.asmx   
    

    VirtualDirectory에는 TFS를 설치할 때 지정한 IIS 가상 디렉터리를 입력합니다. 기본적으로 가상 디렉터리는 tfs입니다.

    프로젝트가 다른 프로젝트 컬렉션에 있는 경우 Defaultcollection대신 컬렉션의 이름을 지정 합니다.

  3. WarehouseControlWebService 페이지가 열립니다.

    페이지가 열리지 않으면 TFS 응용 프로그램 풀이 실행 중인지 확인 합니다.

프로세스 상태를 확인하려면

GetProcessingStatus를 선택 합니다.

Get processing status

새 브라우저 창이 열립니다. 다음 작업의 처리 상태를 나타냅니다.

  • Common Structures Warehouse Sync
  • Full Analysis Database Sync
  • Incremental Analysis Database Sync

각 팀 프로젝트 컬렉션에 대 한 다음 작업의 상태가 제공 됩니다.

  • Build Warehouse Sync
  • Common Structures Warehouse Sync
  • Test Management Warehouse Sync
  • Version Control Warehouse Sync
  • Work Item Tracking Warehouse Sync

Idle 값은 동기화 작업이 현재 실행 되 고 있지 않음을 나타냅니다. 이러한 작업의 처리 상태가 Idle인 경우에만 데이터 웨어하우스 또는 큐브를 처리 해야 합니다. 다른 값이 반환 되는 경우 처리 하려는 작업에 대해 Idle 이 반환 될 때까지이 단계를 반복 합니다.

데이터 웨어하우스를 처리하려면

  1. Processwarehouse를 선택 하 고, 처리할 팀 프로젝트 컬렉션을 선택적으로 지정 합니다. CollectionName 을 비워 두면 모든 컬렉션이 처리 됩니다.

    웨어하우스 처리가 성공적으로 시작 되 면 서비스는 True 를 반환 하 고, 실패 하면 False 를 반환 합니다. False 값은 웨어하우스가 현재 처리 되 고 있음을 나타냅니다.

  2. 웨어하우스의 처리 상태를 확인 하려면의 앞부분에서 설명한 대로 GetProcessingStatus 를 선택 하 여 프로세스 상태를 확인합니다.

    GetProcessingStatus 서비스가 유휴값을 반환 하 고, 공용 구조 웨어하우스 동기화 및 각 팀 프로젝트 컬렉션의 각 웨어하우스에 대해 성공 값이 반환 되 면 웨어하우스 처리가 완료 됩니다.

Analysis Services 큐브를 처리하려면

  1. ProcessAnalysisDatabase를 선택 합니다.

  2. ProcessingType에 대해 증분 또는 전체를 입력 합니다.

    증분을 지정 하면 가장 최근 처리 이후에 데이터가 추가 된 경우에만 데이터가 처리 됩니다.

    Full을 지정 하면 웨어하우스가 다시 작성 되는 것 처럼 모든 데이터가 처리 됩니다. 전체 프로세스를 수행 하는 데 더 많은 시간이 걸립니다. 필요한 경우에만이 작업을 수행 합니다. 예를 들어 팀 프로젝트 또는 프로젝트 컬렉션이 제거 되거나 삭제 된 경우 전체 프로세스를 수행 합니다.

    큐브 처리가 성공적으로 시작 되 면 서비스는 True 를 반환 하 고, 실패 하면 False 를 반환 합니다. False 값은 큐브가 현재 처리 되 고 있음을 나타냅니다.

  3. 웨어하우스의 처리 상태를 확인 하려면의 앞부분에서 설명한 대로 GetProcessingStatus 를 선택 하 여 프로세스 상태를 확인합니다.

    GetProcessingStatus 서비스가 유휴값을 반환 하 고 다음 작업에 대해 Succeeded 값을 반환 하면 큐브 처리가 완료 됩니다.

    • Full Analysis Database Sync
    • Incremental Analysis Database Sync

확장된 용량에 대한 차원 처리

다음 오류 메시지 중 하나가 나타날 때 ProcessDimensionsForExpandedCapacity 웹 서비스를 실행 해야 합니다.

Microsoft.TeamFoundation.Warehouse.WarehouseException: TF221122: An error occurred running job Full Analysis Database Sync for team project collection or Team Foundation server TEAM FOUNDATION.

Microsoft.TeamFoundation.Warehouse.WarehouseException: Failed to Process Analysis Database 'Tfs_Analysis'.

You should run the ProcessDimensionsForExpandedCapacity web service when you receive the following error message:
Microsoft.TeamFoundation.Warehouse.WarehouseException: TF221122: An error occurred running job Full Analysis Database Sync for team project collection or Team Foundation server TEAM FOUNDATION.
Microsoft.TeamFoundation.Warehouse.WarehouseException: Failed to Process Analysis Database 'Tfs_Analysis'.
Microsoft.TeamFoundation.Warehouse.WarehouseException: File system error: A string store or binary store with a compatibility level of '1050' is at the maximum file size of 4 gigabytes. To store additional strings, you can change the StringStoresCompatibilityLevel property of the associated dimension or distinct count measure to '1100' and reprocess. This option is only available on databases with a compatibility level of '1100' or higher.
Physical file: \?\I:\OLAP\Data\Tfs_Analysis.0.db\vDimWorkItemOverlay.5.dim\7.WorkItemSK.asstore.

이 서비스는 작업 항목 차원에 대해 StringStoresCompatibilityLevel를 1100로 변경 하 고 전체 큐브 다시 처리를 수행 합니다.

  1. Warehouse Control 웹 서비스에서 ProcessDimensionsForExpandedCapacity를 선택 합니다.

  2. 차원의 이름을 입력합니다. 위의 오류 메시지에서 차원 이름은 vDimWorkItemOverlay 입니다.

  3. 값을 1100로 성공적으로 다시 설정 하면 서비스는 True 를 반환 합니다.

    큐브 처리에 성공할 때까지 기다리십시오.

다음 이유 중 하나로 데이터베이스를 수동으로 처리 해야 합니다.

  • 보고서가 최신 데이터를 표시 하지 않고 예정 된 모임에 대해 최신 데이터를 제공 해야 하는 경우 큐브를 증분 처리 합니다.
  • 데이터 웨어하우스 내에서 각 팀 프로젝트 컬렉션을 처리 하 여 모든 스키마 충돌해결을 확인 합니다.
  • 데이터 웨어하우스 내부의 각 팀 프로젝트 컬렉션을 처리하여 웨어하우스 작업과 관련된 이벤트 뷰어에 나타나는 문제를 진단하기 위한 정보를 수집합니다.

TFS 데이터 계층 서버를 이동, 복원, 이름 바꾸기 또는 장애 조치 (failover) 할 때 웨어하우스와 큐브를 전체 다시 빌드합니다 .

필요에 따라 새로 고침 처리 간격이 나 기타 처리 매개 변수를 변경합니다.