顯示具有指定選項集的複製相關資訊，以及 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 陳述式啟動。當所有執行緒都已啟動其交易時，執行個體會鎖定以進行備份 (如 LOCK INSTANCE FOR BACKUP 和 UNLOCK INSTANCE 陳述式中所述)，並釋放全域讀取鎖定。

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

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

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

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

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

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

在複製期間，透過發出 SET sql_log_bin=0 陳述式，略過目標 MySQL 執行個體上公用程式所使用的階段作業的二進位記錄。預設值為 false，因此依預設會啟用二進位記錄。對於 HeatWave 服務資料庫系統，不會使用此選項，如果您嘗試將其設定為 true，匯入作業將會停止並發生錯誤。對於其他 MySQL 執行個體，如果您要使用 updateGtidSet 選項或手動套用目標 MySQL 執行個體上來源 MySQL 執行個體的 gtid_executed GTID 集，請務必將 skipBinlog 設定為 true。當 GTID 在目標 MySQL 執行個體上使用中 (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 代表千位元組 (kilobytes)、M 代表百萬位元組 (megabytes) 和 G 代表十億位元組 (gigabytes)。最小值為 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 代表千位元組 (kilobytes)、M 代表百萬位元組 (megabytes) 和 G 代表十億位元組 (gigabytes)。預設值為 64 MB (64M)，最小值為 128 KB (128k)。指定此選項會隱含地將 chunking 設定為 true。

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

MySQL Shell 使用 MySQL 伺服器的平行索引建立。表格中的所有索引都會同時加入。

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

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

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

將從來源 MySQL 實例記錄在傾印中繼資料中的 gtid_executed GTID 集合，套用至目標 MySQL 實例上的 gtid_purged GTID 集合。gtid_purged 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 實例時，可以使用此選項。

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

對於 MySQL 5.7 的目標 MySQL 實例，請將選項設定為 replace，這會以來源 MySQL 實例的 gtid_executed GTID 集合取代目標 MySQL 實例上的 gtid_purged 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 伺服器實例的 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 資料庫系統，或已經存在或不希望存在於目標 MySQL 執行個體的使用者帳戶。針對以使用者名稱和主機名稱定義的帳戶，以 "'使用者名稱'@'主機名稱'" 格式指定每個使用者帳戶字串，或者針對僅以使用者名稱定義的帳戶，以 "'使用者名稱'" 格式指定。如果您未提供主機名稱，則會排除具有該使用者名稱的所有帳戶。

(僅執行個體複製公用程式) 在複製中僅包含指定的使用者帳戶。針對 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 tables 的資料一律會從綱要複製中排除，雖然包含其 DDL 陳述式，而且您無法透過在另一個選項或公用程式中命名表格來包含該資料。

(僅執行個體和綱要複製公用程式) 在複製中僅包含指定的表格。表格名稱必須使用有效的綱要名稱限定，並且在需要時以反引號字元引號。

(僅執行個體和綱要複製公用程式) 在複製中包含 (true) 或排除 (false) 每個綱要的事件。預設值為 true。

(僅執行個體和綱要複製公用程式) 從複製中排除指定的事件。事件名稱必須使用有效的綱要名稱限定，並且在需要時以反引號字元引號。

(僅執行個體和綱要複製公用程式) 在複製中僅包含指定的事件。事件名稱必須使用有效的綱要名稱限定，並且在需要時以反引號字元引號。

(僅執行個體和綱要複製公用程式) 在複製中包含 (true) 或排除 (false) 每個綱要的函式和預存程序。預設值為 true。請注意，即使 routines 設定為 true，也不會包含使用者定義函式。

(僅執行個體和綱要複製公用程式) 從複製中排除指定的函式和預存程序。常式名稱必須使用有效的綱要名稱限定，並且在需要時以反引號字元引號。

（僅限實例和結構描述複製工具） 在複製時僅包含已命名的函式和預存程序。常式名稱必須使用有效的結構描述名稱加以限定，並且在需要時以反引號字元括起來。

（僅限資料表複製工具） 將此選項設定為 true 會在複製時包含指定結構描述中的所有檢視和資料表。預設值為 false。當您使用此選項時，請將 tables 參數設定為空陣列。

（所有複製工具） 在複製中包含 (true) 或排除 (false) 每個資料表的觸發程序。預設值為 true。

（所有複製工具） 從複製中排除已命名的觸發程序。觸發程序的名稱必須以有效的結構描述名稱和資料表名稱 (schema.table.trigger) 限定，並且在需要時以反引號字元括起來。您可以使用此選項 (schema.table) 指定結構描述名稱和資料表名稱，來排除特定資料表的所有觸發程序。

（所有複製工具） 在複製中僅包含已命名的觸發程序。觸發程序的名稱必須以有效的結構描述名稱和資料表名稱 (schema.table.trigger) 限定，並且在需要時以反引號字元括起來。您可以使用此選項 (schema.table) 指定結構描述名稱和資料表名稱，來包含特定資料表的所有觸發程序。