Processar manualmente o cubo do Analysis Services e o data warehouse de TFS

Quando precisar dos dados mais atualizados em seus relatórios, quando ocorrerem erros ou depois de resolver conflitos de esquema, você pode processar manualmente a base de dados relacional (depósito TFS) do Team Foundation Server (TFS) ou o cubo do SQL Server Analysis Services (Tfs_Analysis).

Durante operações típicas, o depósito é processado em até dois minutos depois das alterações feitas em um armazenamento operacional, e o cubo é processado a cada duas horas. Ao processar o depósito manualmente, você ajuda a garantir que as consultas e os relatórios sejam atualizados com os dados que dependem do depósito.

Você usa o serviço Web de controle de depósito para processar o depósito ou o cubo ou ainda executar outras operações de manutenção. Se você quiser executar uma recompilação completa das bases de dados, use o Console de administração ou o Comando de TFSConfig RebuildWarehouse.

Dica

Não use o SQL Server Management Studio (SSMS) para processar o cubo manualmente.O processamento do cubo com essa ferramenta não é compatível.

Processar o depósito ou o cubo

Processar o depósito ou o cubo depende da quantidade de dados envolvida, o que pode demorar minutos ou horas. Antes de processar a base de dados, determine o status de processamento para os trabalhos de sincronização ou os trabalhos que você deseja executar. Verifique se o status retorna Ocioso

Para acessar os serviços Web

1. Se você não for membro do grupo de segurança de Administradores no servidor de camada de aplicativo para TFS, peça para ser adicionado agora.

   Além disso, verifique se a permissão Administer warehouse no nível de servidor deve ser definida como Allow.

2. Faça logon no servidor de camada de aplicativo e abra o serviço Web de controle de depósito ao digitar a seguinte URL em um navegador da Web compatível:

   https://localhost:8080/tfs/TeamFoundation/Administration/v3.0/WarehouseControlService.asmx

   Se outro nome foi usado diferente de tfs para o diretório virtual, digite o IIS Virtual Directory especificado quando o Team Foundation Server foi instalado.

3. A página Serviço Web de Controle de Depósito abre.

   Dica

   Se a página não abrir, verifique se o Pool de Aplicativos do Microsoft Team Foundation Server está em execução.

Para verificar o status do processo

• Escolha GetProcessingStatus.

  

  Uma nova janela do navegador abre. Isso indica o seguinte status do processamento de trabalho:

  • Sincronização do depósito de estruturas comuns

  • Sincronização completa do banco de dados de análise

  • Sincronização do banco de dados de análise incremental

  E, o status dos seguintes trabalhos para cada coleção de projetos de equipe é fornecido:

  • Sincronização do depósito de compilação

  • Sincronização do depósito de estruturas comuns

  • Sincronização do depósito de gerenciamento de teste

  • Sincronização do depósito de controle de versão

  • Sincronização do depósito de acompanhamento do item de trabalho

  Um valor Ocioso indica que o trabalho de sincronização não está sendo executado atualmente. Você deve processar o depósito de dados ou o cubo somente quando o status de processamento para esse trabalho for Ocioso. Se um valor diferente for retornado, repita essa etapa até que a mensagem Ocioso seja retornada para o trabalho que você deseja processar.

Para processar o depósito de dados

1. Escolha ProcessWarehouse e especifique opcionalmente a coleção do projeto de equipe para o processamento. Se você deixar collectionName em branco, todas as coleções serão processadas.

   O serviço retorna Verdadeiro quando inicia o processamento do depósito com êxito e Falso caso contrário. Um valor Falso indica que o depósito está sendo processado no momento.

2. Para determinar o status de processamento do depósito, escolha GetProcessingStatus conforme descrito anteriormente em para verificar o status do processo.

   O processamento do depósito é concluído quando o serviço GetProcessingStatus retorna um valor Ocioso e um valor de Êxito para a Sincronização do depósito de estruturas comuns, e para cada depósito de cada coleção de projetos de equipe.

Processar o cubo do Analysis Services

1. Escolha ProcessAnalysisDatabase.

2. Para processingType, digite Incremental ou Completo.

   Se você especificar Incremental, os dados serão processados somente se tiverem sido adicionados no processamento mais recente.

   Se você especificar Completo, todos os dados serão processados como se o depósito estivesse sendo reconstruído. Os processos Completos levam mais tempo para serem executados e devem ser executados somente se necessário (por exemplo, quando um projeto de equipe ou uma coleção de projetos tiver sido removida ou excluída).

   O serviço retorna Verdadeiro quando inicia o processamento do cubo com êxito e Falso caso contrário. Um valor Falso indica que o cubo está sendo processado no momento.

3. Para determinar o status de processamento do depósito, escolha GetProcessingStatus conforme descrito anteriormente em para verificar o status do processo.

   O processamento do cubo é concluído quando o serviço GetProcessingStatus retorna um valor Ocioso e um valor de Êxito para todos os trabalhos a seguir.

   • Sincronização completa do banco de dados de análise

   • Sincronização do banco de dados de análise incremental

Processar dimensões padrão para a capacidade expandida

Você deverá executar o serviço Web ProcessDefaultDimensionsForExpandedCapacity quando receber a seguinte mensagem de erro:

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.

Esse serviço altera o StringStoresCompatibilityLevel para 1100 da dimensão Version Control File e executa um reprocessamento de cubo completo.

1. No serviço Web de controle de depósito, escolha ProcessDefaultDimensionsForExpandedCapacity.

2. O serviço retorna Verdadeiro quando restaura com êxito o valor como 1100.

   Espere até que o processamento do cubo seja bem-sucedido.

Perguntas e respostas

Quando devo processar uma base de dados em relação a uma recompilação?

R: Processe uma base de dados manualmente de acordo com um dos seguintes motivos:

• Processe o cubo incrementalmente quando os relatórios não mostrarem os dados mais recentes e você precisar que estejam atualizados para futuras reuniões.

• Processe cada coleção de projetos de equipe dentro do depósito de dados para verificar a resolução de todos os conflitos de esquema.

• Processe cada coleção de projetos de equipe dentro do depósito de dados para coletar informações para diagnosticar problemas que aparecem no visualizador de eventos relacionados ao trabalho do depósito.

Execute uma recompilação completa do depósito e do cubo quando mover, restaurar, renomear ou efetuar failover do servidor de camada de dados TFS.

P: Como posso alterar o intervalo de processamento de atualização ou outros parâmetros de processamento?

R: Consulte Gerenciar relatórios TFS, data warehouse e cubo de serviços de análise.

P: Onde posso saber mais sobre como resolver conflitos de esquema?

R: Consulte Resolver conflitos de esquema que estão ocorrendo no data warehouse.