13.4 MySQL Shell SQL Logging — MySQL Shell 9.2

13.4 Ведение журнала SQL в MySQL Shell

Вы можете регистрировать все SQL-запросы, выполняемые командами или утилитами MySQL Shell, в файле журнала MySQL Shell.

Примечание

logSql заменяет dba.logSql, если dba.logSql отключено, logSql имеет приоритет. Однако, если dba.logSql включено, оно имеет приоритет над logSql, но только для сообщений журнала в контексте dba.*.

Уровень ведения журнала приложения должен быть установлен как минимум на INFO (5), чтобы эти сообщения записывались в журнал MySQL Shell.

Параметры ведения журнала SQL

Ведение журнала SQL MySQL Shell может быть включено, отключено или изменено одним из следующих способов:

Командная строка: --log-sql=logOption в вашей командной строке запуска MySQL Shell.
Параметры конфигурации MySQL Shell: shell.options['logSql']='logOption' во время вашей сессии MySQL Shell.

Доступны следующие параметры:

off: Сообщения SQL MySQL Shell не регистрируются.
error: (По умолчанию) регистрируются только неуспешные SQL-запросы MySQL Shell.
on: Регистрируются все SQL-запросы MySQL Shell, за исключением тех, которые соответствуют шаблону игнорирования, определенному в logSql.ignorePattern и logSql.ignorePatternUnsafe. Дополнительную информацию см. в разделе Фильтрация ведения журнала SQL.
all: Регистрируются все SQL-запросы MySQL Shell, за исключением тех, которые соответствуют шаблону игнорирования, определенному в logSql.ignorePatternUnsafe]. Дополнительную информацию см. в разделе Фильтрация ведения журнала SQL.
unfiltered: Все SQL-запросы MySQL Shell регистрируются, никакая фильтрация не выполняется.

Фильтрация ведения журнала SQL

Журнал фильтруется с помощью списка шаблонов glob, разделенных двоеточием. Доступны следующие параметры:

logSql.ignorePattern: Этот параметр определяет список шаблонов заявок, разделенных двоеточием, для фильтрации. Значение по умолчанию — *SELECT*:*SHOW*.
logSql.ignorePatternUnsafe: Этот параметр определяет список шаблонов заявок, разделенных двоеточием, для фильтрации. Значение по умолчанию — *IDENTIFIED*:*PASSWORD*.

Дополнительную информацию о работе с shell.options см. в разделе Раздел 14.4, «Настройка параметров MySQL Shell».

Формат журнала

Сообщения журнала используют следующий формат:

Date&Time: LogLevel: LogContext: tid= : SQL:

Дата и время

Дата и время сообщения журнала.

Уровень журнала

Уровень журнала. Дополнительную информацию об уровнях журнала см. в таблице Таблица 13.1, «Уровни регистрации в MySQL Shell».

Все успешные SQL-запросы и сообщения об ошибках для неуспешных запросов регистрируются с уровнем журнала INFO.

Контекст журнала

Источник сообщения журнала. Может иметь одно из следующих значений:

main: базовый контекст MySQL Shell.
sql: контекст режима SQL.
js: контекст режима JavaScript.
py: контекст режима Python.
object.method: контекст метода глобального объекта. Например, Dba.createCluster или Cluster.status.

tid

Идентификатор потока MySQL.

SQL

Зарегистрированный SQL-запрос или сообщение об ошибке.

Следующий пример показывает сообщение SQL INFO с контекстом Dba.deploySandboxInstance:

        2022-06-17 15:06:00: Info: Dba.deploySandboxInstance: tid=9: SQL: SET SESSION `autocommit` = 1