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

Gerenciar indexação

A pesquisa é gerenciada executando scripts do PowerShell e do 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. Esse servidor executa o banco de dados para Azure DevOps Server usando a opção Baixar ZIP.

Os scripts do PowerShell exigem os arquivos de script SQL, portanto, verifique se a pasta SqlScripts e seu conteúdo estão presentes, juntamente com os scripts do PowerShell.

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

Observação

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

Verificar o status da indexação

Para verificar o status da indexação após a configuração da Pesquisa ou após a instalação da extensão 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 da coleção 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 de coleção foi disparada com êxito: indica que a indexação está em andamento.
    • Indexação de repositórios concluída: lista os 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. Leva algum tempo para a indexação ser concluída.

  3. Execute o RecentIndexingActivity.ps1 script em intervalos para o progresso da indexação. Esse 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 para os quais a 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 para os quais a indexação não está concluída. Esses repositórios ainda estão sendo indexados e parcialmente pesquisáveis.
    • Indexação contínua concluída de repositórios: 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 envios por push 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 poderiam potencialmente mostrar resultados incompletos até que trabalhos de indexação posteriores para os mesmos repositórios corrigissem 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 de coleção foi disparada com êxito: indica que a indexação está em andamento.
    • Indexação de repositórios concluída: lista os 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 esse estágio.
    • Indexação de repositórios 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. Monitore 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 for alterado 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, que é útil se você vir picos na utilização da CPU após a configuração da Pesquisa. Você será solicitado a inserir as seguintes informações.

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

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 em que o banco de dados de configuração do Azure DevOps Server está
  • O nome do banco de dados de configuração do Azure DevOps Server

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 Servidor de DevOps do Azure. Você será solicitado a inserir as seguintes informações.

  • O nome da instância do SQL Server em que o banco de dados de configuração do Azure DevOps Server está
  • O nome do banco de dados da coleção Azure DevOps Server
  • O nome do banco de dados de configuração do Azure DevOps Server
  • O tipo de reindexação a ser executado, Git\_Repository ou TFVC\_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 em que o banco de dados de configuração do Azure DevOps Server está
  • O nome do banco de dados da coleção Azure DevOps Server
  • O nome do banco de dados de configuração do Azure DevOps Server
  • O nome da coleção
  • As entidades a serem reindexadas, ou All, Code, WorkItem, ou Wiki

Pesquisar limitações

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