Udostępnij za pośrednictwem

Rozwiązywanie problemów z narzędziem Azure Data Studio

  • Artykuł

Usługa Azure Data Studio śledzi problemy i żądania funkcji używane w monitorze problemów z repozytorium GitHub dla azuredatastudio repozytorium.

Zgłoś problem, który wystąpił

Zgłoś problemy do usługi GitHub Issue Tracker i poinformuj nas o wszelkich szczegółach, które ułatwiają odtworzenie błędu. Dołącz wszystkie informacje dziennika z pliku dziennika.

Pisanie dobrych raportów o błędach i żądań funkcji

Utwórz pojedynczy problem dla każdego problemu i żądania funkcji.

  • Nie wyliczaj wielu usterek ani żądań funkcji w tym samym problemie.
  • Nie dodawaj problemu jako komentarza do istniejącego problemu, chyba że dotyczy on identycznych danych wejściowych. Wiele problemów wygląda podobnie, ale ma różne przyczyny.

Więcej informacji można podać, tym bardziej prawdopodobne, że ktoś uda się odtworzyć problem i znaleźć poprawkę.

Dołącz następujące informacje dotyczące każdego problemu:

  • Wersja narzędzia Azure Data Studio
  • Powtarzalne kroki (1... 2... 3...) i czego się spodziewałeś w porównaniu z tym, co rzeczywiście widziałeś.
  • Obrazy, animacje lub link do wideo. Obrazy i animacje ilustrują kroki odtworzenia, ale nie zastępują ich.
  • Fragment kodu, który demonstruje problem lub link do repozytorium kodu, które można łatwo ściągnąć na naszą maszynę, aby odtworzyć problem.

Uwaga

Ponieważ musimy skopiować i wkleić fragment kodu, w tym fragment kodu jako plik multimedialny (tj .gif. ) jest niewystarczający.

  • Błędy w konsoli narzędzi deweloperskich (Przełącz > narzędzia deweloperskie)

Pamiętaj, aby wykonać następujące czynności:

  • Przeszukaj repozytorium problemów, aby sprawdzić, czy ten sam problem już istnieje.
  • Uprość kod wokół problemu, abyśmy mogli lepiej odizolować problem.

Nie czuj się źle, jeśli nie możemy odtworzyć problemu i poprosić o więcej informacji!

Jak ustawić poziom rejestrowania

Azure Data Studio

W palecie poleceń (Ctrl/Cmd + Shift + P) uruchom polecenie Developer: Set Log Level... (Deweloper: Ustaw poziom dziennika...), aby wybrać poziom dziennika dla bieżącej sesji. Ta wartość nie jest utrwalana w wielu sesjach. Jeśli uruchomisz ponownie program Azure Data Studio, zostanie przywrócony do poziomu domyślnego Info .

Jeśli chcesz włączyć rejestrowanie debugowania na potrzeby uruchamiania, ustaw poziom dziennika na Debug i uruchom polecenie Developer: Reload Window .

MSSQL (wbudowane rozszerzenie)

Mssql: Log Debug Info Jeśli ustawienie użytkownika ma wartość true, informacje dziennika debugowania są wysyłane do kanału wyjściowegoMSSQL.

Ustawienie Mssql: Tracing Level użytkownika służy do kontrolowania szczegółowości rejestrowania.

Dzienniki i lokalizacja usługi Azure Data Studio

W palecie poleceń (Ctrl/Cmd + Shift + P) uruchom polecenie Deweloper: Otwórz folder dzienników, aby otworzyć ścieżkę do dzienników. Istnieje wiele różnych typów plików dziennika, które tam zapisują. Oto kilka najczęściej używanych:

  1. renderer#.log (na przykład renderer1.log): ten plik jest plikiem dziennika głównego procesu.
  2. telemetry.log: Gdy poziom dziennika jest ustawiony na Tracewartość , ten plik zawiera zdarzenia telemetryczne wysyłane przez program Azure Data Studio
  3. exthost#/exthost.log: plik dziennika dla procesu hosta rozszerzenia (jest to tylko sam proces, a nie rozszerzenia uruchomione wewnątrz niego)
  4. exthost#/Microsoft.mssql: Dzienniki rozszerzenia mssql, które zawiera większość podstawowej logiki dla funkcji związanych z msSQL
    • sqltools.log to dziennik dla usługi SQL Tools
  5. exthost#/output_logging_#######: te foldery zawierają komunikaty wyświetlane w panelu w narzędziu Output Azure Data Studio. Każdy plik ma nazwę #-<Channel Name>. Na przykład Notebooks kanał wyjściowy może być wyjściowy do pliku o nazwie 3-Notebooks.log.

Jeśli zostanie wyświetlony monit o podanie dzienników, spakuj cały folder, aby upewnić się, że zostały uwzględnione poprawne dzienniki.

Odzyskiwanie plików edytora po awarii

Jeśli usługa Azure Data Studio nieoczekiwanie ulegnie awarii, ponowne uruchomienie narzędzia Azure Data Studio powinno również ponownie otworzyć wszystkie niezapisane pliki edytora. Jeśli tak nie jest, być może wystąpił błąd podczas próby ich ponownego otwarcia. W takim przypadku wykonaj następujące kroki, aby przejść do folderu zawierającego kopie zapasowe, w którym można ręcznie otworzyć je w celu odzyskania ich zawartości.

  1. W palecie poleceń (Ctrl/Cmd + Shift + P) uruchom polecenie Developer: Open User Data Folder (Deweloper: Otwórz folder danych użytkownika).
  2. W wyświetlonym folderze przejdź do Backups folderu .

Zawiera to foldery z losowo wygenerowanymi nazwami. W tych folderach znajdują się pliki zawierające kopie zapasowe edytora (które zawierają dodatkowe metadane wraz z zawartością tekstu).

Następne kroki