5.2 安裝 JavaScript 連接器

本節涵蓋 MySQL JavaScript 連接器的基本安裝和設定及其先決條件。連接器需要先安裝 Node.js 和 NDB Cluster;您可以依任何順序安裝它們。此外,mysql-js 轉接器需要 node-mysql 驅動程式。建置連接器也需要您的系統具有可運作的 C++ 編譯器,例如 gcc 或 Microsoft Visual Studio。

若要安裝 JavaScript 連接器的所有先決條件,包括 node-mysql,您應執行下列步驟

  1. Node.js。  如果您的系統上尚未安裝 Node.js,您可以從 https://node.dev.org.tw/download/ 取得。除了原始碼之外,還有多個平台的預先建置二進位檔案和安裝程式可用。許多 Linux 發行版在其儲存庫中也有 Node.js(您可能需要在套件管理員中新增替代儲存庫)。

    NDB 使用 node-gyp 編譯附加的 Node.js 模組;如需此工具的詳細資訊,請參閱 https://npmjs.org/package/node-gyp

    從 NDB 8.0.22 開始,NDBCLUSTER 需要 Node.js 12.18.3 或更新版本。從 NDB 8.0.33 開始,最低要求的 Node.js 版本是 18.12.1。

    無論您以何種方式取得 Node.js,請記住您安裝的版本架構必須與您打算使用的 NDB Cluster 二進位檔案架構相符;例如,您無法使用 64 位元 Node.js 和 32 位元 NDB Cluster 安裝 JavaScript 連接器。如果您不知道現有 Node.js 安裝的架構,您可以檢查 global.process.arch 的值來判斷。

  2. NDB Cluster。  如果系統上尚未安裝 NDB Cluster,包括所有標頭和程式庫檔案,請安裝它(請參閱NDB Cluster 安裝)。

    如先前所述,您必須確保 NDB Cluster 和 Node.js 的架構(32 位元或 64 位元)相同。您可以檢查 ndb_mgm -V 的輸出中現有 NDB Cluster 安裝的架構。

  3. node-mysql 驅動程式。  mysql-js 轉接器也需要來自 https://github.com/felixge/node-mysql/node-mysql 驅動程式的可運作安裝。您可以使用 Node.js npm install 命令安裝驅動程式;請參閱專案網站以取得建議的版本和套件識別碼。

一旦滿足剛才列出的需求,您可以在 NDB Cluster 安裝目錄中的 share/nodejs 中找到安裝 MySQL JavaScript 連接器所需之檔案。(如果您以 RPM 格式安裝 NDB Cluster,則為 /usr/share/mysql/nodejs。)若要使用 Node.js npm 工具執行無需任何使用者干預的「最佳猜測」安裝,請變更至 share/nodejs 目錄,然後如下所示使用 npm

$> npm install .

最後一個句點 (.) 字元是必要的。請注意,您必須在 NDB Cluster 安裝目錄中的 share/node.js 中執行此命令。

您可以使用提供的測試程式測試您的安裝。這需要執行中的 NDB Cluster,包括具有名為 test 的資料庫的 MySQL Server。mysql 用戶端可執行檔必須位於路徑中。

若要執行測試套件,請變更至 test 目錄,然後執行此處顯示的命令

$> node driver

預設情況下,所有伺服器都在本機上使用預設連接埠執行;您可以透過編輯檔案 test/test_connection.js 來變更此設定,該檔案是執行測試套件時產生的。如果此檔案尚未存在(請參閱錯誤 #16967624),您可以將 share/nodejs/test/lib/test_connection_js 複製到 test 目錄以達到此目的。

如果您將 NDB Cluster 安裝到非預設位置,您可能需要匯出 LD_LIBRARY_PATH 以啟用測試套件。測試套件也需要 test 資料庫在 MySQL 伺服器上可用。