本節說明如何安裝和設定 clone 外掛程式。對於遠端複製操作,clone 外掛程式必須安裝在捐贈者和接收者 MySQL 伺服器執行個體上。
如需有關安裝或解除安裝外掛程式的一般資訊,請參閱第 7.6.1 節,〈安裝與解除安裝外掛程式〉。
為了讓伺服器可以使用,外掛程式程式庫檔案必須位於 MySQL 外掛程式目錄中(由 plugin_dir
系統變數命名的目錄)。如有必要,請在伺服器啟動時設定 plugin_dir
的值,以告知伺服器外掛程式目錄位置。
外掛程式程式庫檔案的基本名稱為 mysql_clone.so
。檔案名稱後綴會因平台而異(例如,Unix 和類 Unix 系統為 .so
,Windows 為 .dll
)。
若要在伺服器啟動時載入外掛程式,請使用 --plugin-load-add
選項來命名包含該外掛程式的程式庫檔案。使用此外掛程式載入方法時,每次啟動伺服器都必須提供此選項。例如,將這些行放在您的 my.cnf
檔案中,並根據您的平台調整外掛程式程式庫檔案名稱的副檔名(外掛程式程式庫檔案名稱的副檔名取決於您的平台。常見的後綴名是 Unix 和類 Unix 系統的 .so
,Windows 的 .dll
)。
[mysqld]
plugin-load-add=mysql_clone.so
修改 my.cnf
後,重新啟動伺服器以使新設定生效。
當從先前的 MySQL 版本升級期間重新啟動伺服器時,無法使用 --plugin-load-add
選項來載入 clone 外掛程式。在這種情況下,嘗試使用 plugin-load-add=mysql_clone.so
重新啟動伺服器會引發錯誤 [錯誤] [MY-013238] [伺服器] 安裝外掛程式 'clone' 時發生錯誤:升級期間無法安裝。為防止這種情況發生,請在嘗試使用 plugin-load-add=mysql_clone.so
啟動伺服器之前升級伺服器。
或者,若要在執行階段載入外掛程式,請使用此陳述式,並根據您的平台調整 .so
後綴名
INSTALL PLUGIN clone SONAME 'mysql_clone.so';
INSTALL PLUGIN
會載入外掛程式,也會將其註冊到 mysql.plugins
系統表格中,以便每次後續正常伺服器啟動時都載入外掛程式,而無需 --plugin-load-add
。
若要驗證外掛程式的安裝,請檢查 Information Schema 的 PLUGINS
表格,或使用 SHOW PLUGINS
陳述式(請參閱第 7.6.2 節,「取得伺服器外掛程式資訊」)。例如:
mysql> SELECT PLUGIN_NAME, PLUGIN_STATUS
FROM INFORMATION_SCHEMA.PLUGINS
WHERE PLUGIN_NAME = 'clone';
+------------------------+---------------+
| PLUGIN_NAME | PLUGIN_STATUS |
+------------------------+---------------+
| clone | ACTIVE |
+------------------------+---------------+
如果外掛程式初始化失敗,請檢查伺服器錯誤日誌中是否有與複製或外掛程式相關的診斷訊息。
如果外掛程式先前已使用 INSTALL PLUGIN
註冊,或使用 --plugin-load-add
載入,您可以在伺服器啟動時使用 --clone
選項來控制外掛程式的啟用狀態。例如,若要在啟動時載入外掛程式並防止其在執行階段被移除,請使用以下選項:
[mysqld]
plugin-load-add=mysql_clone.so
clone=FORCE_PLUS_PERMANENT
如果您想要防止伺服器在沒有複製外掛程式的情況下執行,請使用 --clone
以及 FORCE
或 FORCE_PLUS_PERMANENT
的值,強制伺服器在如果外掛程式初始化失敗時啟動失敗。
有關外掛程式啟用狀態的更多資訊,請參閱控制外掛程式啟用狀態。