2.3.3.5 MySQL Installer Console Reference — MySQL 5.7

2.3.3.5 Справочник по консоли MySQL Installer

MySQLInstallerConsole.exe предоставляет функциональность командной строки, аналогичную MySQL Installer. Этот справочник включает:

Консоль устанавливается при первоначальном запуске MySQL Installer и затем доступна в каталоге MySQL Installer for Windows. По умолчанию, местоположение каталога — C:\Program Files (x86)\MySQL\MySQL Installer for Windows. Необходимо запускать консоль от имени администратора.

Чтобы использовать консоль:

Откройте командную строку с правами администратора, выбрав Системные средства Windows из меню Пуск, затем щелкните правой кнопкой мыши Командная строка, выберите Дополнительные параметры и выберите Запустить от имени администратора.
Из командной строки, необязательно, измените каталог на расположение файла MySQLInstallerConsole.exe. Например, чтобы использовать расположение по умолчанию:
```
cd Program Files (x86)\MySQL\MySQL Installer for Windows
```

Введите MySQLInstallerConsole.exe (или mysqlinstallerconsole), а затем действие команды для выполнения задачи. Например, чтобы отобразить справку по консоли:

MySQLInstallerConsole.exe --help

=================== Start Initialization ===================
MySQL Installer is running in Community mode

Attempting to update manifest.
Initializing product requirements.
Loading product catalog.
Checking for product packages in the bundle.
Categorizing product catalog.
Finding all installed packages.
Your product catalog was last updated at 23/08/2022 12:41:05 p. m.
Your product catalog has version number 671.
=================== End Initialization ===================

The following actions are available:

Configure - Configures one or more of your installed programs.
Help      - Provides list of available command actions.
Install   - Installs and configures one or more available MySQL programs.
List      - Lists all available MySQL products.
Modify    - Modifies the features of installed products.
Remove    - Removes one or more products from your system.
Set       - Configures the general options of MySQL Installer.
Status    - Shows the status of all installed products.
Update    - Updates the current product catalog.
Upgrade   - Upgrades one or more of your installed programs.

The basic syntax for using MySQL Installer command actions. Brackets denote optional entities.
Curly braces denote a list of possible entities.

...

Имена продуктов MySQL

Многие действия команд MySQLInstallerConsole принимают одну или несколько сокращенных фраз, которые могут соответствовать продукту (или продуктам) MySQL в каталоге. Текущий набор допустимых сокращений для использования с командами показан в следующей таблице.

Примечание

Начиная с MySQL Installer 1.6.7 (8.0.34), опции команд install, list и upgrade больше не применяются к MySQL для Visual Studio (теперь EOL), MySQL Connector/NET, MySQL Connector/ODBC, MySQL Connector/C++, MySQL Connector/Python и MySQL Connector/J. Чтобы установить более новые коннекторы MySQL, посетите https://dev.mysql.com/downloads/.

Таблица 2.6 Фразы продуктов MySQL для использования с командой MySQLInstallerConsole.exe

Таблица 2.6 Фразы продуктов MySQL для использования с командой MySQLInstallerConsole.exe
Фраза	Продукт MySQL
`server`	MySQL Server
`workbench`	MySQL Workbench
`shell`	MySQL Shell
`visual`	MySQL для Visual Studio
`router`	MySQL Router
`backup`	MySQL Enterprise Backup (требуется коммерческая версия)
`net`	MySQL Connector/NET
`odbc`	MySQL Connector/ODBC
`c++`	MySQL Connector/C++
`python`	MySQL Connector/Python
`j`	MySQL Connector/J
`documentation`	Документация MySQL Server
`samples`	Примеры MySQL (базы данных sakila и world)

Синтаксис команд

Команда MySQLInstallerConsole.exe может быть введена с расширением файла (.exe) или без него, и регистр символов в команде не учитывается.

mysqlinstallerconsole[.exe] [[[--]action] [action_blocks_list] [options_list]]

Описание:

action

Одно из разрешенных действий. Если опущено, по умолчанию выполняется действие --status. Использование префикса -- для всех действий необязательно.

Возможные действия: [--]configure, [--]help, [--]install, [--]list, [--]modify, [--]remove, [--]set, [--]status, [--]update и [--]upgrade.

action_blocks_list

Список блоков, каждый из которых представляет собой различные элементы в зависимости от выбранного действия. Блоки разделены запятыми.

Действия --remove и --upgrade позволяют указать символ звездочки (*) для указания всех продуктов. Если символ * обнаруживается в начале этого блока, предполагается, что все продукты должны быть обработаны, и остальная часть блока игнорируется.

Синтаксис: *|action_block[,action_block][,action_block]...

