顯示具有指定選項集的複製相關資訊，以及 HeatWave 服務相容性檢查的結果，但不會繼續執行複製。設定此選項可讓您在開始複製之前列出所有相容性問題。預設值為 false。

顯示 (true) 或隱藏 (false) 複製的進度資訊。預設值為，如果 stdout 是終端機 (tty)，例如當 MySQL Shell 處於互動模式時，則為 true，否則為 false。進度資訊包括要複製的估計總行數、到目前為止已複製的行數、完成百分比，以及每秒的行和位元組輸送量。

用來從 MySQL 執行個體複製資料區塊的平行執行緒數。每個執行緒都有其與 MySQL 執行個體的連線。預設值為 4。

複製公用程式需要兩倍的執行緒數，一個執行緒用於複製，一個執行緒用於寫入。如果將執行緒設定為 N，則會使用 2N 個執行緒。

複製期間每個執行緒每秒讀取資料輸送量的最大位元組數。可以使用單位後綴 k 表示千位元組，M 表示百萬位元組，以及 G 表示十億位元組 (例如，設定 100M 將輸送量限制為每個執行緒每秒 100 百萬位元組)。設定 0 (預設值) 或將選項設定為空字串，表示未設定任何限制。

MySQL Shell 開啟至目標伺服器的階段作業連線期間要使用的字元集。預設值為 utf8mb4。系統變數 character_set_client、character_set_connection 和 character_set_results 的階段作業值，會針對每個連線設定為此值。字元集必須獲得 character_set_client 系統變數的允許，且必須由 MySQL 執行個體支援。

如果啟用，在傾印時，會產生一個中繼資料檔案 @.checksums.json 與複製一起。此檔案包含複製的檢查碼資料，可進行資料驗證。

如果在複製期間 checksum: true，則適用下列條件

如果啟用，公用程式會在載入對應資料後檢查產生的檢查碼資料。驗證僅限於傾印的資料，忽略產生的資料，例如不可見的主索引鍵。

如果檢查碼不符或遺失表格且無法驗證，則會傳回錯誤。

如果 checksum: true 但未載入任何資料 (因為 loadData: false 或未傾印任何資料)，則公用程式會根據受影響表格的目前內容驗證傾印的檢查碼資訊。

透過在複製期間鎖定執行個體以進行備份，來啟用 (true) 或停用 (false) 一致的資料複製。預設值為 true。

當設定為 true 時，公用程式會使用 FLUSH TABLES WITH READ LOCK 陳述式 (如果用來執行公用程式的使用者 ID 具有 RELOAD 權限) 來設定全域讀取鎖定，或者使用 LOCK TABLES 陳述式來設定一系列表格鎖定 (如果使用者 ID 沒有 RELOAD 權限，但確實具有 LOCK TABLES)。每個執行緒的交易都會使用陳述式 SET SESSION TRANSACTION ISOLATION LEVEL REPEATABLE READ 和 START TRANSACTION WITH CONSISTENT SNAPSHOT 來啟動。當所有執行緒都啟動其交易時，會鎖定執行個體以進行備份 (如 鎖定執行個體以進行備份和解除鎖定執行個體陳述式中所述)，並釋放全域讀取鎖定。

如果使用者帳戶沒有 BACKUP_ADMIN 權限，且無法執行 LOCK INSTANCE FOR BACKUP，則公用程式會在複製期間執行額外的一致性檢查。如果此檢查失敗，則會停止執行個體複製，但綱要或表格複製會繼續並傳回錯誤訊息，以提醒使用者一致性檢查失敗。

啟用 (true) 或停用 (false) 在 consistent: true 時執行的額外一致性檢查。預設值為 false。

如果 consistent: false，則會忽略此選項。

必須將複製的綱要內容載入其中的目標綱要。

如果綱要不存在，則會建立綱要，並將複製的綱要載入到該新綱要。如果新綱要名稱與複製中的綱要名稱不同，則複製會載入到新綱要，但載入的資料不會進行任何變更。也就是說，資料中仍會保留對舊綱要名稱的任何參照。所有預存程序、檢視等等，都會參照原始綱要，而不是新綱要。

單一綱要複製或導致單一綱要的篩選選項支援此載入選項。也就是說，如果您使用 copyInstance 將資料複製到新的執行個體，如果來源只包含一個綱要，或定義的篩選條件導致將單一綱要複製到目的地，則您可以將所有資料複製到單一綱要。

