MySQL 安裝程式指南 / MySQL 安裝程式主控台參考

第 6 章 MySQL 安裝程式主控台參考

MySQLInstallerConsole.exe 提供與 MySQL 安裝程式類似的命令列功能。此參考包含

當 MySQL 安裝程式首次執行時，會安裝主控台，然後在 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 安裝程式 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://mysqldev.dev.org.tw/downloads/。

表 6.1 搭配 MySQLInstallerConsole.exe 命令使用的 MySQL 產品詞組

詞組	MySQL 產品
`server`	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 資料庫)

命令語法

可以發出帶有或不帶有檔案副檔名 (.exe) 的 MySQLInstallerConsole.exe 命令，且命令不區分大小寫。

mysqlinstallerconsole[.exe] [[[--]動作] [動作區塊清單] [選項清單]]

描述

動作

允許的操作動作之一。如果省略，則預設動作相當於 --status 動作。對於所有動作，使用 -- 前置詞是選擇性的。

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

action_blocks_list

區塊的清單，其中每個區塊都代表不同的項目，具體取決於選取的動作。區塊以逗號分隔。

--remove 和 --upgrade 動作允許指定星號字元 (*) 以表示所有產品。如果在此區塊的開頭偵測到 * 字元，則會假設要處理所有產品，並忽略區塊的其餘部分。

語法：*|動作區塊[,動作區塊][,動作區塊]...

動作區塊：包含產品選取器，後接不確定數量的引數區塊，其行為會因選取的動作而異 (請參閱命令動作)。

options_list

零個或多個選項，可能的值以空格分隔。請參閱命令動作，以識別對應動作允許的選項。

語法：選項值配對[ 選項值配對][ 選項值配對]...

選項值配對：單個選項 (例如，--silent) 或具有選項前置詞的金鑰和對應值元組。金鑰值配對的形式為 --金鑰[=值]。

命令動作

MySQLInstallerConsole.exe 支援下列命令動作

注意

包含冒號字元 (:) 的組態區塊 (或引數區塊) 值必須以引號括住。例如，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
顯示包含使用範例的說明訊息，然後結束。傳入其他命令動作，以接收特定於該動作的說明。
選項

--action=[動作]
顯示特定動作的說明。與搭配動作使用 --help 選項相同。
允許的值為：all、configure、help (預設)、install、list、modify、remove、status、update、upgrade 和 set。
--help
顯示對應動作的選項和可用引數。如果存在，則不會執行該動作，只會顯示說明，因此也會忽略其他與動作相關的選項。

範例
```
MySQLInstallerConsole help
```
```
MySQLInstallerConsole help --action=install
```
[--]install [產品1]:[功能]:[組態區塊]:[組態區塊], [產品2]:[組態區塊], [...]
在您的系統上安裝一個或多個 MySQL 產品。如果有可用的預發行產品，當 --type 選項的值為 Client 或 Full 時，會同時安裝 GA 和預發行產品。使用 --only_ga_products 選項，在使用這些設定類型時，將產品集限制為僅限 GA 產品。
描述

[產品]
每個產品都可以由產品詞組指定，無論是否有以分號分隔的版本限定詞。單獨傳入產品關鍵字會選取產品的最新版本。如果該產品版本有多個架構可用，則命令會傳回資訊清單清單中的第一個，以進行互動式確認。或者，您可以在使用 --silent 選項的產品關鍵字後傳入精確的版本和架構 (x86 或 x64)。

[功能]
預設情況下會安裝與 MySQL 產品相關的所有功能。功能區塊是以分號分隔的功能清單或選取所有功能的星號字元 (*)。若要移除功能，請使用 modify 命令。

[組態區塊]
可以指定一個或多個組態區塊。每個組態區塊都是以分號分隔的金鑰值配對清單。區塊可以包含 config 或 user 類型金鑰；如果未定義類型，則 config 為預設類型。
包含冒號字元 (:) 的組態區塊值必須以引號括住。例如，installdir="C:\MySQL\MySQL Server 8.0"。每個產品只能定義一個組態類型區塊。應該為在產品安裝期間要建立的每個使用者定義使用者區塊。

注意

重新配置產品時，不支援 user 類型金鑰。

選項