action_block: Содержит селектор продукта, за которым следует неопределенное количество блоков аргументов, поведение которых отличается в зависимости от выбранного действия (см. Действия команд).

options_list

Нулевые или более опций с возможными значениями, разделенными пробелами. См. Действия команд, чтобы определить разрешенные опции для соответствующего действия.

Синтаксис: option_value_pair[ option_value_pair][ option_value_pair]...

option_value_pair: Одна опция (например, --silent) или кортеж ключа и соответствующего значения с префиксом опций. Пара ключ-значение имеет вид --key[=value].

Действия команд

MySQLInstallerConsole.exe поддерживает следующие действия команд:

Примечание

Значения блока конфигурации (или arguments_block), содержащие двоеточие (:), должны быть заключены в кавычки. Например, install_dir="C:\MySQL\MySQL Server 8.0".

END_OF_DOCUMENT_MARKER

[--]configure [product1]:[configuration_argument]=[value], [product2]:[configuration_argument]=[value], [...]

Настраивает один или несколько продуктов MySQL на вашей системе. Для каждого продукта можно настроить несколько пар configuration_argument=value.

Параметры:

--continue

Продолжает обработку следующего продукта, если при обработке блоков действий, содержащих аргументы для каждого продукта, возникла ошибка. Если не указано, вся операция прерывается в случае ошибки.

--help

Отображает параметры и доступные аргументы для соответствующего действия. Если указан, действие не выполняется, отображается только справка, поэтому другие параметры, связанные с действием, также игнорируются.

--show-settings

Отображает доступные параметры для выбранного продукта, передав имя продукта после --show-settings.

--silent

Отключает запросы подтверждения.

Примеры:
```
MySQLInstallerConsole --configure --show-settings server
```
```
mysqlinstallerconsole.exe --configure server:port=3307
```
[--]help

Отображает сообщение справки с примерами использования и затем завершает работу. Передайте дополнительное действие команды для получения справки, специфичной для этого действия.

Параметры:

--action=[action]

Отображает справку по конкретному действию. То же самое, что и использование параметра --help с действием.

Допустимые значения: all, configure, help (по умолчанию), install, list, modify, remove, status, update, upgrade и set.

--help

Отображает параметры и доступные аргументы для соответствующего действия. Если указан, действие не выполняется, отображается только справка, поэтому другие параметры, связанные с действием, также игнорируются.

Примеры:
```
MySQLInstallerConsole help
```
```
MySQLInstallerConsole help --action=install
```
[--]install [product1]:[features]:[config block]:[config block], [product2]:[config block], [...]

Устанавливает один или несколько продуктов MySQL на вашей системе. Если доступны продукты предварительной версии, как GA, так и предварительные продукты устанавливаются, когда значение параметра --type равно Client или Full. Используйте параметр --only_ga_products, чтобы ограничить набор продуктов только продуктами GA при использовании этих типов установок.

Описание:

[product]

Каждый продукт можно указать с помощью фразы продукта с или без разделителя версий, разделенных точкой с запятой. Передача только ключевого слова продукта выбирает последнюю версию продукта. Если для этой версии продукта доступно несколько архитектур, команда возвращает первую в списке манифеста для интерактивного подтверждения. Кроме того, можно указать точную версию и архитектуру (x86 или x64) после ключевого слова продукта, используя параметр --silent.

[features]

По умолчанию устанавливаются все функции, связанные с продуктом MySQL. Блок функций — это список функций, разделённых точкой с запятой, или символ звёздочки (*), который выбирает все функции. Чтобы удалить функцию, используйте команду modify.

[config block]

Можно указать один или несколько блоков конфигурации. Каждый блок конфигурации — это список пар ключ-значение, разделённых точкой с запятой. Блок может содержать ключ типа config или user; config — тип по умолчанию, если не определён другой.

Значения блоков конфигурации, содержащие символ двоеточия (:), должны быть заключены в кавычки. Например, installdir="C:\MySQL\MySQL Server 8.0". Для каждого продукта может быть определён только один блок типа конфигурации. Для каждого пользователя, который должен быть создан во время установки продукта, должен быть определён блок пользователя.

Примечание

Ключ типа user не поддерживается при переконфигурации продукта.

Параметры:

--auto-handle-prereqs

При наличии MySQL Installer пытается загрузить и установить некоторые предварительные требования к программному обеспечению, которые в настоящее время отсутствуют и могут быть решены с минимальным вмешательством. Если параметр --silent не указан, вам будут представлены страницы установки для каждого предварительного требования. Если параметр --auto-handle-prereqs опущен, пакеты с отсутствующими предварительными требованиями не устанавливаются.

--continue

