12.4 MySQL Shell SQL Logging — MySQL Shell 8.4

12.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 см. в разделе Раздел 13.4, «Настройка параметров MySQL Shell».

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

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

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

Дата и время

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

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

Уровень журнала. Дополнительную информацию об уровнях журнала см. в Таблице 12.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