MySQL Shell 8.4  /  ...  /  持續化擴充物件

10.2.3 持續化擴充物件

定義和註冊擴充物件的腳本,其檔案副檔名必須為 .js (針對 JavaScript 程式碼) 或 .py (針對 Python 程式碼),以符合腳本所使用的語言。檔案副檔名不區分大小寫。

持續化擴充物件的偏好方式是將其新增至 MySQL Shell 外掛程式。外掛程式和外掛程式群組會在 MySQL Shell 啟動時自動載入,而它們所定義和註冊的函式會立即生效。在 MySQL Shell 外掛程式中,包含初始化腳本的檔案名稱必須為 init.jsinit.py,以符合該語言。一個外掛程式只能包含一種語言的程式碼,因此如果您要使用混合 Python 和 JavaScript 定義的成員來建立擴充物件,則必須將這些成員儲存為個別的語言適用的外掛程式。如需使用 MySQL Shell 外掛程式的說明,請參閱第 10.3 節,「MySQL Shell 外掛程式」

或者,包含擴充物件的腳本可以直接儲存在 MySQL Shell 使用者組態路徑中的 init.d 資料夾中。當 MySQL Shell 啟動時,會自動處理 init.d 資料夾中所有副檔名為 .js.py 的檔案,並使它們註冊的函式生效。(在此位置,檔案名稱對 MySQL Shell 而言並不重要。)Unix 上預設的 MySQL Shell 使用者組態路徑為 ~/.mysqlsh/,而 Windows 上則為 %AppData%\MySQL\mysqlsh\。使用者組態路徑可以在所有平台上透過定義環境變數 MYSQLSH_USER_CONFIG_HOME 來覆寫。