本節說明如何安裝和設定 clone 外掛程式。對於遠端複製操作,必須在捐贈者和接收者 MySQL 伺服器執行個體上安裝 clone 外掛程式。
如需安裝或解除安裝外掛程式的一般資訊,請參閱第 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
重新啟動伺服器會引發錯誤 [ERROR] [MY-013238] [Server] Error installing plugin 'clone': Cannot install during upgrade.([錯誤] [MY-013238] [伺服器] 安裝外掛程式 'clone' 時發生錯誤:無法在升級期間安裝。)。為了避免發生這種情況,請在嘗試使用 plugin-load-add=mysql_clone.so
啟動伺服器之前升級伺服器。
或者,若要在執行階段載入外掛程式,請使用此陳述式,並根據您的平台調整 .so
字尾
INSTALL PLUGIN clone SONAME 'mysql_clone.so';
INSTALL PLUGIN
會載入外掛程式,並將其註冊在 mysql.plugins
系統表格中,以便在每次後續正常伺服器啟動時載入外掛程式,而無需使用 --plugin-load-add
。
若要驗證外掛程式安裝,請檢查資訊結構描述 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 |
+------------------------+---------------+
如果外掛程式初始化失敗,請檢查伺服器錯誤日誌中是否有與 clone 或外掛程式相關的診斷訊息。
如果外掛程式先前已向 INSTALL PLUGIN
註冊,或使用 --plugin-load-add
載入,您可以在伺服器啟動時使用 --clone
選項來控制外掛程式的啟用狀態。例如,若要在啟動時載入外掛程式並防止其在執行階段被移除,請使用這些選項
[mysqld]
plugin-load-add=mysql_clone.so
clone=FORCE_PLUS_PERMANENT
如果您想要防止伺服器在沒有 clone 外掛程式的情況下執行,請使用 --clone
並設定值為 FORCE
或 FORCE_PLUS_PERMANENT
,以便在外掛程式未成功初始化時強制伺服器啟動失敗。
有關外掛程式啟動狀態的更多資訊,請參閱控制外掛程式啟動狀態。