Gérer l’indexation de recherche

  • Article

Azure DevOps Server 2022 - Azure DevOps Server 2019 | TFS 2018

Vous pouvez gérer votre extension de recherche et vos status d’indexation, qui incluent les actions suivantes :

Prérequis

Gérer l’indexation

La recherche est gérée en exécutant des scripts PowerShell et SQL. Tous ces scripts peuvent être téléchargés à partir du dépôt GitHub Code-Search. Vous pouvez télécharger tous les scripts dans un dossier local sur le serveur. Ce serveur exécute la base de données pour Azure DevOps Server à l’aide de l’option Télécharger le fichier ZIP.

Les scripts PowerShell nécessitent les fichiers de script SQL. Vérifiez donc que le dossier SqlScripts et son contenu sont présents, ainsi que les scripts PowerShell.

Capture d’écran montrant le téléchargement des fichiers de script pour l’administration.

Notes

Lorsque vous exécutez des scripts, assurez-vous d’exécuter le script approprié pour votre version Azure DevOps Server ou TFS :

Vérifier les status d’indexation

Pour TFS 2018 et Azure DevOps Server, consultez la section suivante.

Pour case activée le status d’indexation après la configuration de la recherche ou après l’installation de l’extension pour un regroupement, procédez comme suit :

  1. Exécutez le CheckIndexingStatus.ps1 script avec des privilèges d’administration. Vous êtes invité à entrer les informations suivantes :

    • Le serveur SQL instance nom où se trouve la base de données de configuration TFS.
    • Nom de la base de données de la collection TFS.
    • Nom de la base de données de configuration TFS.
    • Nom de la collection.
    • Nombre de jours précédents pour case activée status d’indexation.

  2. Vérifiez les sorties suivantes :

Output Description
L’indexation de collection a été déclenchée avec succès Indique que l’indexation est en cours. S’il s’affiche, case activée les sorties suivantes. Si elle n’est pas affichée, passez à l’étape 3.
Indexation des dépôts terminée Les dépôts dont l’indexation a été terminée et qui peuvent désormais faire l’objet d’une recherche.
Dépôts dans la phase de découverte de fichiers Dépôts où les fichiers doivent encore être découverts. Les fichiers sont indexés après cette étape. Les dépôts dans cet état ne peuvent pas encore faire l’objet d’une recherche. Le nombre de fichiers déjà découverts pour l’indexation dans chaque dépôt s’affiche. Ce nombre augmente à mesure que d’autres fichiers sont découverts.
Indexation des dépôts en cours Ces dépôts sont partiellement indexés et doivent faire l’objet d’une recherche, même si les résultats ne sont que partiels.
  1. L’indexation prend un certain temps. Exécutez le CheckIndexingStatus.ps1 script à intervalles réguliers pour case activée progression de l’indexation.
  2. Si l’indexation ne fonctionne pas ou est en cours, mais que le nombre de fichiers en attente n’a pas changé depuis un certain temps, ou si vous n’obtenez aucun résultat pour une recherche, exécutez le TriggerCollectionIndexing.ps1 script dans une fenêtre PowerShell avec l’autorisation d’administration.
  3. Si le problème persiste, accédez au Developer Community pour obtenir de l’aide.

Vérifier les status d’indexation pour TFS 2018 et versions ultérieures

Pour case activée le status d’indexation après la configuration de la recherche ou après l’installation de l’extension pour un regroupement, procédez comme suit :

  1. Exécutez le ExtensionInstallIndexingStatus.ps1 script avec des privilèges d’administration. Vous êtes invité à entrer :

    • Nom du instance SQL Server où se trouve la base de données de configuration Azure DevOps Server.
    • Nom de la base de données de collection Azure DevOps Server.
    • Nom de la base de données de configuration Azure DevOps Server.
    • Nom de la collection.
    • Nombre de jours précédents pour case activée status d’indexation.

  2. Vérifiez les sorties suivantes.

