构建 Ruby 应用程序

要构建访问自治 AI 数据库的 Ruby 应用，首先需要配置开发系统以支持数据库访问，以充分利用自治 AI 数据库的持续可用性和高性能特性。

将开发系统配置为支持数据库访问之后，您将在应用程序中编写数据库连接和 SQL 语句的代码，以利用这些功能。

配置您的 Ruby 开发系统

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

  1. 下载和安装 Ruby。

  2. 下载并安装 Oracle Instant Client。

  3. 下载并安装 ruby-oci8。

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

使用须知

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

下载并安装 Ruby

要下载并安装 Ruby，请转到 ruby-lang.org 上的 Installing Ruby 页面，并按照有关系统 OS 和体系结构的说明进行操作。

下载和安装 Oracle Instant Client

下载并安装适用于系统 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 。）

下载和安装 ruby-oci8

要将 ruby-oci8 接口下载并安装到 Oracle Database，请按照 Install for Oracle Instant Client 页中的说明进行操作。

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

  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 语句

将您的开发系统配置为支持与自治 AI 数据库的 Ruby 应用程序连接后，请遵循以下准则，以实现应用程序与数据库的连接的高性能和持续可用性：

例如：

require 'oci8'
OCI8.properties[:events_mode] = true
cpool = OCI8::ConnectionPool.new(1, 5, 2, username, password, 'tp_tls')
conn1 = OCI8.new(username, password, cpool)

此示例通过将 events_mode 属性设置为 true、创建用于连接到 tp_tls 数据库服务的池以及从池获取连接来启用 FAN。

相关内容