データ ウェアハウスと Analysis Services キューブを手動で処理し、Azure DevOps

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 Web サービスを使用して、ウェアハウスまたはキューブを処理したり、その他のメンテナンス操作を実行したりします。 両方のデータベースを完全に再構築する必要がある場合は、管理コンソールまたはTFSConfig RebuildWarehouse コマンド を使用します

[ウェアハウス コントロール Web サービス] ページ

注意

キューブを手動SQL Server Management Studio (SSMS) を使用しない。 そのツールを使用するキューブの処理はサポートされていません。

ウェアハウスまたはキューブを処理する

ウェアハウスまたはキューブの処理は、含まれるデータの量によって数分から数時間かかります。 データベースを処理する前に、同期ジョブまたは実行するジョブの処理状態を判定します。 状態がアイドル状態を 返す

Web サービスにアクセスするには

  1. TFS 用のアプリケーション層サーバーの Administrators セキュリティ グループのメンバーでない場合は、ここで を追加します

    また、サーバー レベルの [ウェアハウスの管理] アクセス許可を [許可 ] に設定する必要 があります

  2. アプリケーション層サーバーにサインインし、サポートされている Web ブラウザーに次の URL を入力して Warehouse Control Web サービスを開きます。

    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] を選択します

処理状態の取得

新しいブラウザー ウィンドウが開きます。 次のジョブの処理状態を示します。

  • 共通構造ウェアハウスの同期
  • 完全分析データベースの同期
  • インクリメンタル分析データベースの同期

また、各チーム プロジェクト コレクションの次のジョブの状態が提供されます。

  • ビルド ウェアハウスの同期
  • 共通構造ウェアハウスの同期
  • テスト管理ウェアハウスの同期
  • バージョン管理ウェアハウスの同期
  • 作業項目トラッキング ウェアハウスの同期

値 Idle は、 同期ジョブが現在実行されていない状態を示します。 これらのジョブの処理状態がアイドル状態の場合にのみ、データ ウェアハウスまたはキューブを処理する 必要があります。 別の値が返された場合は、処理するジョブに対して Idle が返されるまで、この手順を繰り返します。

データ ウェアハウスを処理するには

  1. [ProcessWarehouse] を 選択し、必要に応じて、処理するチーム プロジェクト コレクションを指定します。 collectionName を空白のままに すると、すべてのコレクションが処理されます。

    サービスは、ウェアハウス の処理 が正常に開始されると True を返し、成功しなかった場合は False を返します。 値 False は、ウェアハウスが現在処理中であること示します。

  2. ウェアハウスの処理状態を確認するには、前の説明に従って GetProcessingStatus を選択して、プロセス の状態を確認します

    GetProcessingStatus サービスが値 Idle を返し 、Common Structures Warehouse Sync の値 Succeeded を返し、各チーム プロジェクト コレクションのウェアハウスごとに値 Succeeded を返した場合、ウェアハウスの処理が完了します。

Analysis Services キューブを処理するには

  1. [ProcessAnalysisDatabase] を選択します

  2. processingType の場合は、「Incremental」 または 「Full」入力します

    [増分] を指定 した場合、データは、最新の処理以降に追加された場合にのみ処理されます。

    [完全] を指定 した場合、すべてのデータは、ウェアハウスが再構築されている場合と同様に処理されます。 完全なプロセスの実行には時間がかかります。必要なときにのみ行います。 たとえば、チーム プロジェクトまたはプロジェクト コレクションが削除または削除された場合は、完全なプロセスを実行します。

    サービスは、キューブ の処理 が正常に開始されると True を返し、成功しなかった場合は False を返します。 値 False は、キューブが現在処理中であること示します。

  3. ウェアハウスの処理状態を確認するには、前の説明に従って GetProcessingStatus を選択して、プロセス の状態を確認します

    GetProcessingStatus サービスから Idle の値が返され、次のジョブの値 Succeeded が返された場合、キューブの処理が完了します。

    • 完全分析データベースの同期
    • インクリメンタル分析データベースの同期

拡張された容量に対するディメンションの処理

次のいずれかのエラー メッセージが表示された場合は 、ProcessDimensionsForExpandedCapacity Web サービスを実行する必要があります。

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 Web サービスから 、ProcessDimensionsForExpandedCapacity を選択します

  2. ディメンションの名前を入力します。 上記のエラー メッセージから、ディメンション名は です vDimWorkItemOverlay

  3. 値が 1100 に正常にリセットされると、サービスは True を返します。

    キューブの処理が正常に完了するまで待ちます。

次のいずれかの理由で、データベースを手動で処理する必要があります。

  • レポートに最新のデータが表示され、今後の会議に最新のデータが必要な場合は、キューブを段階的に処理します。
  • データ ウェアハウス内の各チーム プロジェクト コレクションを処理して、すべてのスキーマ競合の解決 を確認します
  • ウェアハウス ジョブに関連するイベント ビューアーに表示される問題を診断するための情報を収集するために、データ ウェアハウス内の各チーム プロジェクト コレクションを処理します。

TFS データ層サーバーを 移動、復元、名前変更、またはフェールオーバーするときに、ウェアハウスとキューブの完全な再構築を行います。

必要に応じて、 更新処理間隔または他の処理パラメーター を変更します