14.1 Working With Startup Scripts — MySQL Shell 9.2

14.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]