Gerenciar indexação de pesquisa

  • Artigo

Azure DevOps Server 2022 - Azure DevOps Server 2019

Você pode gerenciar sua extensão de pesquisa e status de indexação, que incluem as seguintes ações:

Pré-requisitos

Gerir a indexação

A pesquisa é gerenciada executando scripts PowerShell e SQL. Todos esses scripts estão disponíveis para download no repositório GitHub de Pesquisa de Código. Você pode baixar todos os scripts em uma pasta local no servidor. Este servidor executa o banco de dados do Servidor de DevOps do Azure usando a opção Baixar ZIP .

Os scripts do PowerShell exigem os arquivos de script SQL, portanto, certifique-se de que a pasta SqlScripts e seu conteúdo estejam presentes, juntamente com os scripts do PowerShell.

Captura de tela mostrando arquivos de script de download para administração.

Nota

Ao executar scripts, certifique-se de executar o script apropriado para sua versão:

Verificar o estado da indexação

Para verificar o status da indexação depois que a Pesquisa for configurada ou depois que a extensão for instalada para uma coleção, execute as etapas a seguir.

  1. Execute o ExtensionInstallIndexingStatus.ps1 script com privilégios administrativos e insira as seguintes informações:

    • O nome da instância do SQL Server onde o banco de dados de configuração do Servidor de DevOps do Azure está localizado.
    • O nome do banco de dados de coleção do Azure DevOps Server.
    • O nome do banco de dados de configuração do Azure DevOps Server.
    • O nome da coleção.
    • O número de dias anteriores para verificar o status da indexação.

  2. Analise as seguintes saídas:

    • A indexação da coleção foi acionada com êxito: indica que a indexação está em andamento.
    • Indexação de repositórios concluída: lista repositórios cuja indexação foi concluída e pode ser pesquisada.
    • Status dos repositórios atualmente indexados: lista os nomes de todos os repositórios que ainda estão sendo indexados e são parcialmente pesquisáveis. A indexação demora algum tempo a ser concluída.

  3. Execute o RecentIndexingActivity.ps1 script em intervalos para o progresso da indexação. Este script usa os mesmos parâmetros que o ExtensionInstallIndexingStatus.ps1 script:

    • Repositórios concluídos nova indexação: mostra o número de repositórios cuja indexação foi concluída dentro do intervalo de tempo especificado.
    • Contagem de repositórios com indexação nova em andamento: mostra o número de repositórios cuja indexação não está concluída. Esses repositórios ainda estão sendo indexados e são parcialmente pesquisáveis.
    • Repositórios concluídos indexação contínua: mostra o número de confirmações processadas no intervalo de tempo especificado. O número pode não corresponder exatamente ao número total de pushes para o repositório porque as mesclagens são confirmadas à medida que são indexadas.
    • Contagem de repositórios com indexação contínua em andamento: mostra o número de repositórios para os quais as confirmações ainda estão sendo processadas. Esses repositórios mostram resultados incompletos até que a indexação seja concluída.
    • Contagem de falhas de trabalho de indexação: mostra o número de trabalhos de indexação que falharam. Os repositórios associados a esses trabalhos de indexação podem potencialmente mostrar resultados incompletos até que trabalhos de indexação posteriores para os mesmos repositórios corrijam a indexação com falha.

  1. Execute o CheckIndexingStatus.ps1 script com privilégios administrativos e insira as seguintes informações:

    • O nome da instância do SQL Server onde o banco de dados de configuração do TFS está localizado.
    • O nome do banco de dados de coleção do TFS.
    • O nome do banco de dados de configuração do TFS.
    • O nome da coleção.
    • O número de dias anteriores para verificar o status da indexação.

  2. Analise as seguintes saídas:

    • A indexação da coleção foi acionada com êxito: indica que a indexação está em andamento.
    • Indexação de repositórios concluída: lista repositórios cuja indexação foi concluída e pode ser pesquisada.
    • Repositórios na fase de descoberta de arquivos: repositórios onde os arquivos ainda não foram descobertos. Esses arquivos são indexados após esta etapa.
    • Repositórios indexados em andamento: repositórios que são parcialmente indexados e devem ser pesquisáveis, mesmo que os resultados sejam apenas parciais. Pode levar algum tempo para que a indexação seja concluída.

  3. Monitorize o progresso:

    1. Execute o CheckIndexingStatus.ps1 script em intervalos para o progresso da indexação.
    2. Se a indexação não estiver funcionando ou se o número de arquivos pendentes não mudar por algum tempo, execute o TriggerCollectionIndexing.ps1 script com permissão administrativa.

Se você encontrar algum problema, obtenha suporte na Comunidade de desenvolvedores.

Pausar a indexação

Para pausar toda a indexação, execute: PauseSearchIndexing.ps1, o que é útil se você vir picos na utilização da CPU depois de configurar a Pesquisa. Você será solicitado a inserir as seguintes informações.

  • O nome da instância do SQL Server onde está o banco de dados de configuração do Servidor de DevOps do Azure
  • O nome do banco de dados de configuração do Servidor de DevOps do Azure

Retomar a indexação

Se você pausou a indexação, execute: ResumeIndexing.ps1 para começar novamente. Você será solicitado a inserir as seguintes informações.

  • O nome da instância do SQL Server onde está o banco de dados de configuração do Servidor de DevOps do Azure
  • O nome do banco de dados de configuração do Servidor de DevOps do Azure

Reindexar um repositório ou coleção

Para reindexar um repositório Git ou TFVC, execute a versão apropriada do script, Re-IndexingRepository.ps1, para sua versão do Azure DevOps Server. Você será solicitado a inserir as seguintes informações.

  • O nome da instância do SQL Server onde está o banco de dados de configuração do Servidor de DevOps do Azure
  • O nome do banco de dados da coleção do Azure DevOps Server
  • O nome do banco de dados de configuração do Servidor de DevOps do Azure
  • O tipo de reindexação a ser executada, ou Git\_RepositoryTFVC\_Repository
  • O nome da coleção
  • O nome do repositório a ser reindexado

Para reindexar uma coleção, execute o script: TriggerCollectionIndexing.ps1. Você será solicitado a inserir as seguintes informações.

  • O nome da instância do SQL Server onde está o banco de dados de configuração do Servidor de DevOps do Azure
  • O nome do banco de dados da coleção do Azure DevOps Server
  • O nome do banco de dados de configuração do Servidor de DevOps do Azure
  • O nome da coleção
  • As entidades a reindexar, ou All, Code, WorkItem, ou Wiki

Limitações da pesquisa

Se você fizer uma operação de recuperação de desastres (DR) e mover o servidor de volta para um instantâneo anterior do banco de dados SQL, reindexe todas as suas coleções.