Продолжает обработку следующего продукта, если при обработке блоков действий, содержащих аргументы для каждого продукта, возникла ошибка. Если не указано, вся операция прерывается в случае ошибки.

--help

Отображает параметры и доступные аргументы для соответствующего действия. Если указан, действие не выполняется, отображается только справка, поэтому другие параметры, связанные с действием, также игнорируются.

--mos-password=password

Устанавливает пароль пользователя My Oracle Support (MOS) для коммерческих версий MySQL Installer.

--mos-user=user_name

Указывает имя пользователя My Oracle Support (MOS) для доступа к коммерческой версии MySQL Installer. Если не указано, доступны только продукты в пакете (если таковой имеется).

--only-ga-products

Ограничивает набор продуктов, включая только продукты GA.
--setup-type=setup_type
Устанавливает предварительно заданный набор программного обеспечения. Тип установки может быть одним из следующих:
Server: Устанавливает отдельный сервер MySQL

Client: Устанавливает клиентские программы и библиотеки (исключая коннекторы MySQL)

Full: Устанавливает всё (исключая коннекторы MySQL)

Custom: Устанавливает выбранные пользователем продукты. Это значение по умолчанию.
Примечание

Ненастраиваемые типы установки допустимы только в случае, если другие продукты MySQL не установлены.
--show-settings

Отображает доступные параметры для выбранного продукта, передав имя продукта после -showsettings.

--silent

Отключить запросы подтверждения.

Примеры:
```
mysqlinstallerconsole.exe --install j;8.0.29, net;8.0.28 --silent
```
```
MySQLInstallerConsole install server;8.0.30:*:port=3307;server_id=2:type=user;user=foo
```
Пример, в котором передаются дополнительные блоки конфигурации, разделённые ^ для удобства:
```
MySQLInstallerConsole --install server;8.0.30;x64:*:type=config;open_win_firewall=true; ^
   general_log=true;bin_log=true;server_id=3306;tcp_ip=true;port=3306;root_passwd=pass; ^
   install_dir="C:\MySQL\MySQL Server 8.0":type=user;user_name=foo;password=bar;role=DBManager
```
[--]list

При использовании этого действия без параметров активируется интерактивный список, в котором можно искать все доступные продукты MySQL. Введите MySQLInstallerConsole --list и укажите подстроку для поиска.

Параметры:

--all

Перечисляет все доступные продукты. Если этот параметр используется, все остальные параметры игнорируются.

--arch=architecture

Перечисляет продукты, содержащие указанную архитектуру. Допустимые значения: x86, x64 и any (по умолчанию). Этот параметр можно комбинировать с параметрами --name и --version.

--help

Отображает параметры и доступные аргументы для соответствующего действия. Если указан, действие не выполняется, отображается только справка, поэтому другие параметры, связанные с действием, также игнорируются.

--name=package_name

Перечисляет продукты, содержащие указанное имя (см. фраза продукта). Этот параметр можно комбинировать с параметрами --version и --arch.

--version=version

Перечисляет продукты, содержащие указанную версию, например, 8.0 или 5.7. Этот параметр можно комбинировать с параметрами --name и --arch.

Примеры:
```
MySQLInstallerConsole --list --name=net --version=8.0
```
[--]modify [product1:-removelist|+addlist], [product2:-removelist|+addlist] [...]

Изменяет или отображает функции ранее установленного продукта MySQL. Чтобы отобразить функции продукта, добавьте ключевое слово продукта к команде, например:
```
MySQLInstallerConsole --modify server
```
Параметры:

--help

Отображает параметры и доступные аргументы для соответствующего действия. Если указан, действие не выполняется, отображается только справка, поэтому другие параметры, связанные с действием, также игнорируются.

--silent

Отключить запросы подтверждения.

Примеры:
```
MySQLInstallerConsole --modify server:+documentation
```
```
MySQLInstallerConsole modify server:-debug
```

Удаление одного или нескольких продуктов из вашей системы. Звездочка (*) может быть передана для удаления всех продуктов MySQL одной командой.

Параметры:

--continue

Продолжить операцию, даже если возникнет ошибка.

--help

Показать параметры и доступные аргументы для соответствующего действия. Если параметр присутствует, действие не выполняется, а отображается только справка, поэтому и другие параметры, связанные с действием, игнорируются.

--keep-datadir

Пропустить удаление каталога данных при удалении продуктов MySQL Server.

--silent

Отключить запросы подтверждения.

Примеры:
```
mysqlinstallerconsole.exe remove *
```
```
MySQLInstallerConsole --remove server --continue
```
Настройка одного или нескольких настраиваемых параметров, влияющих на то, как программа MySQL Installer подключается к интернету и активирована ли функция автоматического обновления каталога продуктов.

