Condividi tramite

Risoluzione dei problemi di Azure Data Studio

  • Articolo

Azure Data Studio tiene traccia dei problemi e delle richieste di funzionalità tramite una scheda Issue Tracker del repository GitHub per il repository azuredatastudio.

Segnalazione dei problemi

Segnalare i problemi in Issue Tracker di GitHub e comunicare i dettagli che consentiranno di riprodurre l'errore. Includere tutte le informazioni del log presenti nel file di log.

Creazione di report sui bug utili e richieste di funzionalità

Compilare un singolo problema per ogni bug e richiesta di funzionalità.

  • Non elencare più bug o richieste di funzionalità all'interno dello stesso problema.
  • Non aggiungere il problema come commento a un problema esistente a meno che non si tratti di un input identico. Molti problemi sembrano simili ma hanno cause diverse.

Maggiori sono le informazioni inviate, maggiore sarà la probabilità che un utente riesca a riprodurre il problema e a trovare una soluzione.

Includere le informazioni seguenti con ogni problema:

  • Versione di Azure Data Studio
  • Passaggi riproducibili (1… 2… 3...) e ciò che era previsto rispetto a ciò che è avvenuto realmente.
  • Immagini, animazioni o un collegamento a un video. Immagini e animazioni illustrano la procedura per riprodurre il problema, ma non la sostituiscono.
  • Un frammento di codice che illustra il problema o un collegamento a un repository di codice facilmente visualizzabile sul computer per riprodurre il problema.

Nota

Poiché è necessario copiare e incollare il frammento di codice, non è sufficiente includere un frammento di codice sotto forma di file multimediale (ovvero .gif).

  • Errori nella console degli strumenti di sviluppo (Guida > Attiva/Disattiva strumenti di sviluppo)

A tale scopo, seguire questa procedura:

  • Cercare nel repository dei problemi per verificare se lo stesso problema esiste già.
  • Semplificare il codice intorno al problema in modo da poterlo isolare meglio.

Non scoraggiarsi se non è possibile riprodurre il problema e sono necessarie altre informazioni!

Come impostare il livello di registrazione

Azure Data Studio

Dal riquadro comandi (CTRL/cmd + maiusc + P) eseguire il comando Sviluppatore: Imposta livello di log… per selezionare il livello di log per la sessione corrente. Questo valore non viene salvato in modo permanente in più sessioni. Se si riavvia Azure Data Studio, viene ripristinato il livello predefinito Info.

Se si vuole abilitare la registrazione del debug per l'avvio, impostare il livello di registrazione su Debug ed eseguire il comando Sviluppatore: ricarica finestra.

MSSQL (estensione predefinita)

Se l'impostazione utente Mssql: Log Debug Info è true, le informazioni sul log di debug vengono inviate al canale di output MSSQL.

L'impostazione utente Mssql: Tracing Level viene usata per controllare il livello di dettaglio della registrazione.

Log e posizione di Azure Data Studio

Dal riquadro comandi (CTRL/CMD + MAIUSC + P) eseguire il comando Developer: Open Logs Folder (Sviluppatore: Apri cartella log) per aprire il percorso dei log. Esistono molti tipi diversi di file di log che scrivono in questa posizione. Alcuni di quelli comunemente usati sono:

  1. renderer#.log (ad esempio, renderer1.log): si tratta del file di log del processo principale.
  2. telemetry.log: quando il livello di registrazione è impostato su Trace, questo file conterrà gli eventi di telemetria inviati da Azure Data Studio
  3. exthost#/exthost.log: file di log per il processo host dell’estensione (si tratta solo del processo e non delle estensioni in esecuzione al suo interno)
  4. exthost#/Microsoft.mssql: log per l'estensione MSSQL, contenente gran parte della logica di base per le funzionalità correlate a MSSQL
    • sqltools.log: è il log per il servizio SQL Tools
  5. exthost#/output_logging_#######: queste cartelle contengono i messaggi visualizzati nel pannello Output in Azure Data Studio. Ogni file è denominato #-<Channel Name>. Ad esempio il canale di output Notebooks può restituire un file denominato 3-Notebooks.log.

Se viene richiesto di inviare i log, comprimere l'intera cartella per assicurarsi che siano inclusi i log corretti.

Recuperare i file dell'editor dopo un arresto anomalo

Se Azure Data Studio si arresta in modo imprevisto, riavviare Azure Data Studio dovrebbe riaprire anche eventuali file dell'editor non salvati. In caso contrario, potrebbe essersi verificato un errore durante il tentativo di riaprirli. In tal caso, seguire questi passaggi per passare alla cartella contenente i backup e aprirli manualmente per recuperarne il contenuto.

  1. Dal riquadro comandi (CTRL/CMD + MAIUSC + P), eseguire il comando Developer: Open User Data Folder (Sviluppo: Apri cartella dati utente).
  2. Dalla cartella che si apre, passare alla cartella Backups.

Contiene cartelle con nomi generati in modo casuale. All'interno di queste cartelle sono presenti file che contengono i backup dell'editor (che includono alcuni metadati aggiuntivi insieme al relativo contenuto di testo).

Passaggi successivi