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 status da indexação
- Pausar indexação
- Indexação de currículos
- Reindexar um repositório ou coleção
Pré-requisitos
- Instale e configure a Pesquisa.
- Ser atribuído à função Administrador de Coleção de Projetos (PCA) para a organização gerenciar a Pesquisa e a indexação.
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.
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.
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.
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.
Execute o
RecentIndexingActivity.ps1
script em intervalos para o progresso da indexação. Esse script usa os mesmos parâmetros que oExtensionInstallIndexingStatus.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.
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 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.
Monitore 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 for alterado 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
, 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
ouTFVC\_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
, ouWiki
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.