构建 Node.js 应用程序

要构建访问自治 AI 数据库的 Node.js 应用，请首先配置开发系统来支持数据库访问，以利用自治 AI 数据库的持续可用性和高性能功能。

配置开发系统后，您可以在应用程序中编写数据库连接和 SQL 语句的代码，以利用持续可用性和高性能功能。

提示：有关阅读以下主题的“试用”替代方案，您可以浏览 Oracle Autonomous AI Database Dedicated for Developers and Database Users Workshop 中的 Lab 3:Build and Deploy Node.js Application 。

配置 Node.js 开发系统

要将您的开发系统配置为 Node.js 应用可以利用自治 AI 数据库的持续可用性和高性能功能，请执行以下步骤。

  1. 下载并安装 Node.js。

  2. 下载并安装 Oracle Instant Client。

  3. 下载并安装 node-oracledb。

  4. 下载数据库的客户端身份证明并将其提供给 Oracle Instant Client。

使用须知

您的开发系统必须满足某些标准才能成功配置。

下载和安装 Node.js

下载并安装适用于系统 OS 和体系结构的 Node.js：

sudo yum install -y oracle-release-el7 oracle-nodejs-release-el7
sudo yum install -y nodejs

下载和安装 Oracle Instant Client

您需要 Oracle Instant Client 库版本 19.6 或更高版本。

下载并安装适用于系统 OS 和体系结构的 Oracle Instant Client 基本程序包：

sudo yum -y install oracle-release-el7
sudo yum -y install oracle-instantclient19.3-basic

（如果要查看所有 Instant Client 软件包的列表，请转至 http://yum.oracle.com/repo/OracleLinux/OL7/oracle/instantclient/x86_64/index.html 。）

下载和安装 node-oracledb

下载并安装适用于您系统 OS 和体系结构的 Node.js 的 node-oracledb 附加组件：

sudo yum install -y oracle-release-el7 oracle-nodejs-release-el7
sudo yum install -y node-oracledb-node10

下载并安装数据库的客户端身份证明

  1. 将包含数据库客户端身份证明的 zip 文件下载到计算机上的安全目录。

    可以从 Oracle Cloud 控制台中数据库的“详细信息”页下载此 zip 文件。如果您的 Oracle Cloud 用户账户允许您访问此页，请按如下方式下载身份证明。如果您没有这样的帐户，则需要从数据库的管理员那里获取 zip 文件，以及用于保护 zip 文件的密码。

    1. 在 Web 浏览器中，登录到 Oracle Cloud 并导航到自治 AI 数据库的“详细信息”页面。

    2. 单击 DB Connection 。

    3. 在数据库连接页上，单击下载。

    4. 在 Download Wallet（下载 Wallet）对话框中，在 Password（口令）字段中输入 wallet 密码，然后在 Confirm Password（确认口令）字段中输入该口令。

      密码长度必须至少为 8 个字符，并且必须至少包含 1 个字母和 1 个数字字符或 1 个特殊字符。

    5. 单击 Download（下载）以将客户端凭据 zip 文件保存到安全目录。

  2. 下载 zip 文件后，请执行以下步骤：

    1. 解压缩客户端身份证明 zip 文件。

    2. 编辑客户端身份证明中提供的 sqlnet.ora 文件，将 "?/network/admin" 替换为您解压缩客户端身份证明的目录的完整路径；例如，更改：

       (DIRECTORY="?/network/admin")

      到：

       (DIRECTORY="/users/jdoe/adbcredentials")

    3. 创建 TNS_ADMIN 环境变量，将其值设置为解压缩客户机凭证的目录的完整路径。

代码数据库连接和 SQL 语句

将您的开发系统配置为支持 Node.js 应用连接到自治 AI 数据库后，请执行以下步骤，以确保应用能够以最佳性能使用数据库：

  1. 将对 node-oracledb 附加组件的依赖性添加到应用程序的 package.json 文件中。

  2. 实现高性能和持续可用性的代码连接。

添加 node-oracledb Dependency topackage.json

编辑应用程序 package.json 文件中的 dependencies 对象，添加 oracledb 软件包和版本。（使用命令 npm init 生成 package.json（如果不存在）。例如：

. . .
"dependencies": {
  . . .,
 "oracledb": "^4.0",
  . . .
},
. . .

有关 dependencies 对象的详细信息，请参见 npm-package.json 页面。要显示已安装的 oracledb 版本，可以使用 npm list 命令；例如：

npm list -g --depth=0

实现高性能和持续可用性的代码连接

要实现高性能和持续可用性，请在连接到数据库时遵循以下准则：

例如：

pool = await oracledb.createPool({
  events: true,
  user: "appuser",
  password: process.env.MY_PASSWORD_ENV_VAR,
  connectString: "tp_tls"
});

此示例为与 tp_tls 数据库服务的连接创建池，并通过将 events 属性设置为 true 来启用 FAN。

相关内容