建置 Ruby 應用程式

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

設定您的開發系統以支援資料庫存取之後，請對應用程式中的資料庫連線和 SQL 敘述句編寫程式碼，以利用這些功能。

相關主題

建立應用程式的基本知識

配置您的 Ruby 開發系統

若要設定您的開發系統，讓您的 Ruby 應用程式能夠充分利用 Autonomous Database 的持續可用性和高效能功能，請執行下列步驟。

下載並安裝 Ruby。
下載並安裝 Oracle Instant Client。
下載並安裝 ruby-oci8。
下載資料庫的用戶端憑證，並將其提供給 Oracle Instant Client 使用。

Before You Begin - 開始之前

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

它必須能夠存取網際網路。
它必須具備 Autonomous Database 的網路存取權。

請參閱設定開發系統以存取資料庫

下載並安裝 Ruby

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

下載並安裝 Oracle Instant Client

下載並安裝適用於系統作業系統與架構的 Oracle Instant Client 基本套裝軟體：

Oracle Linux：

執行下列指令以下載和安裝 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。)
其他 OSes 與架構：
1. 請前往 Oracle Instant Client 下載項目頁面，選取您系統作業系統與架構的下載項目。
2. 在下載頁面上，接受 Oracle Technology Network License Agreement，下載最新版本的基本套件，然後依照下載頁面底部的指示進行安裝。

下載並安裝 ruby-oci8

若要將 ruby-oci8 介面下載並安裝到 Oracle Database，請依照安裝 Oracle Instant Client 頁面中的指示進行。

下載並安裝資料庫的從屬端證明資料

將包含您資料庫之從屬端證明資料的壓縮檔下載至您電腦上的安全目錄。

您可以從 Oracle Cloud 主控台中資料庫的「詳細資訊」頁面下載此壓縮檔。如果您有允許您存取此頁面的 Oracle Cloud 使用者帳戶，請下載下列證明資料。如果您沒有此帳戶，則必須從資料庫管理員取得 zip 檔案，以及用來保護 zip 檔案的密碼。
1. 在 Web 瀏覽器中，登入 Oracle Cloud 並瀏覽至 Autonomous Database 的「詳細資訊」頁面。
2. 按一下資料庫連線。
3. 在資料庫連線頁面上，按一下下載。
4. 在下載公事包對話方塊的密碼欄位中輸入公事包密碼，然後在確認密碼欄位中確認密碼。
  
  密碼的長度至少要有 8 個字元，而且至少必須包含 1 個字元、1 個數字字元或 1 個特殊字元。
5. 按一下下載，將用戶端憑證 zip 檔案儲存至安全目錄。
下載壓縮檔之後，請依照下列步驟進行：
1. 解壓縮從屬端證明資料壓縮檔。
2. 編輯從屬端證明資料中提供的 sqlnet.ora 檔案，以您解壓縮從屬端證明資料之目錄的完整路徑取代 "?/network/admin"；例如，變更：
```
(DIRECTORY="?/network/admin")
```
  到：
```
(DIRECTORY="/users/jdoe/adbcredentials")
```
3. 建立 TNS_ADMIN 環境變數，將其值設為您解壓縮從屬端證明資料的目錄完整路徑。

程式碼資料庫連線和 SQL 敘述句

設定您的開發系統以支援與 Autonomous Database 的 Ruby 應用程式連線之後，請遵循下列準則，以實現應用程式與資料庫連線的高效能和持續可用性：

使用連線集區。
啟用 FAN (快速應用程式通知)。
使用最符合您要執行之作業的預先定義資料庫服務。如需預先定義之資料庫服務的相關資訊，請參閱自治式資料庫的預先定義資料庫服務名稱。

舉例而言：

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

此範例可讓 FAN 將 events_mode 特性設為 true、建立 tp_tls 資料庫服務連線的集區，以及從集區取得連線。

其他資源

如需 ruby-oci8 的詳細資訊，請前往 Ruby-oci8 頁面。

標題與著作權資訊

Oracle 和 (或) 其關係企業。