13.3 Настройка приглашения
Приглашение MySQL Shell можно настроить с помощью файлов тем приглашения. Для настройки файла темы приглашения можно установить переменную среды MYSQLSH_PROMPT_THEME со значением имени файла темы приглашения, скопировать файл темы приглашения в каталог ~/.mysqlsh/ на Linux и macOS или в каталог %AppData%\Roaming\MySQL\mysqlsh\ на Windows. Файл должен иметь имя prompt.json, и необходимо перезапустить MySQL Shell, чтобы изменения вступили в силу.
Рисунок 13.1 Приглашение MySQL Shell
Приглашение может состоять из шести частей:
Состояние: Указывает, является ли это производственной системой и не было ли потеряно соединение.
MySQL: Напоминание о работе с базой данных MySQL.
Соединение: Указывает хост, к которому вы подключены, и порт, по которому используется SSL.
Схема: Текущая схема по умолчанию.
Режим: Используемый режим:
JS= JavaScript,PY= Python иSQL= SQL.Конец: Приглашение завершается
>.
Путь к пользовательской конфигурации для каталога mysqlsh, где находится файл prompt.json, можно переопределить на всех платформах, определив переменную среды MYSQLSH_USER_CONFIG_HOME. Значение этой переменной заменяет %AppData%\Roaming\MySQL\mysqlsh\ в Microsoft Windows или ~/.mysqlsh/ в Unix.
В Microsoft Windows файлы тем приглашения находятся в следующем каталоге: %programfiles%\MySQL\MySQL Shell
8.0\share\mysqlsh\prompt\.
В macOS файлы тем приглашения находятся в следующем каталоге: /usr/local/mysql-shell/share/mysqlsh/prompt.
В Linux файлы тем приглашения находятся в следующем каталоге: /usr/share/mysqlsh/prompt/.
Формат файла темы приглашения описан в файле README.prompt. Также включены некоторые примеры файлов тем приглашения, например, prompt_256.json:
В образце темы приглашения prompt_256.json есть объект с классами disconnected%host% и %is_production%. Переменные определены в этом файле или взяты из самого MySQL Shell, например, %host и %port. В этом примере хост включается в переменную среды PRODUCTION_SERVERS.
"variables" : {
"is_production": {
"match" : {
"pattern": "*;%host%;*",
"value": ";%env:PRODUCTION_SERVERS%;"
},
Цвет фона и переднего плана определяются элементами bg и fg. Эти элементы позволяют настроить цвета, используемые в приглашении.
По имени: Используйте цвет, определённый по имени.
По индексу: Используйте значение от 0 до 255 (включительно), где 0 — чёрный, 63 — светло-голубой, 127 — пурпурный, 193 — жёлтый, а 255 — белый.
По RGB: Используйте значение в формате
#rrggbb. Терминал должен поддерживатьTrueColor.
В этом примере используются именованные цвета, с текстовым выводом PRODUCTION, если булевый элемент is_production возвращает TRUE.
"production" : {
"text": " PRODUCTION ",
"bg": "red",
"fg": "white"
}
Эти элементы выводят приглашение в следующем формате:
Рисунок 13.2 Приглашение MySQL Shell
Отображение цвета зависит от поддержки терминала. Большинство терминалов поддерживают 256 цветов в Linux и macOS. В Windows поддержка цвета требует либо сторонней программы-терминала с поддержкой ANSI/VT100-экранов, либо Windows 10. По умолчанию MySQL Shell пытается определить тип терминала и соответствующим образом обрабатывать цвета. Если автоматическое обнаружение не работает для вашего типа терминала или если необходимо изменить режим цвета из-за требований доступности или по другим причинам, вы можете определить переменную среды MYSQLSH_TERM_COLOR_MODE, чтобы принудительно заставить MySQL Shell использовать определённый режим цвета. Возможные значения для этой переменной среды — rgb, 256, 16 и nocolor.
При запуске, если в файле темы приглашения найдена ошибка, выводится сообщение об ошибке, и используется тема приглашения по умолчанию. Некоторые образцы файлов тем приглашения требуют специального шрифта (например, SourceCodePro+Powerline+Awesome+Regular.ttf). Если вы установите переменную окружения MYSQLSH_PROMPT_THEME в пустое значение, MySQL Shell использует минимальное приглашение без цвета.
© 2025 Oracle
Licensed under the GPLv2 License.
