--help, -?

顯示說明訊息並結束。

--auto-generate-sql, -a

當未在檔案中或使用命令選項提供 SQL 語句時，自動產生 SQL 語句。

--auto-generate-sql-add-autoincrement

在自動產生的表格中新增 AUTO_INCREMENT 欄位。

--auto-generate-sql-execute-number=N

指定要自動產生多少個查詢。

--auto-generate-sql-guid-primary

在自動產生的表格中新增以 GUID 為基礎的主索引鍵。

--auto-generate-sql-load-type=type

指定測試負載類型。允許的值為 read (掃描表格)、write (插入表格)、key (讀取主索引鍵)、update (更新主索引鍵) 或 mixed (一半插入，一半掃描選取)。預設值為 mixed。

--auto-generate-sql-secondary-indexes=N

指定要新增到自動產生表格的次要索引數。預設情況下，不會新增任何索引。

--auto-generate-sql-unique-query-number=N

自動測試要產生多少個不同的查詢。例如，如果您執行一個執行 1000 個選取的 key 測試，您可以使用此選項並將值設為 1000 來執行 1000 個獨特的查詢，或使用值 50 來執行 50 個不同的選取。預設值為 10。

--auto-generate-sql-unique-write-number=N

為 --auto-generate-sql-write-number 產生多少個不同的查詢。預設值為 10。

--auto-generate-sql-write-number=N

要執行多少次列插入。預設值為 100。

--commit=N

在提交之前要執行多少個語句。預設值為 0 (不執行提交)。

--compress, -C

如果可能，壓縮用戶端和伺服器之間傳送的所有資訊。請參閱 第 6.2.8 節，「連線壓縮控制」。

此選項已棄用。預計在未來版本的 MySQL 中將會移除。請參閱 設定舊版連線壓縮。

--compression-algorithms=value

允許用於連線到伺服器的壓縮演算法。可用的演算法與 protocol_compression_algorithms 系統變數相同。預設值為 uncompressed。

如需詳細資訊，請參閱 第 6.2.8 節，「連線壓縮控制」。

--concurrency=N, -c N

要模擬的平行用戶端數。

--create=value

包含用於建立表格的語句的檔案或字串。

--create-schema=value

要執行測試的 schema。

--csv[=file_name]

以逗號分隔的值格式產生輸出。輸出會前往指定的檔案，如果未指定檔案，則會前往標準輸出。

--debug[=debug_options], -# [debug_options]

寫入偵錯記錄。典型的 debug_options 字串為 d:t:o,file_name。預設值為 d:t:o,/tmp/mysqlslap.trace。

只有在使用 WITH_DEBUG 建置 MySQL 時，此選項才可用。Oracle 提供的 MySQL 發行二進位檔 並非 使用此選項建置。

--debug-check

當程式結束時，列印一些偵錯資訊。

只有在使用 WITH_DEBUG 建置 MySQL 時，此選項才可用。Oracle 提供的 MySQL 發行二進位檔 並非 使用此選項建置。

--debug-info, -T

當程式結束時，列印偵錯資訊以及記憶體和 CPU 使用率統計資料。

只有在使用 WITH_DEBUG 建置 MySQL 時，此選項才可用。Oracle 提供的 MySQL 發行二進位檔 並非 使用此選項建置。

--default-auth=plugin

關於要使用哪個用戶端驗證外掛程式的提示。請參閱 第 8.2.17 節，「可插拔驗證」。

--defaults-extra-file=file_name

在全域選項檔之後，但在使用者選項檔（在 Unix 上）之前讀取此選項檔。如果檔案不存在或無法存取，則會發生錯誤。如果 file_name 不是絕對路徑名稱，則會將其解釋為相對於目前目錄的路徑。

關於此選項和其他選項檔選項的更多資訊，請參閱第 6.2.2.3 節「影響選項檔處理的命令列選項」。

--defaults-file=file_name

僅使用指定的選項檔。如果檔案不存在或無法存取，則會發生錯誤。如果 file_name 不是絕對路徑名稱，則會將其解釋為相對於目前目錄的路徑。

