使用 Node.js 和其他脚本语言连接到 Autonomous Database

您可以使用各种语言(包括 Node.js、PHP、Ruby、R、Go 和 Perl)的程序连接到 Autonomous Database on Dedicated Exadata Infrastructure 。使用客户端身份证明强制实施安全性。

这些脚本语言具有使用 Oracle Call Interface 库的数据库访问 API 或驱动程序。Oracle Call Interface 库可以来自完整的 Oracle Client,也可以来自 Oracle Instant Client。

安装语言驱动程序和客户机库

要从脚本语言连接到 Autonomous Database on Dedicated Exadata Infrastructure ,请首先按如下方式安装语言驱动程序和客户端库:

  1. 安装 Instant Client 或完整客户机。完整客户端支持的最低版本为 11.2.0.4 版;对于 Oracle Instant Client,请使用 12.1.0.2 或更高版本:

    Instant Client 适用于大多数应用程序。要安装 Instant Client,请执行以下操作:

    1. 从“即时客户端下载”页中选择所需的体系结构,然后下载基本程序包(可在下载页上找到):Oracle Instant Client

      或者,如果 Basic Light 全球化限制适合您使用,请从所需的体系结构的下载页面下载 Basic Light 程序包。

    2. 如果要从源代码构建语言 API 或驱动程序,您可能还需要下载 Instant Client SDK:Oracle Instant Client

    3. 解压缩选定的基本程序包。例如,解压缩到 C:\instantclient_12_2 /home/myuser/instantclient_18_5.如果还下载了 SDK,请将其解压缩到同一目录中。

    4. 在 Windows 上,将 PATH 变量的路径添加到 "Environment Variables"(环境变量)窗格的 "System variables"(系统变量)部分(例如,添加 C:\instantclient_12_2)。在 Windows 8 上,通过导航到 "Control Panel"(控制面板)> "System"(系统)> "Advanced System Settings"(高级系统设置)> "Environment Variables"(环境变量)来访问 PATH 变量设置区域。如果安装了多个版本的 Oracle 库,请确保路径中首先出现新目录。

    5. 在非 Windows 平台上,创建符号链接(如果不存在)。例如:

      cd /home/myuser/instantclient_18_5
      ln -s libclntsh.so.18.1 libclntsh.so

      如果您的系统上没有其他将受到影响的 Oracle 软件,请将 Instant Client 添加到运行时链接路径。例如:

      sudo sh -c "echo /home/myuser/instantclient_18_5 > /etc/ld.so.conf.d/oic.conf"
      sudo ldconfig
      

      或者,在运行应用程序的每个 shell 中设置磁带库路径。例如:

      export LD_LIBRARY_PATH=/home/myuser/instantclient_18_5:$LD_LIBRARY_PATH

      注意:

      Linux Instant Client 下载文件可用作 .zip 文件或 .rpm 文件。可以使用任何版本。
  2. 安装 Oracle Database 的相关语言驱动程序:

启用 Oracle Network 连接并获取安全身份证明 (Oracle Wallet)

  1. 获取客户端安全身份证明以连接到 Autonomous Database 实例。获取一个 zip 文件,其中包含访问 Autonomous Database 所需的客户端安全凭证和网络配置设置。您必须保护此文件及其内容,以防止未经授权的数据库访问。获取客户机安全凭证文件,如下所示:

    • ADMIN 用户:单击 DB Connection(数据库连接)。请参见 Download Client Credentials

    • 其他用户(非管理员):从管理员获取 Autonomous Database 的 Oracle Wallet。

  2. 提取客户端身份证明 (wallet) 文件:

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

    2. 如果使用的是 Instant Client,请在 Instant Client 目录下创建 network/admin 子目录分层结构(如有必要)。然后将文件移动到此子目录。例如,根据体系结构或客户机系统以及安装 Instant Client 的位置,这些文件应位于以下目录中:

      C:\instantclient_12_2\network\admin

      或者

      /home/myuser/instantclient_18_5/network/admin

      或者

      /usr/lib/oracle/18.5/client64/lib/network/admin
      • 如果使用的是完整的 Oracle Client,请将该文件移动到 $ORACLE_HOME/network/admin

    3. 或者,将解压缩的 wallet 文件放在安全目录中,并将 TNS_ADMIN 环境变量设置为该目录名称。

    注意:

    从 zip 文件中,仅需要以下文件:tnsnames.orasqlnet.oracwallet.ssoewallet.p12

运行应用程序

  1. 使用数据库用户名、密码和 Oracle Net 连接名称(在解压缩的 tnsnames.ora 文件中指定)更新应用程序以进行连接。例如,用户 atpc_userpasswordatpc_low 作为连接字符串。

  2. 或者,更改 tnsnames.ora 中的连接字符串以匹配应用程序使用的字符串。

  3. 运行应用程序。