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 :
renderer#.log
(par exemple,renderer1.log
) : ce fichier est le fichier journal du processus principal.telemetry.log
: lorsque le niveau de journal est défini surTrace
ce fichier contient les événements de télémétrie envoyés par Azure Data Studioexthost#/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)exthost#/Microsoft.mssql
: journaux pour l’extension mssql, qui contient une grande partie de la logique de base pour les fonctionnalités MSSQLsqltools.log
est le journal d’activité du Service des outils SQL
exthost#/output_logging_#######
: ces dossiers contiennent les messages affichés dans le panneauOutput
d’Azure Data Studio. Chaque fichier est nommé#-<Channel Name>
. Par exemple, le canal de sortieNotebooks
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.
- À partir de la palette de commandes (Ctrl/Cmd + Maj + P), exécutez la commande Développeur : Ouvrir le dossier de données utilisateur.
- 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).