Outputs Description
L’indexation de collection a été déclenchée avec succès Indique que l’indexation est en cours. S’il s’affiche, case activée les sorties suivantes. S’il n’est pas affiché, passez à l’étape suivante.
Indexation terminée des référentiels Nombre de dépôts pour lesquels l’indexation a été effectuée et qui peuvent faire l’objet d’une recherche.
État des dépôts en cours d’indexation Liste des noms de tous les dépôts qui sont toujours indexés et qui peuvent faire l’objet d’une recherche partielle.
  1. L’indexation prend un certain temps. Exécutez le RecentIndexingActivity.ps1 script à intervalles réguliers pour case activée progression de l’indexation. Ce script prend les mêmes paramètres que le ExtensionInstallIndexingStatus.ps1 script.
Outputs Description
Nouvelle indexation des référentiels terminée Nombre de dépôts pour lesquels l’indexation s’est terminée dans l’intervalle de temps spécifié.
Nombre de dépôts avec une nouvelle indexation en cours Nombre de dépôts pour lesquels l’indexation n’est pas encore terminée. Ces dépôts sont toujours indexés et peuvent faire l’objet d’une recherche partielle.
Référentiels terminés l’indexation continue Nombre de validations traitées dans l’intervalle de temps spécifié. Le nombre peut ne pas correspondre exactement au nombre total d’envois (push) vers le dépôt, car les fusions sont validées au fur et à mesure qu’elles sont indexées.
Nombre de dépôts avec indexation continue en cours Nombre de dépôts pour lesquels les validations sont toujours en cours de traitement. Ces dépôts affichent des résultats incomplets jusqu’à ce que l’indexation soit terminée.
Nombre d’échecs de travail d’indexation Nombre de travaux d’indexation ayant échoué. Les dépôts associés à ces travaux d’indexation peuvent potentiellement afficher des résultats incomplets jusqu’à ce que les travaux d’indexation ultérieurs pour les mêmes dépôts aient corrigé l’échec de l’indexation.

Suspendre l’indexation

Pour suspendre toute l’indexation, exécutez PauseSearchIndexing.ps1, ce qui est utile si vous constatez des pics d’utilisation du processeur après la configuration de la recherche. Vous êtes invité à entrer les informations suivantes :

  • Nom de instance sql server où se trouve la base de données de configuration Azure DevOps Server
  • Nom de la base de données de configuration Azure DevOps Server

Reprendre l’indexation

Si vous avez suspendu l’indexation, exécutez ResumeIndexing.ps1 pour recommencer. Vous êtes invité à entrer les informations suivantes :

  • Nom de instance sql server où se trouve la base de données de configuration Azure DevOps Server
  • Nom de la base de données de configuration Azure DevOps Server

Réindexer un dépôt ou une collection

Pour réindexer un référentiel Git ou TFVC, exécutez la version appropriée du script Re-IndexingRepository.ps1 pour votre version Azure DevOps Server. Vous êtes invité à entrer les informations suivantes :

  • Nom de instance sql server où se trouve la base de données de configuration Azure DevOps Server
  • Nom de la base de données de collection Azure DevOps Server
  • Nom de la base de données de configuration Azure DevOps Server
  • Type de réindexation à exécuter, ou Git\_RepositoryTFVC\_Repository
  • Nom de la collection
  • Nom du dépôt à réindexer

Pour réindexer une collection, exécutez le script TriggerCollectionIndexing.ps1 Vous êtes invité à entrer les informations suivantes :

  • Nom de instance sql server où se trouve la base de données de configuration Azure DevOps Server
  • Nom de la base de données de collection Azure DevOps Server
  • Nom de la base de données de configuration Azure DevOps Server
  • Nom de la collection
  • Entités à réindexer, All, Code, WorkItemou Wiki

Limitations de recherche

Si vous effectuez une opération de récupération d’urgence et que vous replacez votre serveur vers une instantané antérieure de votre base de données SQL, réindexez toutes vos collections.