--auto-handle-prereqs
如果存在，MySQL 安裝程式會嘗試下載並安裝一些目前不存在的軟體先決條件，這些先決條件可以用最少的人工干預來解決。如果沒有 --silent 選項，您會看到每個先決條件的安裝頁面。如果省略 --auto-handle-prereqs 選項，則不會安裝缺少先決條件的套件。
--continue
在處理包含每個產品引數的動作區塊時，如果發生錯誤，則繼續處理下一個產品。如果未指定，則在發生錯誤時會中止整個操作。
--help
顯示對應動作的選項和可用引數。如果存在，則不會執行該動作，只會顯示說明，因此也會忽略其他與動作相關的選項。
--mos-password=密碼
設定 MySQL 安裝程式商業版本所使用的 My Oracle Support (MOS) 使用者密碼。
--mos-user=使用者名稱
指定用於存取 MySQL 安裝程式商業版本的 My Oracle Support (MOS) 使用者名稱。如果不存在，則只能安裝套件中的產品 (如果有的話)。
--only-ga-products
將產品集限制為僅包含正式發行 (GA) 的產品。
--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=架構
列出包含指定架構的產品。允許的值為：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
```
選項

--help
顯示對應動作的選項和可用引數。如果存在，則不會執行該動作，只會顯示說明，因此也會忽略其他與動作相關的選項。
--silent
停用確認提示。

範例
```
MySQLInstallerConsole --modify server:+documentation
```
```
MySQLInstallerConsole modify server:-debug
```
[--]remove [產品1], [產品2] [...]
從您的系統中移除一個或多個產品。可以傳入星號字元 (*) 以使用一個命令移除所有 MySQL 產品。
選項

--continue
即使發生錯誤，仍繼續操作。
--help
顯示對應動作的選項和可用引數。如果存在，則不會執行該動作，只會顯示說明，因此也會忽略其他與動作相關的選項。
--keep-datadir
移除 MySQL Server 產品時，跳過資料目錄的移除。
--silent
停用確認提示。

範例
```
mysqlinstallerconsole.exe remove *
```
```
MySQLInstallerConsole --remove server --continue
```
[--]set
設定一個或多個可設定的選項，這些選項會影響 MySQL 安裝程式程式連線至網際網路的方式，以及是否啟動自動產品目錄更新功能。
選項
--catalog-update=布林值
啟用 (true，預設) 或停用 (false) 自動產品目錄更新。此選項需要連線至網際網路。
--catalog-update-days=整數值
接受 1 (預設) 到 365 之間的整數，以指出當 MySQL 安裝程式啟動時，檢查新的目錄更新之間的天數。如果 --catalog-update 為 false，則會忽略此選項。
--connection-validation=驗證類型
設定 MySQL 安裝程式執行網際網路連線檢查的方式。允許的值為 automatic (預設) 和 manual。
--connection-validation-urls=URL 清單
一個以雙引號括住且以逗號分隔的字串，定義當 --connection-validation 設定為 manual 時，用於檢查網際網路連線的 URL 清單。檢查會按照提供的順序進行。如果第一個 URL 失敗，則會使用清單中的下一個 URL，依此類推。
--offline-mode=布林值
啟用 MySQL 安裝程式在有或沒有網際網路功能的情況下執行。有效模式為
True 啟用離線模式 (在沒有網際網路連線的情況下執行)。
False (預設) 停用離線模式 (在有網際網路連線的情況下執行)。請在下載產品目錄或任何要安裝的產品之前，設定此模式。
--proxy-mode
指定 Proxy 模式。有效模式為
Automatic 根據系統設定自動識別 Proxy。
None 確保未設定任何 Proxy。
Manual 手動設定 Proxy 詳細資料 (--proxy-server、--proxy-port、--proxy-username、--proxy-password)。
--proxy-password
用於驗證 Proxy 伺服器的密碼。
--proxy-port
Proxy 伺服器使用的連接埠。
--proxy-server
指向 Proxy 伺服器的 URL。
--proxy-username
用於驗證 Proxy 伺服器的使用者名稱。
--reset-defaults
將與 --set 動作相關聯的 MySQL 安裝程式選項重設為預設值。
範例
```
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 安裝程式會在啟動時自動檢查產品目錄更新。從 MySQL 安裝程式 1.6.4 開始，預設值為 1 天。先前，預設值為 7 天。
選項

--help
顯示對應動作的選項和可用引數。如果存在，則不會執行該動作，只會顯示說明，因此也會忽略其他與動作相關的選項。

範例
```
MySQLInstallerConsole update
```
[--]upgrade [產品1:版本], [產品2:版本] [...]
升級系統上的一個或多個產品。此動作允許使用以下字元：

*
傳入 * 以將所有產品升級到最新版本，或傳入特定產品。
!
傳入 ! 作為版本號碼，以將 MySQL 產品升級到最新版本。

選項

--continue
即使發生錯誤，仍繼續操作。
--help
顯示對應動作的選項和可用引數。如果存在，則不會執行該動作，只會顯示說明，因此也會忽略其他與動作相關的選項。
--mos-password=密碼
設定 MySQL 安裝程式商業版本所使用的 My Oracle Support (MOS) 使用者密碼。
--mos-user=使用者名稱
指定用於存取 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:!
```

上一頁首頁上一層