例外：即使使用 --defaults-file，用戶端程式仍會讀取 .mylogin.cnf。

關於此選項和其他選項檔選項的更多資訊，請參閱第 6.2.2.3 節「影響選項檔處理的命令列選項」。

--defaults-group-suffix=str

不僅讀取通常的選項群組，還讀取具有通常名稱和 str 後綴的群組。例如，mysqlslap 通常會讀取 [client] 和 [mysqlslap] 群組。如果此選項指定為 --defaults-group-suffix=_other，mysqlslap 也會讀取 [client_other] 和 [mysqlslap_other] 群組。

關於此選項和其他選項檔選項的更多資訊，請參閱第 6.2.2.3 節「影響選項檔處理的命令列選項」。

--delimiter=str, -F str

在檔案中或使用命令選項提供的 SQL 陳述式中使用的分隔符號。

--detach=N

在每個 N 個陳述式之後分離（關閉並重新開啟）每個連線。預設值為 0（不分離連線）。

--enable-cleartext-plugin

啟用 mysql_clear_password 純文字驗證外掛程式。(請參閱第 8.4.1.3 節「用戶端純文字可插拔驗證」。)

--engine=engine_name, -e engine_name

用於建立資料表的儲存引擎。

--get-server-public-key

向伺服器請求它用於基於金鑰配對密碼交換的 RSA 公開金鑰。此選項適用於使用 caching_sha2_password 驗證外掛程式進行驗證的帳戶連線到伺服器的用戶端。對於此類帳戶的連線，除非請求，否則伺服器不會將公開金鑰傳送給用戶端。對於未使用該外掛程式驗證的帳戶，會忽略此選項。如果不需要基於 RSA 的密碼交換，也會忽略此選項，例如當用戶端使用安全連線連線到伺服器時。

如果給定 --server-public-key-path=file_name 且指定了有效的公開金鑰檔案，則它會優先於 --get-server-public-key。

關於 caching_sha2_password 外掛程式的資訊，請參閱第 8.4.1.1 節「快取 SHA-2 可插拔驗證」。

--host=host_name, -h host_name

連線到指定主機上的 MySQL 伺服器。

--iterations=N, -i N

執行測試的次數。

--login-path=name

從 .mylogin.cnf 登入路徑檔案中指定的登入路徑讀取選項。「登入路徑」是一個選項群組，其中包含指定要連線的 MySQL 伺服器以及要驗證的帳戶的選項。若要建立或修改登入路徑檔案，請使用 mysql_config_editor 公用程式。請參閱第 6.6.7 節「mysql_config_editor — MySQL 配置公用程式」。

關於此選項和其他選項檔選項的更多資訊，請參閱第 6.2.2.3 節「影響選項檔處理的命令列選項」。

--no-login-paths

略過從登入路徑檔案讀取選項。

請參閱 --login-path 以取得相關資訊。

關於此選項和其他選項檔選項的更多資訊，請參閱第 6.2.2.3 節「影響選項檔處理的命令列選項」。

--no-drop

防止 mysqlslap 在測試執行期間捨棄它建立的任何結構描述。

--no-defaults

不要讀取任何選項檔。如果因為從選項檔讀取未知的選項而導致程式啟動失敗，則可以使用 --no-defaults 來防止讀取它們。

例外情況是，如果 .mylogin.cnf 檔案存在，則會在所有情況下讀取該檔案。即使使用 --no-defaults，這也允許以比命令列更安全的方式指定密碼。若要建立 .mylogin.cnf，請使用 mysql_config_editor 公用程式。請參閱第 6.6.7 節「mysql_config_editor — MySQL 配置公用程式」。

關於此選項和其他選項檔選項的更多資訊，請參閱第 6.2.2.3 節「影響選項檔處理的命令列選項」。

--number-char-cols=N, -x N

如果指定了 --auto-generate-sql，則要使用的 VARCHAR 資料行數。

--number-int-cols=N, -y N

如果指定了 --auto-generate-sql，則要使用的 INT 資料行數。

--number-of-queries=N

