MySQL 安装程序指南  /  第 6 章 MySQL 安装程序控制台参考

第 6 章 MySQL 安装程序控制台参考

MySQLInstallerConsole.exe提供类似于 MySQL Installer 的命令行功能。它在最初执行 MySQL Installer 时安装，然后在 MySQL Installer for Windows目录中可用。默认情况下，C:\Program Files (x86)\MySQL\MySQL Installer for Windows控制台命令必须以管理权限执行。

要使用控制台：

  1. 从 “开始”中选择“ Windows 系统”， 打开具有管理权限的命令提示符，然后右键单击“命令提示符”，选择“更多”，然后选择“以管理员身份运行”。

  2. 从命令行中，可选择将目录更改为MySQLInstallerConsole.exe命令所在的目录。例如，要使用默认安装位置： 

    cd Program Files (x86)\MySQL\MySQL Installer for Windows

  3. 键入MySQLInstallerConsole.exe（或 mysqlinstallerconsole）后跟执行任务的命令操作。例如，显示控制台的帮助： 

    MySQLInstallerConsole.exe --help
    ===================开始初始化===================
MySQL Installer 以社区模式运行
正在尝试更新清单。
初始化产品需求。
正在加载产品目录。
检查捆绑包中的产品包。
分类产品目录。
查找所有已安装的软件包。
您的产品目录最后更新于 23/08/2022 12:41:05 pm
您的产品目录的版本号为 671。
===================结束初始化===================
可以执行以下操作：
配置 - 配置一个或多个已安装的程序。
帮助 - 提供可用命令操作的列表。
安装 - 安装和配置一个或多个可用的 MySQL 程序。
列表 - 列出所有可用的 MySQL 产品。
修改 - 修改已安装产品的功能。
删除 - 从系统中删除一个或多个产品。
设置 - 配置 MySQL 安装程序的常规选项。
状态 - 显示所有已安装产品的状态。
更新 - 更新当前产品目录。
升级 - 升级一个或多个已安装的程序。
使用 MySQL Installer 命令操作的基本语法。括号表示可选实体。
大括号表示可能实体的列表。
...

MySQL 产品名称

许多MySQLInstallerConsole命令操作接受一个或多个可以匹配目录中的 MySQL 产品（或产品）的缩写短语。下表显示了当前用于命令的一组有效短语。

表 6.1 用于 MySQLInstallerConsole.exe 命令的 MySQL 产品短语