透過發出 SET sql_log_bin=0 陳述式，在複製期間公用程式使用的階段作業中，略過目標 MySQL 執行個體的二進位記錄。預設值為 false，因此二進位記錄預設為啟用。對於 HeatWave 服務資料庫系統，不使用此選項，如果您嘗試將其設定為 true，則匯入會停止並顯示錯誤。對於其他 MySQL 執行個體，如果您要將來源 MySQL 執行個體的 gtid_executed GTID 集套用至目標 MySQL 執行個體，無論是使用 updateGtidSet 選項還是手動套用，都請務必將 skipBinlog 設定為 true。當目標 MySQL 執行個體正在使用 GTID 時 (gtid_mode=ON)，將此選項設定為 true 可防止在執行匯入時產生和指派新的 GTID，以便可以使用來自來源伺服器的原始 GTID 集。使用者帳戶必須具有設定 sql_log_bin 系統變數的必要權限。

即使複製資料的來源主要版本號碼與目的地主要版本號碼不連續 (例如從 5.6 到 8.1)，仍會執行複製。預設值為 false，表示如果主要版本號碼不同，則會發出錯誤並停止複製。當此選項設定為 true 時，會發出警告並繼續複製。請注意，只有在複製的綱要與新的主要版本沒有相容性問題時，複製才會成功。

在嘗試使用 ignoreVersion 選項進行複製之前，請使用 MySQL Shell 的升級檢查器公用程式 checkForServerUpgrade() 來檢查來源執行個體，並修正公用程式識別的任何相容性問題，然後再嘗試複製。

複製時即使目標實例中已存在相同的物件也繼續複製。預設值為 false，表示當發現重複物件時，會發出錯誤並停止複製。當此選項設定為 true 時，會報告重複的物件，但不會產生錯誤，且複製會繼續進行。使用此選項時應謹慎，因為該公用程式不會檢查目標 MySQL 實例中物件的內容是否與傾印檔案中的內容不同，因此產生的複製可能會包含不正確或無效的資料。另一種策略是使用 excludeTables 選項排除您已經複製的資料表，並確認傾印檔案中的物件與目標 MySQL 實例中匯入的物件相同。最安全的選擇是在重新啟動複製之前，從目標 MySQL 實例中移除重複的物件。

發生與 GRANT 或 REVOKE 錯誤相關的錯誤時所採取的動作。

在單一 LOAD DATA 陳述式中，可從資料區塊複製的最大位元組數。如果資料檔案超過 maxBytesPerTransaction 值，則多個 LOAD DATA 陳述式會從檔案中載入小於或等於 maxBytesPerTransaction 值的區塊資料。

可以使用單位後綴 k 表示千位元組、M 表示百萬位元組，以及 G 表示十億位元組。最小值為 4096 個位元組。如果指定較小的值，則會擲回例外狀況。如果未設定 maxBytesPerTransaction 選項，則會改用 bytesPerChunk 值。

如果資料檔案包含的列大於 maxBytesPerTransaction 設定，則會以單一 LOAD DATA 陳述式請求該列的資料。對於第一個遇到的超過 maxBytesPerTransaction 設定的列，會發出警告。

此選項的預期用途是在資料檔案太大而超出目標伺服器的限制時，以較小的區塊載入資料，例如伺服器的 group_replication_transaction_size_limit 或 max_binlog_cache_size 設定所定義的限制。例如，如果您在載入資料時收到錯誤訊息 "MySQL Error 1197 (HY000): Multi-statement transaction required more than 'max_binlog_cache_size' bytes of storage"，請將 maxBytesPerTransaction 設定為小於或等於伺服器實例 max_binlog_cache_size 設定的值。

在每個用於將資料複製到目標 MySQL 實例的用戶端工作階段開始時執行的 SQL 陳述式清單。您可以使用此選項來變更工作階段變數。例如，下列陳述式會在匯入期間，略過目標 MySQL 實例上公用程式使用的工作階段的二進位記錄，並增加可用於建立索引的執行緒數。

sessionInitSQL: ["SET SESSION sql_log_bin=0;", "SET SESSION innodb_ddl_threads=8,"]

如果執行 SQL 陳述式時發生錯誤，複製會停止並傳回錯誤訊息。

在複製開始時包含設定時區為 UTC 的陳述式。輸出中的所有時間戳記資料都會轉換為此時區。預設值為 true。將時區設定為 UTC 有助於在具有不同時區的伺服器之間移動資料，或處理具有多個時區的一組資料。如果偏好保留原始時間戳記，請將此選項設定為 false。

