MySQL 安装指南 / MySQL Installer 控制台参考

第 6 章 MySQL Installer 控制台参考

MySQLInstallerConsole.exe 提供了与 MySQL Installer 类似的命令行功能。本参考包括

控制台在首次执行 MySQL Installer 时安装，然后在 适用于 Windows 的 MySQL Installer 目录中可用。默认情况下，目录位置为 C:\Program Files (x86)\MySQL\适用于 Windows 的 MySQL Installer。您必须以管理员身份运行控制台。

要使用控制台

通过从开始中选择 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 for Visual Studio（现已 EOL）、MySQL Connector/NET、MySQL Connector/ODBC、MySQL Connector/C++、MySQL Connector/Python 和 MySQL Connector/J。要安装更新的 MySQL 连接器，请访问 https://dev.mysqld.com.cn/downloads/。

表 6.1 可与 MySQLInstallerConsole.exe 命令一起使用的 MySQL 产品短语

短语	MySQL 产品
`server`	MySQL 服务器
`MySQL 服务器`	workbench
`MySQL Workbench`	shell
`MySQL Shell`	visual
`MySQL for 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 服务器文档`	samples

MySQL 示例（sakila 和 world 数据库）

命令语法

MySQLInstallerConsole.exe 命令可以使用或不使用文件扩展名（.exe）发出，并且该命令不区分大小写。

mysqlinstallerconsole[.exe] [[[--]操作] [操作块列表] [选项列表]]

描述

操作

允许的操作操作之一。如果省略，则默认操作等效于 --status 操作。所有操作都可以选择使用 -- 前缀。

可能的操作有：[--]configure、[--]help、[--]install、[--]list、[--]modify、[--]remove、[--]set、[--]status、[--]update 和 [--]upgrade。

操作块列表

块列表，其中每个块表示不同的项目，具体取决于所选的操作。块之间用逗号分隔。

--remove 和 --upgrade 操作允许指定星号字符（*）来指示所有产品。如果在此块的开头检测到 * 字符，则假定要处理所有产品，并忽略该块的其余部分。

语法：*|操作块[,操作块][,操作块]...

操作块：包含一个产品选择器，后跟无限数量的参数块，这些参数块的行为因所选操作而异（请参阅命令操作）。

选项列表

零个或多个选项，其中可能的值之间用空格分隔。请参阅命令操作以确定相应操作允许的选项。

语法：选项值对[ 选项值对][ 选项值对]...

`选项值对`：单个选项（例如，`--silent`）或带选项前缀的键值对。键值对的格式为 `--键[=值]`。

命令操作

注意

MySQLInstallerConsole.exe 支持以下命令操作

包含冒号字符（:）的配置块（或 arguments_block）值必须用引号引起来。例如，install_dir="C:\MySQL\MySQL Server 8.0"。
[--]configure [产品 1]:[配置参数]=[值], [产品 2]:[配置参数]=[值], [...]
配置系统上的一个或多个 MySQL 产品。可以为每个产品配置多个 配置参数=值 对。

选项
--continue
在处理包含每个产品的参数的操作块时，如果捕获到错误，则继续处理下一个产品。如果未指定，则在出错时将中止整个操作。
--help
显示相应操作的选项和可用参数。如果存在，则不执行该操作，仅显示帮助，因此其他与操作相关的选项也将被忽略。
--show-settings

通过在 --show-settings 后传入产品名称来显示所选产品的可用选项。
--silent

禁用确认提示。
```
MySQLInstallerConsole --configure --show-settings server
```
```
mysqlinstallerconsole.exe --configure server:port=3307
```
示例
[--]help
配置系统上的一个或多个 MySQL 产品。可以为每个产品配置多个 配置参数=值 对。

显示包含用法示例的帮助消息，然后退出。传入其他命令操作以接收该操作的特定帮助。
--action=[操作]
显示特定操作的帮助。与将 --help 选项与操作一起使用相同。
在处理包含每个产品的参数的操作块时，如果捕获到错误，则继续处理下一个产品。如果未指定，则在出错时将中止整个操作。
--help

禁用确认提示。
```
MySQLInstallerConsole help
```
```
MySQLInstallerConsole help --action=install
```
允许的值有：all、configure、help（默认值）、install、list、modify、remove、status、update、upgrade 和 set。
[--]install [产品 1]:[功能]:[配置块]:[配置块], [产品 2]:[配置块], [...]
mysqlinstallerconsole[.exe] [[[--]操作] [操作块列表] [选项列表]]

在系统上安装一个或多个 MySQL 产品。如果预发布产品可用，则在 --type 选项的值为 Client 或 Full 时，将同时安装 GA 和预发布产品。使用 --only_ga_products 选项可以在使用这些设置类型时将产品集限制为仅 GA 产品。
[产品]

可以使用带有或不带有分号分隔的版本限定符的产品短语来指定每个产品。仅传入产品关键字将选择该产品的最新版本。如果该版本的产品有多个体系结构可用，则该命令将返回清单列表中的第一个以进行交互式确认。或者，您可以在产品关键字后使用 --silent 选项传入确切的版本和体系结构（x86 或 x64）。
[功能]

