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.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 的值来确定这一点。

  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 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 数据库。