Risoluzione dei problemi di Azure Data Studio

Articolo
10/18/2023

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

Segnalare un problema riscontrato

Segnalare i problemi a GitHub Issue Tracker e segnalare eventuali dettagli che consentono di riprodurre l'errore. Includere tutte le informazioni del log presenti nel file di log.

Scrivere report di bug e richieste di funzionalità valide

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 quello che ti aspettavi rispetto a quello che hai effettivamente visto.
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, incluso un frammento di codice come file multimediale (ovvero , .gif) non è sufficiente.

Errori nella console di Dev Tools (Guida > /Disattiva strumenti di sviluppo)

Ricordarsi di eseguire i passaggi seguenti:

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 Developer: Set Log Level... (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 di debug per l'avvio, impostare il livello di log su Debug ed eseguire il comando Developer: Reload Window .

MSSQL (estensione predefinita)

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

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 lì. Alcuni di quelli comunemente usati sono:

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

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

Ripristinare 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 questa procedura per passare alla cartella contenente i backup in cui è possibile aprirli manualmente per recuperarne il contenuto.

Dal riquadro comandi (CTRL/CMD + MAIUSC + P), eseguire il comando Developer: Open User Data Folder (Sviluppo: Apri cartella dati utente).
Nella cartella visualizzata passare alla Backups cartella .

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).

Share via