Personnalisation des paramètres

À propos des paramètres dans le CodeQL pour l’extension Visual Studio Code

Vous pouvez modifier de nombreux paramètres du CodeQL pour l’extension Visual Studio Code, notamment :

• La version de CodeQL CLI que l’extension utilise.
• La façon dont l’extension affiche les requêtes précédentes.
• La façon dont l’extension exécute les requêtes.

Modification des paramètres de l’extension CodeQL

1. Ouvrez la vue « Extensions » et cliquez avec le bouton droit sur CodeQL, puis cliquez sur Paramètres de l’extension.

   

2. Dans la fenêtre Paramètres, modifiez les paramètres comme vous le souhaitez. Les nouveaux paramètres sont enregistrés automatiquement.

   

Choix d’une version de CodeQL CLI

Pour remplacer le comportement par défaut et utiliser une version spécifique de CodeQL CLI, vous pouvez spécifier le « Chemin d’accès exécutable » CodeQL CLI dans les paramètres d’extension, puis le faire pointer vers votre copie existante de CodeQL CLI. Autrement dit, le fichier nommé codeql (Linux et macOS) ou codeql.exe (Windows). Pour plus d’informations sur la comportement par défaut, consultez « Configuration de l’accès à la CLI CodeQL ».

Modification des étiquettes des éléments d’historique des requêtes

Le paramètre « Format » de l’historique des requêtes contrôle la façon dont l’extension répertorie les requêtes dans l’historique des requêtes. Par défaut, chaque élément a une étiquette au format suivant :

QUERY-NAME on DATABASE-NAME - QUERY-STATUS NUMBER-OF-RESULTS [QUERY-RUNTIME]

Pour remplacer l’étiquette par défaut, vous pouvez spécifier un format différent pour les éléments d’historique des requêtes.

Modification de la période de rétention pour les éléments d’historique des requêtes

Par défaut, les éléments de la vue « Historique des requêtes » sont conservés pendant 30 jours. Vous pouvez définir une durée de vie (TTL) différente en modifiant le paramètre « Historique des requêtes : Ttl ». Pour conserver les éléments indéfiniment, définissez la valeur sur 0.

Configuration des paramètres pour l’exécution de requêtes localement

Il existe un certain nombre de paramètres sous « Exécution des requêtes ». Par exemple, si vos requêtes s’exécutent trop lentement et expirent fréquemment, vous pouvez souhaiter augmenter la mémoire en modifiant le paramètre « Requêtes en cours d’exécution : Mémoire ».

Si vous souhaitez examiner les performances des requêtes, activez le paramètre « Requêtes en cours d’exécution : Débogage » pour inclure le minutage et le nombre de tuples. Ces informations s’afficheront ensuite dans les journaux d’activité dans l’onglet « Serveur de requêtes » du CodeQL dans la vue « Sortie ». Le nombre de tuples est utile, car il indique la taille des prédicats calculés par la requête.

Pour enregistrer les journaux du serveur de requêtes dans un emplacement personnalisé, modifiez le paramètre « Requêtes en cours d’exécution : Répertoire des journaux personnalisés ». Si vous utilisez un répertoire de journaux personnalisé, l’extension enregistre définitivement les journaux, au lieu de les supprimer automatiquement après chaque session d’espace de travail. Cela est utile si vous souhaitez examiner ces journaux pour améliorer les performances de vos requêtes.

Configuration des paramètres pour l’analyse de variantes

Vous pouvez également modifier les éléments affichés dans la vue « Référentiels d’analyse des variantes » en modifiant un fichier dans votre espace de travail Visual Studio Code appelé databases.json. Ce fichier contient une représentation JSON de tous les éléments affichés dans la vue. Pour ouvrir votre fichier databases.json dans une fenêtre d’éditeur, cliquez sur l’icône { } en haut à droite de la vue « Référentiels d’analyse des variantes ». Vous pouvez ensuite voir une représentation structurée des référentiels, des organisations et des listes dans votre vue. Par exemple:

{
  "version": 1,
  "databases": {
    "variantAnalysis": {
      "repositoryLists": [
        {
          "name": "My favorite JavaScript repos",
          "repositories": [
            "facebook/react",
            "babel/babel",
            "angular/angular"
          ]
        }
      ],
      "owners": [
        "microsoft"
      ],
      "repositories": [
        "apache/hadoop"
      ]
    }
  },
  "selected": {
    "kind": "variantAnalysisSystemDefinedList",
    "listName": "top_10"
  }
}

Vous pouvez modifier les éléments affichés dans la vue ou ajouter de nouveaux éléments en modifiant directement ce fichier.

Configuration des paramètres pour l’ajout de bases de données

Pour ajouter automatiquement des dossiers sources de base de données à votre espace de travail, vous pouvez activer le paramètre « Ajout de bases de données : Ajouter une source de base de données à l’espace de travail ».

Ce paramètre est désactivé par défaut. Vous pouvez activer le paramètre si vous parcourez régulièrement le code source des bases de données (par exemple, pour afficher l’arborescence de syntaxe abstraite du code). Pour plus d’informations, consultez « Exploration de la structure de votre code source ».

Configuration des paramètres pour tester des requêtes localement

Pour augmenter le nombre de threads utilisés pour tester les requêtes, vous pouvez mettre à jour le paramètre « Tests en cours d’exécution : Nombre de threads ».

Pour passer des arguments supplémentaires à CodeQL CLI lors de l’exécution de tests, vous pouvez mettre à jour le paramètre « Tests en cours d’exécution : Arguments de test supplémentaires ». Pour plus d’informations sur les arguments disponibles, consultez « test run ».

Configuration des paramètres pour la télémétrie et la collecte de données

Vous pouvez configurer si l’extension CodeQL doit collecter ou non les données de télémétrie. Elle est désactivée par défaut. Pour plus d’informations, consultez « Télémétrie dans CodeQL pour Visual Studio Code ».

Lectures complémentaires

•           [Paramètres utilisateur et d’espace de travail](https://code.visualstudio.com/docs/configure/settings) dans la documentation Visual Studio Code