7.5.9.1 Option Tracker Tables — MySQL 9.2

7.5.9.1 Таблицы отслеживания параметров

Модуль отслеживания параметров предоставляет информацию о параметрах в виде двух таблиц, перечисленных здесь:

performance_schema.mysql_option: Для каждого параметра, реализованного компонентом или плагином, установленным в системе, эта таблица Performance Schema показывает имя параметра, имя компонента или плагина, предоставляющего связанную функцию, и является ли эта функция в настоящее время включённой. Эта таблица устанавливается выполнением INSTALL COMPONENT 'file://component_option_tracker'.

Эта таблица, как и другие таблицы Performance Schema, является только для чтения и, следовательно, не может быть обновлена или усечена пользователями.

См. раздел 29.12.22.6, «Таблица mysql_option» для более подробной информации об этой таблице, такой как столбцы и их возможные значения.
mysql_option.option_usage: Показывает для каждого установленного параметра имя связанной функции, данные об использовании функции в формате JSON и другую информацию. Эта таблица устанавливается выполнением SQL-скрипта option_tracker_install.sql и удаляется выполнением option_tracker_uninstall.sql, оба находятся в каталоге MySQL share.

Эта таблица может быть читаемой и изменяемой. Для обновления таблицы option_usage требуется привилегия OPTION_TRACKER_UPDATER.

Более подробная информация об этой таблице приведена далее в этом разделе.

Важно

INSTALL COMPONENT 'file://component_option_tracker' устанавливает библиотеку компонента и таблицу Performance Schema mysql_option, но не устанавливает таблицу mysql_option.option_usage, для чего требуется выполнить скрипт установки, находящийся в каталоге MySQL Server share, как описано в следующих абзацах.

Для выполнения полной установки компонента отслеживания параметров выполните скрипт установки из командной оболочки следующим образом:

$> mysql -uusername -ppassword < path/to/option_tracker_install.sql

(Возможно, вам понадобятся дополнительные параметры, такие как -h, для клиента mysql при выполнении скрипта установки в этом случае, в зависимости от обстоятельств.)

В качестве альтернативы, вы можете выполнить скрипт из сеанса клиента MySQL, используя команду source или \., как показано здесь:

mysql> source path/to/option_tracker_install.sql

mysql> \. path/to/option_tracker_install.sql

Путь является относительным к каталогу, в котором запускается клиент mysql.

Дополнительную информацию см. в разделе 6.5.1.5, «Выполнение SQL-запросов из текстового файла».

Таблица mysql_option.option_usage предоставляет информацию об использовании параметров, доступных в MySQL Server, компонентах и плагинах:

mysql> TABLE mysql_option.option_usage\G
*************************** 1. row ***************************
 CLUSTER_ID:
  SERVER_ID:
OPTION_NAME: JavaScript Library
 USAGE_DATA: {"used": false, "usedDate": "2025-01-13T17:08:31Z"}
*************************** 2. row ***************************
 CLUSTER_ID:
  SERVER_ID:
OPTION_NAME: JavaScript Stored Program
 USAGE_DATA: {"used": false, "usedDate": "2025-01-13T17:08:31Z"}

Таблица option_usage имеет следующие столбцы:

CLUSTER_ID

UUID кластера репликации MySQL Group, к которому принадлежит этот сервер. В настоящее время оставлен пустым.
SERVER_ID

UUID сервера, если он является частью кластера репликации MySQL Group. В настоящее время оставлен пустым.
OPTION_NAME

Уникальное имя функции.
USAGE_DATA

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

В этой таблице есть первичный ключ по столбцам CLUSTER_ID, SERVER_ID и OPTION_NAME. Значение столбца OPTION_NAME в этой таблице для данного параметра совпадает со значением столбца OPTION_NAME для той же функции в таблице performance_schema.mysql_option. Таким образом, вы можете объединить эти две таблицы подобно показанному здесь примеру:

mysql> SELECT * FROM performance_schema.mysql_option o
    -> JOIN mysql_option.option_usage u
    -> ON o.OPTION_NAME=u.OPTION_NAME\G
*************************** 1. row ***************************
     OPTION_NAME: JavaScript Library
  OPTION_ENABLED: TRUE
OPTION_CONTAINER: component:mle
      CLUSTER_ID:
       SERVER_ID:
     OPTION_NAME: JavaScript Library
      USAGE_DATA: {"used": false, "usedDate": "2025-01-13T17:08:31Z"}
*************************** 2. row ***************************
     OPTION_NAME: JavaScript Stored Program
  OPTION_ENABLED: TRUE
OPTION_CONTAINER: component:mle
      CLUSTER_ID:
       SERVER_ID:
     OPTION_NAME: JavaScript Stored Program
      USAGE_DATA: {"used": false, "usedDate": "2025-01-13T17:08:31Z"}

В отличие от таблицы Performance Schema mysql_option, таблица option_usage может быть изменяемой и обновляться с помощью SQL-запросов.

В репликации групп данные об использовании параметров берутся из первичного узла. Они не записываются в двоичный журнал и не реплицируются, но распространяются на вторичные узлы с помощью протокола репликации групп. Отдельные реплики могут записывать свои собственные данные об использовании параметров в эту таблицу. Это относится к узлам чтения/записи в кластерах репликации групп; узлы только для чтения не могут записывать в эту таблицу.

Пользовательским учётным записям необходимо предоставить необходимые привилегии для доступа к этой таблице.