Параметры:
--catalog-update=bool_value

Включить (true, по умолчанию) или отключить (false) автоматическое обновление каталога продуктов. Этот параметр требует активного подключения к интернету.

--catalog-update-days=int_value

Принимает целое число от 1 (по умолчанию) до 365, указывающее количество дней между проверками наличия нового обновления каталога при запуске MySQL Installer. Если --catalog-update равен false, этот параметр игнорируется.

--connection-validation=validation_type

Устанавливает способ, которым MySQL Installer выполняет проверку подключения к интернету. Разрешенные значения — automatic (по умолчанию) и manual.

--connection-validation-urls=url_list

Строка, заключённая в двойные кавычки и разделённая запятыми, которая определяет список URL-адресов для проверки подключения к интернету, когда --connection-validation установлено в manual. Проверки выполняются в том же порядке, в котором они предоставлены. Если первый URL-адрес не отвечает, используется следующий URL-адрес в списке и так далее.

--offline-mode=bool_value
Разрешает MySQL Installer работать с или без интернет-подключения. Допустимые режимы:
True для включения автономного режима (работа без подключения к интернету).

False (по умолчанию) для отключения автономного режима (работа с подключением к интернету). Установите этот режим перед загрузкой каталога продуктов или любых продуктов для установки.
--proxy-mode
Указывает режим прокси. Допустимые режимы:
Automatic для автоматического определения прокси на основе настроек системы.

None для обеспечения того, что прокси не настроен.

Manual для ручной настройки параметров прокси (--proxy-server, --proxy-port, --proxy-username, --proxy-password).
--proxy-password
Пароль, используемый для аутентификации на сервере прокси.

--proxy-port
Порт, используемый сервером прокси.

--proxy-server
URL-адрес сервера прокси.

--proxy-username
Имя пользователя, используемое для аутентификации на сервере прокси.

--reset-defaults
Сброс параметров MySQL Installer, связанных с действием --set, до значений по умолчанию.
Примеры:
```
MySQLIntallerConsole.exe set --reset-defaults
```
```
mysqlintallerconsole.exe --set --catalog-update=false
```
```
MySQLIntallerConsole --set --catalog-update-days=3
```
```
mysqlintallerconsole --set --connection-validation=manual
--connection-validation-urls="https://www.bing.com,http://www.google.com"
```
Быстрый обзор установленных на системе продуктов MySQL. Информация включает имя и версию продукта, архитектуру, дату установки и расположение установки.

Параметры:

--help

Показать параметры и доступные аргументы для соответствующего действия. Если параметр присутствует, действие не выполняется, а отображается только справка, поэтому и другие параметры, связанные с действием, игнорируются.

Примеры:
```
MySQLInstallerConsole status
```
Загрузка последнего каталога продуктов MySQL на вашу систему. При успехе каталог применяется при следующем запуске либо MySQLInstaller, либо MySQLInstallerConsole.exe.

MySQL Installer автоматически проверяет наличие обновлений каталога продуктов при запуске, если прошло n дней с момента последней проверки. Начиная с MySQL Installer 1.6.4, значение по умолчанию составляет 1 день. Ранее значение по умолчанию было 7 дней.

Параметры:

--help

Показать параметры и доступные аргументы для соответствующего действия. Если параметр присутствует, действие не выполняется, а отображается только справка, поэтому и другие параметры, связанные с действием, игнорируются.

Примеры:
```
MySQLInstallerConsole update
```
Обновление одного или нескольких продуктов в вашей системе. Для этого действия разрешены следующие символы:

*

Передайте * для обновления всех продуктов до последней версии или передайте конкретные продукты.

!

Передайте ! в качестве номера версии для обновления продукта MySQL до последней версии.

Параметры:

--continue

Продолжить операцию, даже если возникнет ошибка.

--help

Показать параметры и доступные аргументы для соответствующего действия. Если параметр присутствует, действие не выполняется, а отображается только справка, поэтому и другие параметры, связанные с действием, игнорируются.

--mos-password=password

Устанавливает пароль пользователя My Oracle Support (MOS) для коммерческих версий MySQL Installer.

--mos-user=user_name

Указывает имя пользователя My Oracle Support (MOS) для доступа к коммерческой версии MySQL Installer. Если параметр отсутствует, доступны только продукты в пакете (если таковой имеется).

--silent

Отключить запросы подтверждения.

Примеры:
```
MySQLInstallerConsole upgrade *
```
```
MySQLInstallerConsole upgrade workbench:8.0.31
```
```
MySQLInstallerConsole upgrade workbench:!
```
```
MySQLInstallerConsole --upgrade server;8.0.30:!, j;8.0.29:!
```