Gerenciar indexação de pesquisa
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:
- Verificar o estado da indexação
- Pausar a indexação
- Retomar a indexação
- Reindexar um repositório ou coleção
Pré-requisitos
- Instale e configure a Pesquisa.
- Ser atribuído à função de Administrador de Coleção de Projetos (PCA) para que a organização gerencie a Pesquisa e a indexação.
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.
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.
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.
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.
Execute o
RecentIndexingActivity.ps1
script em intervalos para o progresso da indexação. Este script usa os mesmos parâmetros que oExtensionInstallIndexingStatus.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.
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.
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.
Monitorize o progresso:
- Execute o
CheckIndexingStatus.ps1
script em intervalos para o progresso da indexação. - 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.
- Execute o
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\_Repository
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 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
, ouWiki
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.