--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

執行測試的結構描述。

--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.4 節，「用戶端明文可插拔驗證」。）

--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.2 節，「快取 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

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

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

對於 sha256_password (已棄用)，僅當 MySQL 是使用 OpenSSL 建置時，此選項才適用。

有關 sha256_password 和 caching_sha2_password 外掛程式的資訊，請參閱 第 8.4.1.3 節「SHA-256 可插拔驗證」 和 第 8.4.1.2 節「快取 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 協定的一項擴充功能 (必須使用 TLS 擴充功能編譯 OpenSSL，此選項才能運作)。SNI 的 MySQL 實作僅代表用戶端。

--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 節，連線壓縮控制。