本节介绍 MySQL JavaScript 连接器的基本安装和设置及其先决条件。连接器要求先安装 Node.js 和 NDB Cluster;您可以按任意顺序安装它们。此外,mysql-js
适配器需要 node-mysql
驱动程序。构建连接器还需要您的系统拥有可用的 C++ 编译器,例如 gcc 或 Microsoft Visual Studio。
要安装 JavaScript 连接器的所有先决条件,包括 node-mysql
,您应该执行以下步骤
-
Node.js. 如果您的系统上尚未安装 Node.js,您可以从 https://node.org.cn/download/ 获取它。除了源代码外,还提供了一些平台的预构建二进制文件和安装程序。许多 Linux 发行版在其存储库中也有 Node.js(您可能需要在您的包管理器中添加一个备用存储库)。
NDB
使用 node-gyp 编译附加的 Node.js 模块;有关此工具的更多信息,请参见 https://npmjs.net.cn/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 Connector for 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 服务器。mysql 客户端可执行文件必须位于路径中。
要运行测试套件,请更改到 test
目录,然后执行此处所示的命令
$> node driver
默认情况下,所有服务器都在本地机器上使用默认端口运行;这可以通过编辑文件 test/test_connection.js
来更改,该文件是通过运行测试套件生成的。如果该文件不存在(请参见错误 #16967624),您可以将 share/nodejs/test/lib/test_connection_js
复制到 test
目录以实现此目的。
如果您将 NDB Cluster 安装到非默认位置,您可能需要导出 LD_LIBRARY_PATH
以启用测试套件。测试套件还需要 MySQL 服务器上存在 test
数据库。