文件首頁
MySQL 9.0 參考手冊
相關文件 下載本手冊
PDF (美式信紙) - 40.0Mb
PDF (A4) - 40.1Mb
Man Pages (TGZ) - 258.2Kb
Man Pages (Zip) - 365.3Kb
Info (Gzip) - 4.0Mb
Info (Zip) - 4.0Mb


MySQL 9.0 參考手冊  /  ...  /  安裝 Clone 外掛程式

7.6.7.1 安裝 Clone 外掛程式

本節說明如何安裝和設定 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 並設定值為 FORCEFORCE_PLUS_PERMANENT,以便在外掛程式未成功初始化時強制伺服器啟動失敗。

有關外掛程式啟動狀態的更多資訊,請參閱控制外掛程式啟動狀態