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

Это важно

Azure Data Studio снимается с эксплуатации по состоянию на 28 февраля 2026 года. Вам следует перейти на Visual Studio Code. Дополнительные сведения см. в статье "Что происходит с 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 .

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

Дальнейшие шаги