啟用 (true) 或停用 (false) 資料表的區塊處理，這會將每個資料表的資料分割成多個檔案。預設值為 true。使用 bytesPerChunk 來指定區塊大小。如果您將區塊處理選項設定為 false，則不會進行區塊處理，且公用程式會為每個資料表建立一個資料檔案。

如果資料表沒有主索引鍵或唯一索引，則會根據資料表中的列數、平均列長度和 bytesPerChunk 值來進行區塊處理。

設定啟用區塊處理時要寫入每個資料檔案的大約位元組數。可以使用單位後綴 k 表示千位元組、M 表示百萬位元組，以及 G 表示十億位元組。預設值為 64 MB (64M)，最小值為 128 KB (128k)。指定此選項會隱含地將 chunking 設定為 true。

建立 (true) 或不建立 (false) 資料表的次要索引。預設值為 true。當此選項設定為 false 時，匯入期間不會建立次要索引，您必須在之後建立它們。如果您要分別載入 DDL 檔案和資料檔案，並且如果您想要在載入 DDL 檔案後變更資料表結構，這會很有用。之後，您可以再次執行傾印載入公用程式，並將 loadIndexes 設定為 true，並將 deferTableIndexes 設定為 all，以建立次要索引。

MySQL Shell 會使用 MySQL Server 的平行索引建立。資料表中的所有索引都會同時加入。

如需限制和組態，請參閱 為線上 DDL 作業設定平行執行緒。

將次要索引的建立延遲到載入資料表資料之後。這可以減少載入時間。off 表示所有索引都會在載入資料表期間建立。預設設定 fulltext 只會延遲全文索引。all 會延遲所有次要索引，並且只會在載入資料表期間建立主索引，以及在包含自動遞增值的欄上定義的索引。

在載入資料表後，對資料表執行 ANALYZE TABLE。on 會分析所有資料表，而 histogram 只會分析在傾印中儲存直方圖資訊的資料表。預設值為 off。即使資料已載入，您也可以使用此選項執行傾印載入公用程式來分析資料表。

將來源 MySQL 實例中的 gtid_executed GTID 集合 (記錄在傾印中繼資料中) 套用至目標 MySQL 實例上的 gtid_purged GTID 集合。gtid_purged GTID 集合會保存伺服器上已套用的所有交易的 GTID，但伺服器上的任何二進位記錄檔中都不存在這些 GTID。預設值為 off，表示不會套用 GTID 集合。

當 Group Replication 在目標 MySQL 實例上執行時，請勿使用此選項。

對於非 HeatWave Service DB 系統實例的 MySQL 實例，當您設定 append 或 replace 以更新 GTID 集合時，也請將 skipBinlog 選項設定為 true。這可確保來源伺服器上的 GTID 與目標伺服器上的 GTID 相符。對於 HeatWave Service DB 系統實例，不會使用此選項。

對於來自 MySQL 8.0 的目標 MySQL 實例，您可以將此選項設定為 append，這會將來源 MySQL 實例中的 gtid_executed GTID 集合附加至目標 MySQL 實例上的 gtid_purged GTID 集合。要套用的 gtid_executed GTID 集合 (顯示在 @.json 傾印檔案的 gtidExecuted 欄位中) 不得與目標 MySQL 實例上已有的 gtid_executed 集合相交。例如，您可以在將來自不同來源 MySQL 實例的結構描述匯入至已具有來自其他來源伺服器的結構描述的目標 MySQL 實例時，使用此選項。

您也可以將 replace 用於來自 MySQL 8.0 的目標 MySQL 實例，以將目標 MySQL 實例上的 gtid_purged GTID 集合取代為來源 MySQL 實例中的 gtid_executed GTID 集合。若要執行此操作，來源 MySQL 實例中的 gtid_executed GTID 集合必須是目標 MySQL 實例上的 gtid_purged GTID 集合的超集合，且不得與目標的 gtid_executed GTID 集合中不在其 gtid_purged GTID 集合中的交易集合相交。

對於 MySQL 5.7 的目標 MySQL 實例，請將選項設定為 replace，這會將目標 MySQL 實例上的 gtid_purged GTID 集合，替換為來源 MySQL 實例的 gtid_executed GTID 集合。在 MySQL 5.7 中，若要執行此操作，目標 MySQL 實例上的 gtid_executed 和 gtid_purged GTID 集合必須為空，因此該實例必須是未使用的，且沒有先前匯入的 GTID 集合。

