Felsökning av Azure Data Studio

Azure Data Studio spårar problem och funktionsförfrågningar med hjälp av en problemspårare för GitHub-lagringsplats 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

Rapportera separat för varje problem och funktionsbegäran.

• Räkna inte upp flera buggar eller funktionsbegäranden i samma problem.
• Lägg inte till ditt problem som en kommentar till ett befintligt problem om det inte gäller samma 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 åtgärdssteg 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.

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

Känn dig inte illa om vi inte kan återskapa problemet och behöver 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-loggfiler 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:

1. renderer#.log (till exempel renderer1.log): den här filen är loggfilen för huvudprocessen.
2. telemetry.log: När loggnivån är inställd på Traceinnehåller den här filen telemetrihändelserna som skickas av Azure Data Studio
3. exthost#/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)
4. exthost#/Microsoft.mssql: Loggar för mssql-tillägget, som innehåller mycket av kärnlogik för MSSQL-relaterade funktioner
   • sqltools.log är loggen för SQL Tools-tjänsten
5. exthost#/output_logging_#######: dessa mappar innehåller de meddelanden som visas i panelen Output i Azure Data Studio. Varje fil heter #-<Channel Name>. Utdatakanalen kan till exempel Notebooks mata ut till en fil med namnet 3-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, kommer en omstart av Azure Data Studio också att ö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.

1. Kör kommandot Developer: Open User Data Folder från kommandopaletten (Ctrl/Cmd + Skift + P).
2. 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).

Nästa steg

• Rapportera ett problem
• Vad är Azure Data Studio?