Partager via


Résolution des problèmes liés à Azure Data Studio

Azure Data Studio effectue le suivi des problèmes et des requêtes de fonctionnalités à l’aide d’un système de suivi des problèmes du référentiel GitHub pour le référentiel azuredatastudio.

Signaler un problème que vous avez rencontré

Signalez les problèmes au Système de suivi des problèmes GitHub et indiquez-nous les détails qui permettent de reproduire l’erreur. Incluez toutes les informations de journalisation à partir du fichier journal.

Écriture de rapports de bogues et de requêtes de fonctionnalités corrects

Enregistrez dans le fichier un seul sujet par problème et requête de fonctionnalité.

  • N’énumérez pas plusieurs bogues ou requêtes de fonctionnalités dans le même problème.
  • N’ajoutez pas votre problème en tant que commentaire à un problème existant, sauf s’il s’agit d’une entrée identique. De nombreux problèmes semblent similaires, mais ont des causes différentes.

Plus vous pouvez fournir d’informations, plus il sera facile de reproduire le problème et de trouver un correctif.

Incluez les informations suivantes dans chaque problème :

  • Version d’Azure Data Studio
  • Étapes reproductibles (1... 2... 3...) et ce que vous avez attendu par rapport aux faits réels constatés.
  • Des images, des animations ou un lien vers une vidéo. Les images et les animations illustrent les étapes de reproduction, mais ne les remplacent pas.
  • Un extrait de code qui illustre le problème ou un lien vers un référentiel de code que nous pouvons facilement extraire sur notre ordinateur pour recréer le problème.

Remarque

Étant donné que nous devons copier et coller l’extrait de code, il ne suffit pas d’inclure un extrait de code comme fichier multimédia (à savoir .gif).

  • Erreurs dans la console des outils de développement (Aide > Activer les outils de développement)

N’oubliez pas d’effectuer les étapes suivantes :

  • Effectuez une recherche dans le référentiel de problèmes pour voir si le même problème existe déjà.
  • Simplifiez votre code autour du problème afin de pouvoir mieux isoler le problème.

Ne vous inquiétez pas si nous ne pouvons pas reproduire le problème et demandons plus d’informations !

Comment définir le niveau de journalisation

Azure Data Studio

Dans la palette de commandes (Ctrl/Cmd + Maj + P), exécutez la commande Développeur : Définir le niveau de journal... pour sélectionner le niveau de journal pour la session active. Cette valeur n’est pas conservée sur plusieurs sessions. Si vous redémarrez Azure Data Studio, le niveau Info par défaut est rétabli.

Si vous souhaitez activer la journalisation du débogage pour le démarrage, définissez le niveau de journalisation sur Debug et exécutez la commande Développeur : Recharger Window.

MSSQL (extension intégrée)

Si le paramètre utilisateur Mssql: Log Debug Info a la valeur « true » (vrai), les informations du journal de débogage sont envoyées au canal de sortie MSSQL.

Le paramètre utilisateur Mssql: Tracing Level est utilisé pour contrôler la verbosité de la journalisation.

Journaux et emplacement d’Azure Data Studio

À partir de la palette de commandes (Ctrl/Cmd + Maj + P), exécutez la commande Développeur : Ouvrir le dossier Journaux pour ouvrir le chemin d'accès aux journaux d’activité. Il existe de nombreux types de fichiers journaux qui écrivent à cet emplacement. En voici quelques-uns qui sont couramment utilisés :

  1. renderer#.log (par exemple, renderer1.log) : ce fichier est le fichier journal du processus principal.
  2. telemetry.log : lorsque le niveau de journal est défini sur Trace ce fichier contient les événements de télémétrie envoyés par Azure Data Studio
  3. exthost#/exthost.log : fichier journal pour le processus hôte d’extension (il s’agit uniquement du processus lui-même et non des extensions qui y sont exécutées)
  4. exthost#/Microsoft.mssql : journaux pour l’extension mssql, qui contient une grande partie de la logique de base pour les fonctionnalités MSSQL
    • sqltools.log est le journal d’activité du Service des outils SQL
  5. exthost#/output_logging_####### : ces dossiers contiennent les messages affichés dans le panneau Output d’Azure Data Studio. Chaque fichier est nommé #-<Channel Name>. Par exemple, le canal de sortie Notebooks peut être généré dans un fichier nommé 3-Notebooks.log.

Si vous êtes invité à fournir des journaux d'activité, compressez le dossier entier pour vous assurer que les bons journaux d'activité sont inclus.

Récupérer les fichiers de l’éditeur après un blocage

Si Azure Data Studio se bloque de façon inattendue, le redémarrage d’Azure Data Studio devrait également rouvrir tous les fichiers d’éditeur non enregistrés. Si ce n’est pas le cas, il peut y avoir eu une erreur lors de la tentative de réouverture. Dans ce cas, suivez ces étapes pour accéder au dossier contenant les sauvegardes où vous pouvez les ouvrir manuellement pour récupérer leur contenu.

  1. À partir de la palette de commandes (Ctrl/Cmd + Maj + P), exécutez la commande Développeur : Ouvrir le dossier de données utilisateur.
  2. Dans le dossier qui s’ouvre alors, accédez au dossier Backups.

Il contient des dossiers avec des noms générés de manière aléatoire. Dans ces dossiers se trouvent des fichiers qui contiennent les sauvegardes de l’éditeur (lesquelles incluent des métadonnées supplémentaires, ainsi que leur contenu texte).

Étapes suivantes