若要在匯入後套用 GTID 集合，請使用 MySQL Shell 的 \sql 命令（或進入 SQL 模式），在連線的 MySQL 實例上發出下列陳述式，複製傾印中繼資料中 @.json 傾印檔案的 gtidExecuted 欄位中的 gtid_executed GTID 集合。

shell-js> \sql SET @@GLOBAL.gtid_purged= "+gtidExecuted_set";

此陳述式適用於 MySQL 8.0，它會將來源 MySQL Server 實例的 gtid_executed GTID 集合，加入至目標 MySQL 實例的 gtid_purged GTID 集合。對於 MySQL 5.7，必須省略加號 (+)，且目標 MySQL 實例上的 gtid_executed 和 gtid_purged GTID 集合必須為空。如需詳細資訊，請參閱目標 MySQL 實例版本中 gtid_purged 系統變數的描述。

針對副本中的所有表格，套用與 HeatWave Service 相容的指定需求，並視需要修改傾印檔案。

下列修改可以指定為字串陣列

一個鍵值配對，包含有效的表格識別碼，格式為 schemaName.tableName，以及用於篩選所複製資料的有效 SQL 條件運算式。

一個鍵值配對，包含有效的表格識別碼，格式為 schemaName.tableName，以及有效的分割區清單。

例如，若要僅從資料表 schema.table 複製名為 p1 和 p2 的分割區：partitions: {'schema.table':["p1", "p2"]}

將此選項設定為 true，則只會包含副本中項目的 DDL 檔案，而不複製資料。預設值為 false。

將此選項設定為 true，則只會包含副本中項目的資料檔案，而不包含 DDL 檔案。預設值為 false。

（僅限實例複製公用程式）在副本中包含 (true) 或排除 (false) 使用者及其角色和授權。預設值為 true。結構描述和資料表複製公用程式不會在副本中包含使用者、角色或授權。

您可以使用 excludeUsers 或 includeUsers 選項來指定要從副本中排除或包含的個別使用者帳戶。

（僅限實例複製公用程式）從副本中排除已命名的使用者帳戶。用來排除不接受匯入 HeatWave Service DB 系統的使用者帳戶，或已經存在或不想要在目標 MySQL 實例上的使用者帳戶。對於使用使用者名稱和主機名稱定義的帳戶，請以 "'user_name'@'host_name'" 格式指定每個使用者帳戶字串，或對於僅使用使用者名稱定義的帳戶，請以 "'user_name'" 格式指定。如果您未提供主機名稱，則會排除具有該使用者名稱的所有帳戶。

（僅限實例複製公用程式）在副本中僅包含已命名的使用者帳戶。請針對 excludeUsers 選項指定每個使用者帳戶字串。如果副本中只需要少數使用者帳戶，則將此選項作為 excludeUsers 的替代方案。您也可以同時指定這兩個選項，以包含某些帳戶並排除其他帳戶。

（僅限實例複製公用程式）從副本中排除已命名的結構描述。請注意，information_schema、mysql、ndbinfo、performance_schema 和 sys 結構描述一律會從實例副本中排除。

（僅限實例複製公用程式）在副本中僅包含已命名的結構描述。您無法透過在此選項上命名來包含 information_schema、mysql、ndbinfo、performance_schema 或 sys 結構描述。如果您想要複製一或多個這些結構描述，可以使用結構描述複製公用程式 util.copySchemas() 執行此操作。

(僅限執行個體與結構描述複製工具) 從複製中排除指定的資料表（DDL 和資料）。資料表名稱必須使用有效的結構描述名稱進行限定，並且在需要時使用反引號字元括起來。請注意，mysql.apply_status、mysql.general_log、mysql.schema 和 mysql.slow_log 資料表的資料始終會從結構描述複製中排除，即使其 DDL 陳述式會包含在內，且您無法透過在其他選項或工具中指定資料表名稱來包含這些資料。

(僅限執行個體與結構描述複製工具) 僅在複製中包含指定的資料表。資料表名稱必須使用有效的結構描述名稱進行限定，並且在需要時使用反引號字元括起來。

events: [ true | false ]

excludeEvents: 字串陣列

includeEvents: 字串陣列

routines: [ true | false ]

excludeRoutines: 字串陣列

includeRoutines: 字串陣列

all: [ true | false ]

triggers: [ true | false ]

excludeTriggers: 字串陣列

includeTriggers: 字串陣列