Felsökning av Azure Data Studio
Azure Data Studio spårar problem och funktionsbegäranden som använder på en GitHub-lagringsplats– problemspårare för lagringsplatsen azuredatastudio
.
Rapportera ett problem som du har upplevt
Rapportera problem till GitHub Issue Tracker och meddela oss all information som hjälper oss att återskapa felet. Inkludera logginformation från loggfilen.
Skriva bra felrapporter och funktionsbegäranden
Skicka ett enda problem per problem och funktionsbegäran.
- Räkna inte upp flera buggar eller funktionsbegäranden i samma problem.
- Lägg inte till problemet som en kommentar till ett befintligt problem om det inte är för identiska indata. Många problem ser liknande ut, men har olika orsaker.
Ju mer information du kan ge, desto mer sannolikt är det att någon lyckas återskapa problemet och hitta en korrigering.
Inkludera följande information med varje problem:
- Version av Azure Data Studio
- Reproducerbara steg (1... 2... 3...) och vad du förväntade dig jämfört med vad du faktiskt såg.
- Bilder, animeringar eller en länk till en video. Bilder och animeringar illustrerar återgivningssteg men ersätter dem inte.
- Ett kodfragment som visar problemet eller en länk till en kodlagringsplats som vi enkelt kan hämta till vår dator för att återskapa problemet.
Kommentar
Eftersom vi behöver kopiera och klistra in kodfragmentet, inklusive ett kodfragment som en mediefil (dvs .gif
. ) räcker det inte.
- Fel i Dev Tools-konsolen (hjälp > med att växla utvecklarverktyg)
Kom ihåg att vidta följande steg:
- Sök i problemlagringsplatsen för att se om samma problem redan finns.
- Förenkla koden kring problemet så att vi bättre kan isolera problemet.
Må inte dåligt om vi inte kan återskapa problemet och be om mer information!
Så här ställer du in loggningsnivån
Azure Data Studio
Från kommandopaletten (Ctrl/Cmd + Skift + P)kör du kommandot Developer: Set Log Level... för att välja loggnivå för den aktuella sessionen. Det här värdet sparas inte över flera sessioner. Om du startar om Azure Data Studio återgår det till standardnivån Info
.
Om du vill aktivera felsökningsloggning för start anger du loggnivån till Debug
och kör kommandot Developer: Reload Window (Utvecklare: Läs in fönster igen).
MSSQL (inbyggt tillägg)
Om användarinställningen Mssql: Log Debug Info
är inställd på true skickas felsökningslogginformation till MSSQL
utdatakanalen.
Användarinställningen Mssql: Tracing Level
används för att styra loggningens utförlighet.
Azure Data Studio-loggar och -plats
Från kommandopaletten (Ctrl/Cmd + Skift + P)kör du kommandot Developer: Open Logs Folder för att öppna sökvägen till loggarna. Det finns många olika typer av loggfiler som skriver där. Några av de vanligaste är:
renderer#.log
(till exempelrenderer1.log
): den här filen är loggfilen för huvudprocessen.telemetry.log
: När loggnivån är inställd påTrace
innehåller den här filen telemetrihändelserna som skickas av Azure Data Studioexthost#/exthost.log
: Loggfil för värdprocessen för tillägget (det här är bara själva processen, inte tilläggen som körs i den)exthost#/Microsoft.mssql
: Loggar för mssql-tillägget, som innehåller mycket av kärnlogik för MSSQL-relaterade funktionersqltools.log
är loggen för SQL Tools-tjänsten
exthost#/output_logging_#######
: dessa mappar innehåller de meddelanden som visas i panelenOutput
i Azure Data Studio. Varje fil heter#-<Channel Name>
. Utdatakanalen kan till exempelNotebooks
mata ut till en fil med namnet3-Notebooks.log
.
Om du uppmanas att ange loggar zippar du upp hela mappen för att säkerställa att rätt loggar ingår.
Återställa redigeringsfiler efter en krasch
Om Azure Data Studio kraschar oväntat bör även omstart av Azure Data Studio öppna alla filer som inte har sparats. Om de inte gör det kan det ha uppstått ett fel när de skulle öppnas igen. I så fall följer du de här stegen för att navigera till mappen som innehåller säkerhetskopiorna där du kan öppna dem manuellt för att återställa innehållet.
- Kör kommandot Developer: Open User Data Folder från kommandopaletten (Ctrl/Cmd + Skift + P).
- Gå till
Backups
mappen i mappen som öppnas.
Detta innehåller mappar med slumpmässigt genererade namn. I dessa mappar finns filer som innehåller säkerhetskopior av redigeraren (som innehåller ytterligare metadata tillsammans med deras textinnehåll).