默认情况下，将安装与 MySQL 产品关联的所有功能。功能块是用分号分隔的功能列表或星号字符（*），用于选择所有功能。要删除功能，请使用 modify 命令。
[配置块]
可以指定一个或多个配置块。每个配置块都是一个用分号分隔的键值对列表。一个块可以包含 config 或 user 类型的键；如果未定义，则 config 为默认类型。

注意

包含冒号字符（:）的配置块值必须用引号引起来。例如，installdir="C:\MySQL\MySQL Server 8.0"。每个产品只能定义一个配置类型块。应为要在产品安装期间创建的每个用户定义一个用户块。

配置系统上的一个或多个 MySQL 产品。可以为每个产品配置多个 配置参数=值 对。

重新配置产品时不支持 user 类型的键。
--auto-handle-prereqs
选项
--continue
在处理包含每个产品的参数的操作块时，如果捕获到错误，则继续处理下一个产品。如果未指定，则在出错时将中止整个操作。
--help
如果存在，MySQL Installer 会尝试下载并安装一些软件先决条件（当前不存在），这些先决条件可以通过最少的干预来解决。如果不存在 --silent 选项，则会为您显示每个先决条件的安装页面。如果省略了 --auto-handle-prereqs 选项，则不会安装缺少先决条件的软件包。
--mos-password=密码
设置商业版 MySQL Installer 的 My Oracle Support (MOS) 用户密码。
--mos-user=用户名
指定 My Oracle Support (MOS) 用户名，用于访问商业版 MySQL Installer。如果不存在，则只能安装捆绑包中的产品（如果有）。
--only-ga-products
将产品集限制为仅包含 GA 产品。
--setup-type=设置类型
服务器：安装单个 MySQL 服务器
客户端：安装客户端程序和库（不包括 MySQL 连接器）
完整：安装所有内容（不包括 MySQL 连接器）
自定义：安装用户选择的产品。这是默认选项。
注意

仅当未安装其他 MySQL 产品时，非自定义设置类型才有效。
显示相应操作的选项和可用参数。如果存在，则不执行该操作，仅显示帮助，因此其他与操作相关的选项也将被忽略。
通过在 -showsettings 后面传入产品名称，显示所选产品的可用选项。

通过在 --show-settings 后传入产品名称来显示所选产品的可用选项。
禁用确认提示。

