13.1 Working With Startup Scripts — MySQL Shell 8.4

13.1 Работа с файлами автозагрузки

При запуске MySQL Shell в режиме JavaScript или Python, а также при первом переключении в режим JavaScript или Python, MySQL Shell ищет файлы автозагрузки для выполнения. Файлы автозагрузки — это специфичные для JavaScript или Python скрипты, содержащие инструкции, которые должны выполняться при первом входе в MySQL Shell в соответствующий режим языка. Файлы автозагрузки позволяют настраивать среду выполнения кода JavaScript или Python следующими способами:

Добавление дополнительных путей поиска для модулей Python или JavaScript.
Определение глобальных функций или переменных.
Выполнение любой другой возможной инициализации через JavaScript или Python.

Соответствующий файл автозагрузки загружается при запуске или перезапуске MySQL Shell в режиме JavaScript или Python, а также при первом переключении на другой из этих режимов во время работы MySQL Shell. После этого MySQL Shell больше не ищет файлы автозагрузки, поэтому для внесения обновлений в файл автозагрузки требуется перезапуск MySQL Shell, если соответствующий режим уже активирован. При запуске MySQL Shell в режиме SQL или переключении в этот режим файл автозагрузки не загружается.

Файлы автозагрузки являются необязательными, и вы можете создать их, если хотите использовать их для настройки. Имена файлов автозагрузки должны быть следующими:

Для режима JavaScript: mysqlshrc.js
Для режима Python: mysqlshrc.py

Вы можете разместить файлы автозагрузки в любом из указанных ниже расположений. MySQL Shell ищет все указанные пути в указанном порядке, чтобы найти файлы автозагрузки с именем mysqlshrc и расширением, соответствующим режиму скриптов, который инициализируется (.js по умолчанию, если MySQL Shell запущен без указания режима языка). Обратите внимание, что MySQL Shell выполняет все соответствующие файлы автозагрузки, найденные для режима скриптов, в порядке их нахождения. Если что-то определено в двух разных файлах автозагрузки, приоритет имеет скрипт, выполняемый позже.

В стандартном глобальном пути конфигурации платформы.
- В Windows: %PROGRAMDATA%\MySQL\mysqlsh\mysqlshrc.[js|py]
- В Unix: /etc/mysql/mysqlsh/mysqlshrc.[js|py]
В подкаталоге share/mysqlsh папки домашнего каталога MySQL Shell, который может быть определен переменной окружения MYSQLSH_HOME или определён MySQL Shell. Если MYSQLSH_HOME не определена, MySQL Shell определяет свою домашнюю папку как родительскую папку папки, названной bin, которая содержит двоичный файл mysqlsh, если такая папка существует. (Для многих стандартных установок нет необходимости определять MYSQLSH_HOME.)
- В Windows: %MYSQLSH_HOME%\share\mysqlsh\mysqlshrc.[js|py]
- В Unix: $MYSQLSH_HOME/share/mysqlsh/mysqlshrc.[js|py]
В папке, содержащей двоичный файл mysqlsh, но только если домашняя папка MySQL Shell, описанная в пункте 2, не указана и не определена MySQL Shell в ожидаемом стандартном расположении.
- В Windows: <mysqlsh binary path>\mysqlshrc.[js|py]
- В Unix: <mysqlsh binary path>/mysqlshrc.[js|py]
В пути конфигурации пользователя MySQL Shell, определенном переменной окружения MYSQLSH_USER_CONFIG_HOME.
- В Windows: %MYSQLSH_USER_CONFIG_HOME%\mysqlshrc.[js|py]
- В Unix: $MYSQLSH_USER_CONFIG_HOME/mysqlshrc.[js|py]
В стандартном пути конфигурации пользователя платформы, но только если путь конфигурации пользователя MySQL Shell, описанный в пункте 4, не указан.
- В Windows: %APPDATA%\MySQL\mysqlsh\mysqlshrc.[js|py]
- В Unix: $HOME/.mysqlsh/mysqlshrc.[js|py]