建置 Ruby 應用程式

若要建置可存取自治式 AI 資料庫的 Ruby 應用程式，請先設定開發系統以支援資料庫存取，以利用自治式 AI 資料庫的持續可用性和高效能功能。

將開發系統設定為支援資料庫存取之後，您就可以編寫應用程式中的資料庫連線和 SQL 陳述式，以利用這些功能。

設定您的 Ruby 開發系統

若要設定您的開發系統，讓 Ruby 應用程式能夠利用自治式 AI 資料庫的持續可用性和高效能功能，請執行下列步驟。

  1. 下載和安裝 Ruby。

  2. 下載並安裝 Oracle Instant Client。

  3. 下載並安裝 ruby-oci8。

  4. 下載資料庫的從屬端證明資料，並讓它們可供 Oracle Instant Client 使用。

Before You Begin - 開始之前

您的開發系統必須符合特定條件，才能順利進行設定。

下載並安裝 Ruby

若要下載並安裝 Ruby，請前往 ruby-lang.org 的 Installing Ruby 頁面，然後依照您系統作業系統和架構的指示進行。

下載並安裝 Oracle Instant Client

下載並安裝適用於您系統作業系統和架構的 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. 將包含您資料庫之從屬端證明資料的壓縮檔下載至您電腦上的安全目錄。

    您可以從 Oracle Cloud 主控台中資料庫的「詳細資訊」頁面下載此壓縮檔。如果您有一個允許您存取此頁面的 Oracle Cloud 使用者帳戶，請下載下列證明資料。如果您沒有這樣的帳戶，您必須將 zip 檔案與資料庫管理員取得，以及用來保護 zip 檔案的密碼一起取得。

    1. 在 Web 瀏覽器中，登入 Oracle Cloud 並瀏覽至「自治式 AI 資料庫」的「詳細資訊」頁面。

    2. 按一下資料庫連線。

    3. 在資料庫連線頁面中，按一下下載。

    4. 在下載公事包對話方塊中，於密碼欄位中輸入一個公事包密碼，然後在確定密碼欄位中確認該密碼。

      密碼長度至少必須包含 8 個字元，且必須包含至少 1 個字母及 1 個數字字元或 1 個特殊字元。

    5. 按一下下載，將從屬端證明資料壓縮檔儲存至安全目錄。

  2. 下載壓縮檔之後，請遵循下列步驟：

    1. 解壓縮從屬端證明資料壓縮檔。

    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 以啟用 FAN、為 tp_tls 資料庫服務的連線建立集區，以及從集區取得連線。

相關內容