禁用确认提示。
```
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 并指定要搜索的子字符串。
配置系统上的一个或多个 MySQL 产品。可以为每个产品配置多个 配置参数=值 对。

--all
列出所有可用的产品。如果使用此选项，则忽略所有其他选项。
--arch=体系结构
列出包含指定体系结构的列表。允许的值为：x86、x64 和 any（默认）。此选项可以与 --name 和 --version 选项组合使用。
在处理包含每个产品的参数的操作块时，如果捕获到错误，则继续处理下一个产品。如果未指定，则在出错时将中止整个操作。
--help
--name=软件包名称
列出包含指定名称（请参阅产品短语）的产品，此选项可以与 --version 和 --arch 选项组合使用。
--version=版本
列出包含指定版本（例如 8.0 或 5.7）的产品。此选项可以与 --name 和 --arch 选项组合使用。

禁用确认提示。
```
MySQLInstallerConsole --list --name=net --version=8.0
```
[--]modify [产品 1:-删除列表|+添加列表], [产品 2:-删除列表|+添加列表] [...]
修改或显示先前安装的 MySQL 产品的功能。要显示产品的特性，请将产品关键字追加到命令中，例如
```
MySQLInstallerConsole --modify server
```
配置系统上的一个或多个 MySQL 产品。可以为每个产品配置多个 配置参数=值 对。

在处理包含每个产品的参数的操作块时，如果捕获到错误，则继续处理下一个产品。如果未指定，则在出错时将中止整个操作。
--help
通过在 --show-settings 后传入产品名称来显示所选产品的可用选项。
禁用确认提示。

禁用确认提示。
```
MySQLInstallerConsole --modify server:+documentation
```
```
MySQLInstallerConsole modify server:-debug
```
[--]remove [产品 1], [产品 2] [...]
从系统中删除一个或多个产品。可以传入星号字符 (*) 以使用一个命令删除所有 MySQL 产品。
配置系统上的一个或多个 MySQL 产品。可以为每个产品配置多个 配置参数=值 对。

选项
即使发生错误也继续操作。
在处理包含每个产品的参数的操作块时，如果捕获到错误，则继续处理下一个产品。如果未指定，则在出错时将中止整个操作。
--help
--keep-datadir
删除 MySQL Server 产品时，跳过数据目录的删除。
通过在 --show-settings 后传入产品名称来显示所选产品的可用选项。
禁用确认提示。

禁用确认提示。
```
mysqlinstallerconsole.exe remove *
```
```
MySQLInstallerConsole --remove server --continue
```
[--]set
设置一个或多个可配置选项，这些选项会影响 MySQL Installer 程序连接到 Internet 的方式以及是否激活自动产品目录更新功能。
配置系统上的一个或多个 MySQL 产品。可以为每个产品配置多个 配置参数=值 对。
--catalog-update=布尔值
启用 (true，默认) 或禁用 (false) 自动产品目录更新。此选项需要有效的 Internet 连接。
--catalog-update-days=整数值
接受 1（默认值）到 365 之间的整数，表示启动 MySQL Installer 时检查新目录更新之间的天数。如果 --catalog-update 为 false，则忽略此选项。
--connection-validation=验证类型
设置 MySQL Installer 如何执行 Internet 连接检查。允许的值为 automatic（默认）和 manual。
--connection-validation-urls=url 列表
一个双引号括起来并用逗号分隔的字符串，用于定义在 --connection-validation 设置为 manual 时用于检查 Internet 连接的 URL 列表。检查按提供的相同顺序进行。如果第一个 URL 失败，则使用列表中的下一个 URL，依此类推。
--offline-mode=布尔值
使 MySQL Installer 能够在有或没有 Internet 功能的情况下运行。有效模式为
True 启用离线模式（在没有 Internet 连接的情况下运行）。
False（默认）禁用离线模式（使用 Internet 连接运行）。在下载产品目录或要安装的任何产品之前设置此模式。
--proxy-mode
指定代理模式。有效模式为
Automatic 根据系统设置自动识别代理。
None 确保未配置代理。
Manual 手动设置代理详细信息 (--proxy-server、--proxy-port、--proxy-username、--proxy-password)。
--proxy-password
用于向代理服务器进行身份验证的密码。
--proxy-port
代理服务器使用的端口。
--proxy-server
指向代理服务器的 URL。
--proxy-username
用于向代理服务器进行身份验证的用户名。
--reset-defaults
将与 --set 操作关联的 MySQL Installer 选项重置为默认值。
禁用确认提示。
```
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"
```
[--]status
提供系统上安装的 MySQL 产品的快速概览。信息包括产品名称和版本、体系结构、安装日期和安装位置。
配置系统上的一个或多个 MySQL 产品。可以为每个产品配置多个 配置参数=值 对。

在处理包含每个产品的参数的操作块时，如果捕获到错误，则继续处理下一个产品。如果未指定，则在出错时将中止整个操作。
--help

禁用确认提示。
```
MySQLInstallerConsole status
```
[--]update
将最新的 MySQL 产品目录下载到您的系统。成功后，下次执行 MySQLInstaller 或 MySQLInstallerConsole.exe 时将应用该目录。
如果自上次检查以来已过去 n 天，MySQL Installer 会在启动时自动检查产品目录更新。从 MySQL Installer 1.6.4 开始，默认值为 1 天。以前，默认值为 7 天。
配置系统上的一个或多个 MySQL 产品。可以为每个产品配置多个 配置参数=值 对。

在处理包含每个产品的参数的操作块时，如果捕获到错误，则继续处理下一个产品。如果未指定，则在出错时将中止整个操作。
--help

禁用确认提示。
```
MySQLInstallerConsole update
```
[--]upgrade [产品 1:版本], [产品 2:版本] [...]
升级系统上的一个或多个产品。此操作允许使用以下字符

*
传入 * 将所有产品升级到最新版本，或传入特定产品。
!
传入 ! 作为版本号，将 MySQL 产品升级到其最新版本。

配置系统上的一个或多个 MySQL 产品。可以为每个产品配置多个 配置参数=值 对。

选项
即使发生错误也继续操作。
在处理包含每个产品的参数的操作块时，如果捕获到错误，则继续处理下一个产品。如果未指定，则在出错时将中止整个操作。
--help
如果存在，MySQL Installer 会尝试下载并安装一些软件先决条件（当前不存在），这些先决条件可以通过最少的干预来解决。如果不存在 --silent 选项，则会为您显示每个先决条件的安装页面。如果省略了 --auto-handle-prereqs 选项，则不会安装缺少先决条件的软件包。
--mos-password=密码
设置商业版 MySQL Installer 的 My Oracle Support (MOS) 用户密码。
--mos-user=用户名
通过在 --show-settings 后传入产品名称来显示所选产品的可用选项。
禁用确认提示。

禁用确认提示。
```
MySQLInstallerConsole upgrade *
```
```
MySQLInstallerConsole upgrade workbench:8.0.31
```
```
MySQLInstallerConsole upgrade workbench:!
```
```
MySQLInstallerConsole --upgrade server;8.0.30:!, j;8.0.29:!
```

上一页首页向上

第 6 章 MySQL Installer 控制台参考

MySQL 产品名称

MySQL 示例（sakila 和 world 数据库）

选项值对：单个选项（例如，--silent）或带选项前缀的键值对。键值对的格式为 --键[=值]。

`选项值对`：单个选项（例如，`--silent`）或带选项前缀的键值对。键值对的格式为 `--键[=值]`。