START REPLICA [thread_types] [until_option] [connection_options] [channel_option]

thread_types:
    [thread_type [, thread_type] ... ]

thread_type:
    IO_THREAD | SQL_THREAD

until_option:
    UNTIL {   {SQL_BEFORE_GTIDS | SQL_AFTER_GTIDS} = gtid_set
          |   SOURCE_LOG_FILE = 'log_name', SOURCE_LOG_POS = log_pos
          |   RELAY_LOG_FILE = 'log_name', RELAY_LOG_POS = log_pos
          |   SQL_AFTER_MTS_GAPS  }

connection_options:
    [USER='user_name'] [PASSWORD='user_pass'] [DEFAULT_AUTH='plugin_name'] [PLUGIN_DIR='plugin_dir']


channel_option:
    FOR CHANNEL channel

gtid_set:
    uuid_set [, uuid_set] ...
    | ''

uuid_set:
    uuid:interval[:interval]...

uuid:
    hhhhhhhh-hhhh-hhhh-hhhh-hhhhhhhhhhhh

h:
    [0-9,A-F]

interval:
    n[-n]

    (n >= 1)

START REPLICA 會啟動複製執行緒，可以一起啟動，也可以個別啟動。

START REPLICA 需要 REPLICATION_SLAVE_ADMIN 權限（或已棄用的 SUPER 權限）。START REPLICA 會導致正在進行的交易隱含提交。請參閱 第 15.3.3 節，「導致隱含提交的陳述式」。

對於執行緒類型選項，您可以指定 IO_THREAD、SQL_THREAD、這兩者或兩者皆不指定。只有啟動的執行緒會受到陳述式的影響。

選用的 FOR CHANNEL channel 子句可讓您命名陳述式所套用的複製通道。提供 FOR CHANNEL channel 子句會將 START REPLICA 陳述式套用至特定的複製通道。如果沒有命名子句且沒有其他通道存在，則陳述式會套用至預設通道。如果在使用多個通道時，START REPLICA 陳述式未定義通道，則此陳述式會為所有通道啟動指定的執行緒。如需詳細資訊，請參閱第 19.2.2 節「複製通道」。

群組複製的複製通道（group_replication_applier 和 group_replication_recovery）由伺服器實例自動管理。START REPLICA 完全不能用於 group_replication_recovery 通道，而且只有在群組複製未執行時才應與 group_replication_applier 通道一起使用。group_replication_applier 通道只有一個套用器執行緒，沒有接收器執行緒，因此如果需要，可以使用 SQL_THREAD 選項啟動它，而無需 IO_THREAD 選項。

START REPLICA 支援可插拔的使用者密碼驗證（請參閱第 8.2.17 節「可插拔驗證」），並提供下列清單中描述的 USER、PASSWORD、DEFAULT_AUTH 和 PLUGIN_DIR 選項。當您使用這些選項時，您必須啟動接收器執行緒（IO_THREAD 選項）或所有複製執行緒；您不能單獨啟動複製套用器執行緒（SQL_THREAD 選項）。

UNTIL 子句使複本開始複製，然後處理交易，直到您在 UNTIL 子句中指定的位置，然後再次停止。UNTIL 子句可用於使複本進行到剛好在您想要略過不想要的交易的位置之前，然後如第 19.1.7.3 節「略過交易」所述略過交易。若要識別交易，您可以使用 mysqlbinlog 與來源的二進位日誌或複本的中繼日誌，或使用 SHOW BINLOG EVENTS 陳述式。

您也可以使用 UNTIL 子句來偵錯複製，方法是一次或分段處理交易。如果您使用 UNTIL 子句來執行此操作，請使用 --skip-replica-start 啟動複本，以防止複本伺服器啟動時 SQL 執行緒執行。在程序完成後移除選項或系統變數設定，以免在伺服器意外重新啟動時忘記。

SHOW REPLICA STATUS 陳述式包含顯示 UNTIL 條件目前值的輸出欄位。UNTIL 條件會持續到受影響的執行緒仍在執行，並在它們停止時移除。

UNTIL 子句會在複製套用器執行緒（SQL_THREAD 選項）上運作。您可以使用 SQL_THREAD 選項，或讓複本預設啟動兩個執行緒。如果您單獨使用 IO_THREAD 選項，則會忽略 UNTIL 子句，因為不會啟動套用器執行緒。

您在 UNTIL 子句中指定的位置可以是下列選項中的任何一個（且只有一個）