Sdílet prostřednictvím

Řešení potíží se sadou Azure Data Studio

  • Článek

Azure Data Studio sleduje problémy a žádosti o funkce pomocí sledování problémů úložiště GitHub pro azuredatastudio úložiště.

Nahlášení problému, ke kterém došlo

Nahlašte problémy do nástroje GitHub Issue Tracker a dejte nám vědět o všech podrobnostech, které vám pomůžou chybu reprodukovat. Zahrňte všechny informace protokolu ze souboru protokolu.

Psaní vhodných zpráv o chybách a žádostí o funkce

Vytvořte jeden problém na jeden problém a žádost o funkci.

  • Ve stejném problému nevyčtujte více chyb ani žádostí o funkce.
  • Nepřidávejte svůj problém jako komentář k existujícímu problému, pokud se nejedná o stejný vstup. Mnoho problémů vypadá podobně, ale mají různé příčiny.

Čím více informací můžete poskytnout, tím pravděpodobnější bude někdo úspěšně reprodukovat problém a najít opravu.

Při každém problému uveďte následující informace:

  • Verze nástroje Azure Data Studio
  • Reprodukovatelné kroky (1... 2... 3...) a to, co jste očekávali a co jste skutečně viděli.
  • Obrázky, animace nebo odkaz na video Obrázky a animace znázorňují kroky pro reprodukci, ale nenahrazovat je.
  • Fragment kódu, který ukazuje problém nebo odkaz na úložiště kódu, můžeme snadno stáhnout na náš počítač a problém vytvořit znovu.

Poznámka:

Protože potřebujeme zkopírovat a vložit fragment kódu, včetně fragmentu kódu jako mediálního souboru (tj .gif. ) nestačí.

  • Chyby v konzole Dev Tools (pomoc > s přepínáním vývojářských nástrojů)

Nezapomeňte provést následující kroky:

  • Vyhledejte úložiště problému a zjistěte, jestli už stejný problém existuje.
  • Zjednodušte kód kolem problému, abychom mohli problém lépe izolovat.

Necítit se špatně, pokud nemůžeme problém reprodukovat a požádat o další informace!

Jak nastavit úroveň protokolování

Azure Data Studio

Na paletě příkazů (Ctrl/Cmd + Shift + P) spusťte příkaz Vývojář: Nastavit úroveň protokolu... a vyberte úroveň protokolu pro aktuální relaci. Tato hodnota není trvalá u více relací. Pokud restartujete Azure Data Studio, vrátí se zpět na výchozí Info úroveň.

Pokud chcete povolit protokolování ladění pro spuštění, nastavte úroveň Debug protokolu a spusťte příkaz Developer: Znovu načíst okno .

MSSQL (integrované rozšíření)

Mssql: Log Debug Info Pokud je nastavení uživatele nastaveno na true, informace protokolu ladění se odesílají do výstupního MSSQL kanálu.

Uživatelské Mssql: Tracing Level nastavení slouží k řízení podrobností protokolování.

Protokoly a umístění nástroje Azure Data Studio

Z palety příkazů (Ctrl/Cmd + Shift + P) spusťte příkaz Vývojář: Otevřít složku protokolů a otevřete cestu k protokolům. Existuje mnoho různých typů souborů protokolu, které tam zapisují. Mezi běžně používané patří:

  1. renderer#.log (například renderer1.log): Tento soubor je soubor protokolu pro hlavní proces.
  2. telemetry.log: Pokud je úroveň protokolu nastavená na Trace, tento soubor obsahuje události telemetrie odeslané nástrojem Azure Data Studio.
  3. exthost#/exthost.log: Soubor protokolu pro proces hostitele přípony (to je pouze samotný proces, nikoli rozšíření spuštěná v něm)
  4. exthost#/Microsoft.mssql: Protokoly pro rozšíření mssql, které obsahuje velkou část základní logiky pro funkce související s MSSQL
    • sqltools.log je protokol pro službu SQL Tools.
  5. exthost#/output_logging_#######: Tyto složky obsahují zprávy zobrazené na panelu Output v nástroji Azure Data Studio. Každý soubor má název #-<Channel Name>. Výstupní kanál může například Notebooks výstupem do souboru s názvem 3-Notebooks.log.

Pokud se zobrazí výzva k zadání protokolů, zazipujte celou složku a ujistěte se, že jsou zahrnuté správné protokoly.

Obnovení souborů editoru po chybovém ukončení

Pokud se Azure Data Studio neočekávaně chybově ukončí, restartování nástroje Azure Data Studio by mělo znovu otevřít všechny neuložené soubory editoru. Pokud ne, mohlo dojít k chybě při pokusu o opětovné otevření. V takovém případě pomocí následujícího postupu přejděte do složky obsahující zálohy, kde je můžete ručně otevřít a obnovit jejich obsah.

  1. Z palety příkazů (Ctrl/Cmd + Shift + P) spusťte příkaz Vývojář: Otevřít složku uživatelských dat.
  2. Ve složce, která se otevře, přejděte do Backups složky.

Obsahuje složky s náhodně generovanými názvy. V těchto složkách jsou soubory, které obsahují zálohy editoru (které obsahují několik dalších metadat spolu s textovým obsahem).

Další kroky