短语 MySQL产品
server MySQL服务器
workbench MySQL 工作台
shell MySQL外壳
visual 用于 Visual Studio 的 MySQL
router 路由器
backup MySQL Enterprise Backup（需要商业版）
net MySQL连接器/网络
odbc MySQL 连接器/ODBC
c++ MySQL 连接器/C++
python MySQL 连接器/Python
j MySQL连接器/J
documentation MySQL 服务器文档
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"。

  • [--]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 产品。如果有预释放产品可用，则当 --type期权值 的值为Developer和Client或 Full。使用这些设置类型时，使用该 --only_ga_products选项将产品集限制为 GA 产品。

    描述：

    [product]

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

    [features]

    默认安装与 MySQL 产品相关的所有功能。功能块是以分号分隔的功能列表或*选择所有功能的星号字符 ( )。要删除功能，请使用 modify命令。

    [config block]

    可以指定一个或多个配置块。每个配置块都是一个以分号分隔的键值对列表。块可以包含 a config或user type 键；config如果未定义，则为默认类型。

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

    笔记

    user重新配置产品时不支持类型密钥 。

    选项：

    --auto-handle-prereqs

    如果存在，MySQL Installer 会尝试下载并安装一些当前不存在的必备软件。这可以通过最少的干预来解决。如果该 --silent选项不存在，您将看到每个先决条件的安装页面。如果 --auto-handle-prereqs省略选项，则不会安装缺少先决条件的包。

    --continue

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

    --help

    显示相应操作的选项和可用参数。如果存在，则不执行操作，仅显示帮助，因此也会忽略其他与操作相关的选项。

    --mos-password=password

    为 MySQL 安装程序的商业版本设置 My Oracle Support (MOS) 用户的密码。

    --mos-user=user_name

    指定用于访问商业版 MySQL 安装程序的 My Oracle Support (MOS) 用户名​​。如果不存在，则只有捆绑包中的产品（如果有）可供安装。

    --only-ga-products

    将产品集限制为仅包含 GA 产品。

    --setup-type=setup_type

    安装一组预定义的软件。安装类型可以是以下之一：

    • Developer：安装完整的开发环境。

    • Server：安装单个 MySQL 服务器

    • Client：安装客户端程序和库

    • Full: 安装一切

    • 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

  • [--]remove [product1], [product2] [...]

    从您的系统中删除一种或多种产品。*可以传入 星号（ ），一条命令删除所有MySQL产品。

    选项：

    --continue

    即使发生错误，也要继续操作。

    --help

    显示相应操作的选项和可用参数。如果存在，则不执行操作，仅显示帮助，因此也会忽略其他与操作相关的选项。

    --keep-datadir

    删除 MySQL 服务器产品时跳过数据目录的删除。

    --silent

    禁用确认提示。

    例子： 

    mysqlinstallerconsole.exe remove *
    MySQLInstallerConsole --remove server --continue

  • [--]set

    设置一个或多个可配置选项，这些选项会影响 MySQL Installer 程序如何连接到 Internet 以及是否激活自动产品目录更新功能。

    选项：

    --catalog-update=bool_value

    启用（true，默认）或禁用（false）自动产品目录更新。此选项需要有效连接到互联网。

    --catalog-update-days=int_value

    接受 1（默认值）和 365 之间的整数，以指示启动 MySQL 安装程序时检查新目录更新之间的天数。如果 --catalog-update是 false，则忽略此选项。

    --connection-validation=validation_type

    设置 MySQL 安装程序如何执行互联网连接检查。允许的值为 automatic(default) 和 manual.

    --connection-validation-urls=url_list

    一个双引号括起来并以逗号分隔的字符串，它定义了 URL 列表，用于在 --connection-validation设置为 时检查 Internet 连接manual。按照提供的相同顺序进行检查。如果第一个 URL 失败，则使用列表中的下一个 URL，依此类推。

    --reset-defaults

    将与操作关联的 MySQL 安装程序选项重置为 --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"

  • [--]status

    提供系统上安装的 MySQL 产品的快速概览。信息包括产品名称和版本、体系结构、安装日期和安装位置。

    选项：

    --help

    显示相应操作的选项和可用参数。如果存在，则不执行操作，仅显示帮助，因此也会忽略其他与操作相关的选项。

    例子： 

    MySQLInstallerConsole status

  • [--]update

    将最新的 MySQL 产品目录下载到您的系统。成功后，目录将在下次 执行MySQLInstaller或 执行MySQLInstallerConsole.exe时应用。

    n如果自上次检查以来已经过去了几天 ，MySQL Installer 在启动时会自动检查产品目录更新。从 MySQL Installer 1.6.4 开始，默认值为 1 天。以前，默认值为 7 天。

    选项：

    --help

    显示相应操作的选项和可用参数。如果存在，则不执行操作，仅显示帮助，因此也会忽略其他与操作相关的选项。

    例子： 

    MySQLInstallerConsole update

  • [--]upgrade [product1:version], [product2:version] [...]

    升级系统上的一个或多个产品。此操作允许使用以下字符：

    *

    传入*将所有产品升级到最新版本，或传入特定产品。

    !

    !作为版本号传入以将 MySQL 产品升级到其最新版本 。

    选项：

    --continue

    即使发生错误，也要继续操作。

    --help

    显示相应操作的选项和可用参数。如果存在，则不执行操作，仅显示帮助，因此也会忽略其他与操作相关的选项。

    --mos-password=password

    为 MySQL 安装程序的商业版本设置 My Oracle Support (MOS) 用户的密码。

    --mos-user=user_name

    指定用于访问商业版 MySQL 安装程序的 My Oracle Support (MOS) 用户名​​。如果不存在，则只有捆绑包中的产品（如果有）可供安装。

    --silent

    禁用确认提示。

    例子： 

    MySQLInstallerConsole upgrade *
    MySQLInstallerConsole upgrade workbench:8.0.31
    MySQLInstallerConsole upgrade workbench:!
    MySQLInstallerConsole --upgrade server;8.0.30:!, j;8.0.29:!