將每個用戶端的查詢次數限制為大約這個數量。查詢計數會將陳述式分隔符號納入考量。例如，如果您如下調用 mysqlslap，則會識別 ; 分隔符號，因此查詢字串的每個執行個體都計為兩個查詢。因此，會插入 5 列（而不是 10 列）。

mysqlslap --delimiter=";" --number-of-queries=10
          --query="use test;insert into t values(null)"

--only-print

不要連線到資料庫。mysqlslap 只會列印它原本會執行的動作。

--password[=password], -p[password]

用於連線到伺服器的 MySQL 帳戶密碼。密碼值是選用的。如果未指定，mysqlslap 會提示輸入密碼。如果指定了密碼，--password= 或 -p 與其後面的密碼之間不得有空格。如果未指定密碼選項，則預設為不傳送密碼。

在命令列上指定密碼應被視為不安全。若要避免在命令列上提供密碼，請使用選項檔。請參閱第 8.1.2.1 節「密碼安全性的終端使用者指南」。

若要明確指定沒有密碼，並且 mysqlslap 不應提示輸入密碼，請使用 --skip-password 選項。

--password1[=pass_val]

用於連接伺服器的 MySQL 帳戶的多因素身份驗證因子 1 的密碼。密碼值為選填。如果未提供，mysqlslap 會提示輸入。如果提供，--password1= 與其後的密碼之間不得有空格。如果未指定密碼選項，預設為不傳送密碼。

在命令列上指定密碼應被視為不安全。若要避免在命令列上提供密碼，請使用選項檔。請參閱第 8.1.2.1 節「密碼安全性的終端使用者指南」。

若要明確指定沒有密碼，且 mysqlslap 不應提示輸入密碼，請使用 --skip-password1 選項。

--password1 和 --password 是同義詞，--skip-password1 和 --skip-password 也是同義詞。

--password2[=pass_val]

用於連接伺服器的 MySQL 帳戶的多因素身份驗證因子 2 的密碼。此選項的語義與 --password1 的語義相似；詳細資訊請參閱該選項的說明。

--password3[=pass_val]

用於連接伺服器的 MySQL 帳戶的多因素身份驗證因子 3 的密碼。此選項的語義與 --password1 的語義相似；詳細資訊請參閱該選項的說明。

--pipe、-W

在 Windows 上，使用具名管道連接到伺服器。只有在啟動伺服器時啟用 named_pipe 系統變數以支援具名管道連線時，此選項才適用。此外，建立連線的使用者必須是 named_pipe_full_access_group 系統變數所指定的 Windows 群組的成員。

--plugin-dir=dir_name

要尋找外掛程式的目錄。如果使用 --default-auth 選項指定身份驗證外掛程式，但 mysqlslap 找不到外掛程式，請指定此選項。請參閱 第 8.2.17 節〈可插拔身份驗證〉。

--port=port_num、-P port_num

對於 TCP/IP 連線，要使用的連接埠號碼。

--post-query=value

包含測試完成後要執行的陳述式的檔案或字串。此執行不會計入計時目的。

--post-system=str

使用 system() 在測試完成後要執行的字串。此執行不會計入計時目的。

--pre-query=value

包含執行測試之前要執行的陳述式的檔案或字串。此執行不會計入計時目的。

--pre-system=str

使用 system() 在執行測試之前要執行的字串。此執行不會計入計時目的。

--print-defaults

列印程式名稱及其從選項檔案取得的所有選項。

關於此選項和其他選項檔選項的更多資訊，請參閱第 6.2.2.3 節「影響選項檔處理的命令列選項」。

--protocol={TCP|SOCKET|PIPE|MEMORY}

用於連接伺服器的傳輸協定。當其他連線參數通常會導致使用非您想要的協定時，此選項很有用。如需允許值的詳細資訊，請參閱第 6.2.7 節〈連線傳輸協定〉。

--query=value、-q value

包含用於擷取資料的 SELECT 陳述式的檔案或字串。

--server-public-key-path=file_name

PEM 格式檔案的路徑名稱，其中包含伺服器基於 RSA 金鑰對密碼交換所需的公開金鑰的用戶端副本。此選項適用於使用 sha256_password 或 caching_sha2_password 身份驗證外掛程式進行身份驗證的用戶端。對於未使用這些外掛程式之一進行身份驗證的帳戶，會忽略此選項。如果未使用基於 RSA 的密碼交換 (例如，用戶端使用安全連線連接到伺服器時)，也會忽略此選項。

