Эта секция объясняет журнал приложения.
MySQL Shell может быть настроен, чтобы произвести файл журнала приложения с информацией о проблемах разной серьезности. Можно использовать эту информацию, чтобы проверить состояние MySQL Shell в процессе работы.
Местоположение файла журнала это пользовательский путь конфигурации,
файл называется mysqlsh.log
.
По умолчанию регистрация отключена. Чтобы позволить регистрировать, надо
применить параметр командной строки
--log-level
, когда MySQL Shell запускается, использовать любую команду
\option
или объект shell.options
,
чтобы установить параметр конфигурации MySQL Shell
logLevel
. Если выбор не установлен в командной
строке или в конфигурационном файле, или если вы определяете уровень 1 или
none
, регистрация отключена. Все другие значения
позволяют регистрироваться и устанавливают уровень детализации в
регистрации следующим образом:
Регистрация: числовой уровень | Регистрация: текст | Значение |
---|---|---|
1 |
|
Ни один, по умолчанию |
2 |
|
Внутренняя ошибка |
3 |
|
Ошибка |
4 |
|
Предупреждение |
5 |
|
Информационный |
6 |
|
Отладка |
7 |
|
Отладка2 |
8 |
|
Отладка3 |
С опцией
--log-level
можно определить уровень, используя его текстовое
название или числовой эквивалент, таким образом, следующие примеры имеют тот
же самый эффект:
shell>mysqlsh --log-level=4
shell>mysqlsh --log-level=warning
С опцией logLevel
можно определить только числовой уровень.
Если вы предварительно определили уровень с @ (знак at), записи в журнале произведены к дополнительному видимому местоположению, а также написаны в файл журнала MySQL Shell. Следующие примеры имеют тот же самый эффект:
shell>mysqlsh --log-level=@8
shell>mysqlsh --log-level=@debug3
На системах Unix записи в журнале произведены в
stderr
в выходном формате, который в настоящее
время устанавливается для MySQL Shell. Это значение опции
resultFormat
, если обертывание JSON не было
активировано запуском MySQL Shell с опцией
--json
.
В Windows записи в журнале печатаются, используя функцию
OutputDebugString()
,
вывод которой может быть рассмотрен в прикладном отладчике, системном
отладчике или инструменте захвата для вывода отладки.
Формат файла журнала MySQL Shell это простой текст, записи содержат метку времени и описание проблемы, наряду с уровнем регистрации из вышеупомянутого списка. Например:
2016-04-05 22:23:01: Error: Default Domain: (shell):1:8: MySQLError: You have an error in your SQL syntax; check the manual that corresponds to your MySQL server version for the right syntax to use near '' at line 1 (1064) in session.sql("select * from t limit").execute().all();
Пользовательский путь конфигурации по умолчанию может быть отвергнут на
всех платформах, определив переменную окружения
MYSQLSH_USER_CONFIG_HOME
.
Значение этой переменной заменяет
%AppData%\MySQL\mysqlsh\
в Windows или
~/.mysqlsh/
в Unix.
В Windows путь по умолчанию к файлу журнала
%APPDATA%\MySQL\mysqlsh\mysqlsh.log
.
Чтобы найти местоположение %APPDATA%
в Вашей системе, введите:
C:>echo %APPDATA%
C:\Users\exampleuser\AppData\Roaming
В Windows это папка %APPDATA%
, определенная
для пользователя, с добавкой MySQL\mysqlsh
.
Используя вышеупомянутый пример, путь был бы
C:\Users\exampleuser\AppData\Roaming\MySQL\mysqlsh\mysqlsh.log
.
Для Unix путь по умолчанию
~/.mysqlsh/mysqlsh.log
, где
~
представляет корневой каталог пользователя. Переменная окружения
HOME
также представляет корневой каталог
пользователя. Добавление .mysqlsh
к корневому каталогу пользователя определяет путь по умолчанию к журналу.