Бөлісу құралы:

Устранение неполадок Azure Data Studio

  • Мақала

Azure Data Studio отслеживает проблемы и запросы функций с помощью средства отслеживания проблем репозитория GitHub для репозитория azuredatastudio.

Сообщите о проблеме, которую вы столкнулись

Сообщите о проблемах в GitHub Issue Tracker и сообщите нам о любых сведениях, которые помогут воспроизвести ошибку. Включите в отчет информацию из файлов журнала.

Написание хороших отчетов об ошибках и запросов функций

В каждом отчете описывайте только одну ошибку, а в каждом запросе — одну функцию.

  • Не объединяйте несколько ошибок или запросов функций.
  • Не добавляйте проблему в качестве комментария к существующей проблеме, если в ней не используются такие же входные данные. Многие проблемы выглядят схожими, но имеют различные причины.

Чем больше информации вы можете предоставить, тем выше вероятность, что удастся воспроизвести проблему и найти для нее решение.

К каждому сообщению о проблеме добавляйте следующую информацию:

  • Версия Azure Data Studio.
  • Воспроизводимые шаги (1... 2... 3...) и то, что вы ожидали против того, что вы на самом деле видели.
  • Включите изображения, анимации или ссылки на видео. Изображения и анимации иллюстрируют шаги воспроизведения, но не заменяют их.
  • Фрагмент кода, демонстрирующий ошибку, или ссылка на репозиторий кода, из которого мы сможем получить на наш компьютер код, позволяющий воссоздать эту проблему.

Примечание.

Так как нам нужно скопировать и вставить фрагмент кода, включая фрагмент кода в виде файла мультимедиа (то есть .gif), недостаточно.

  • Ошибки в консоли средств разработки (справка > по переключениям средств разработчика)

Не забудьте выполнить следующие действия.

  • Выполните поиск в репозитории проблем, чтобы узнать, существует ли та же проблема.
  • Упростите код, связанный с проблемой, чтобы мы могли лучше изолировать проблему.

Возможно, сразу нам не удастся воспроизвести ошибку и мы запросим дополнительные сведения.

Настройка уровня ведения журнала

Azure Data Studio

В палитре команд (CTRL/CMD+ SHIFT+P) выполните команду разработчика: задать уровень журнала... чтобы выбрать уровень журнала для текущего сеанса. Это значение не сохраняется в нескольких сеансах. При перезапуске Azure Data Studio он отменить изменения обратно на уровень по умолчаниюInfo.

Если вы хотите включить ведение журнала отладки для запуска, установите уровень Debug журнала и выполните команду "Разработчик: перезагрузить окно ".

MSSQL (встроенное расширение)

Mssql: Log Debug Info Если для параметра пользователя задано значение true, отладочная информация журнала отправляется в выходной MSSQL канал.

Пользовательский параметр Mssql: Tracing Level управляет уровнем детализации для ведения журнала.

Журналы и расположение Azure Data Studio

В палитре команд (CTRL/CMD+ SHIFT+P) выполните команду разработчика: откройте папку журналов, чтобы открыть путь к журналам. Существует множество различных типов файлов журналов, которые записывают там. Некоторые из часто используемых:

  1. renderer#.log (например, renderer1.log): этот файл является файлом журнала для основного процесса.
  2. telemetry.log: если задан Traceуровень журнала, этот файл содержит события телеметрии, отправленные Azure Data Studio.
  3. exthost#/exthost.log: файл журнала для процесса узла расширения (это только сам процесс, а не расширения, выполняемые внутри него)
  4. exthost#/Microsoft.mssql: журналы для расширения mssql, который содержит большую часть основной логики для функций, связанных с MSSQL
    • sqltools.log — это журнал для службы sql Tools
  5. exthost#/output_logging_#######: эти папки содержат сообщения, отображаемые на Output панели в Azure Data Studio. Каждый файл называется #-<Channel Name>. Например, выходной Notebooks канал может выводиться в файл с именем 3-Notebooks.log.

Если вам будет предложено предоставить журналы, запакуйте всю папку, чтобы убедиться, что включены правильные журналы.

Восстановление файлов редактора после сбоя

Если Azure Data Studio неожиданно завершается сбоем, перезапуск Azure Data Studio также должен повторно открыть все несохраненные файлы редактора. Если они этого не сделали, возможно, возникла ошибка, пытающаяся повторно открыть их. В этом случае выполните следующие действия, чтобы перейти к папке, содержащей резервные копии, где их можно вручную открыть для восстановления содержимого.

  1. В палитре команд (CTRL/CMD+ SHIFT+P) выполните команду разработчика: открыть папку данных пользователя.
  2. В открывающейся папке перейдите к папке Backups .

Это содержит папки со случайным образом созданными именами. В этих папках находятся файлы, содержащие резервные копии редактора (которые включают некоторые дополнительные метаданные вместе с их текстовым содержимым).

Следующие шаги