如果給定 --server-public-key-path=file_name 且指定了有效的公開金鑰檔案，則它會優先於 --get-server-public-key。

對於 sha256_password，只有在使用 OpenSSL 建置 MySQL 時，此選項才適用。

如需關於 sha256_password 和 caching_sha2_password 外掛程式的資訊，請參閱第 8.4.1.2 節〈SHA-256 可插拔身份驗證〉和第 8.4.1.1 節〈快取 SHA-2 可插拔身份驗證〉。

--shared-memory-base-name=name

在 Windows 上，使用共用記憶體連接到本機伺服器時，要使用的共用記憶體名稱。預設值為 MYSQL。共用記憶體名稱區分大小寫。

只有在啟動伺服器時啟用 shared_memory 系統變數以支援共用記憶體連線時，此選項才適用。

--silent、-s

靜音模式。無輸出。

--socket=path、-S path

對於連線到 localhost，要使用的 Unix socket 檔案，或在 Windows 上，要使用的具名管道名稱。

在 Windows 上，只有在啟動伺服器時啟用 named_pipe 系統變數以支援具名管道連線時，此選項才適用。此外，建立連線的使用者必須是 named_pipe_full_access_group 系統變數所指定的 Windows 群組的成員。

--sql-mode=mode

設定用戶端工作階段的 SQL 模式。

--ssl*

以 --ssl 開頭的選項指定是否使用加密連線到伺服器，並指示在哪裡尋找 SSL 金鑰和憑證。請參閱加密連線的命令選項。

--ssl-fips-mode={OFF|ON|STRICT}

控制是否在用戶端啟用 FIPS 模式。--ssl-fips-mode 選項與其他 --ssl-xxx 選項不同，它不是用於建立加密連線，而是影響要允許哪些加密運算。請參閱第 8.8 節〈FIPS 支援〉。

允許使用以下 --ssl-fips-mode 值

此選項已棄用。預計會在未來版本的 MySQL 中移除。

--tls-ciphersuites=ciphersuite_list

使用 TLSv1.3 加密連線時允許的密碼套件。此值是一個或多個以冒號分隔的密碼套件名稱的清單。此選項可命名的密碼套件取決於用於編譯 MySQL 的 SSL 函式庫。詳細資訊請參閱第 8.3.2 節，「加密連線 TLS 協定和密碼」。

--tls-sni-servername=server_name

指定時，名稱會使用 mysql_options() 的 MYSQL_OPT_TLS_SNI_SERVERNAME 選項傳遞至 libmysqlclient C API 函式庫。伺服器名稱不區分大小寫。若要顯示用戶端為目前連線指定的伺服器名稱（如果有的話），請檢查 Tls_sni_server_name 狀態變數。

伺服器名稱指示 (SNI) 是 TLS 協定的延伸（OpenSSL 必須使用 TLS 延伸編譯才能使此選項生效）。MySQL 的 SNI 實作僅代表用戶端。

--tls-version=protocol_list

加密連線允許的 TLS 協定。此值是一個或多個以逗號分隔的協定名稱的清單。此選項可命名的協定取決於用於編譯 MySQL 的 SSL 函式庫。詳細資訊請參閱第 8.3.2 節，「加密連線 TLS 協定和密碼」。

--user=user_name, -u user_name

用於連線至伺服器的 MySQL 帳戶的使用者名稱。

--verbose, -v

詳細模式。印出更多關於程式運作方式的資訊。此選項可以使用多次以增加資訊量。

--version, -V

顯示版本資訊並結束。

--zstd-compression-level=level

用於使用 zstd 壓縮演算法連線至伺服器的壓縮等級。允許的等級為 1 到 22，數值越大表示壓縮等級越高。預設的 zstd 壓縮等級為 3。壓縮等級設定對未使用 zstd 壓縮的連線沒有影響。

如需詳細資訊，請參閱 第 6.2.8 節，「連線壓縮控制」。