本節涵蓋 MySQL JavaScript 連接器的基本安裝和設定及其先決條件。連接器需要先安裝 Node.js 和 NDB Cluster;您可以依任何順序安裝它們。此外,mysql-js
轉接器需要 node-mysql
驅動程式。建置連接器也需要您的系統具有可運作的 C++ 編譯器,例如 gcc 或 Microsoft Visual Studio。
若要安裝 JavaScript 連接器的所有先決條件,包括 node-mysql
,您應執行下列步驟
-
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
的值來判斷。 -
NDB Cluster。 如果系統上尚未安裝 NDB Cluster,包括所有標頭和程式庫檔案,請安裝它(請參閱NDB Cluster 安裝)。
如先前所述,您必須確保 NDB Cluster 和 Node.js 的架構(32 位元或 64 位元)相同。您可以檢查 ndb_mgm -V 的輸出中現有 NDB Cluster 安裝的架構。
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 伺服器上可用。