Oracle Cloud Infrastructureドキュメント

Rubyアプリケーションの構築

Autonomous DatabaseにアクセスするRubyアプリケーションを構築するには、まず、Autonomous Databaseの継続的な可用性および高パフォーマンスの機能を利用できるデータベース・アクセスをサポートするように開発システムを構成します。

データベース・アクセスをサポートするように開発システムを構成した後、これらの機能を利用するように、アプリケーション内のデータベース接続およびSQL文をコーディングします。

Ruby開発システムの構成

RubyアプリケーションがAutonomous Databaseの継続的可用性および高パフォーマンスの機能を利用できるように開発システムを構成するには、次のステップを実行します。

  1. Rubyをダウンロードしてインストールします。
  2. Oracle Instant Clientをダウンロードしてインストールします。
  3. ruby-oci8をダウンロードしてインストールします。
  4. データベースのクライアント資格証明をダウンロードして、Oracle Instant Clientで使用できるようにします。

始める前に

開発システムを正常に構成するためには、それが特定の基準を満たしている必要があります。

Rubyのダウンロードとインストール

Rubyをダウンロードしてインストールするには、ruby-lang.orgにある「Rubyのインストール」ページに移動し、使用しているシステムのOSおよびアーキテクチャ用の手順に従います。

Oracle Instant Clientのダウンロードとインストール

使用しているシステムのOSおよびアーキテクチャ用のOracle Instant Client Basicパッケージをダウンロードしてインストールします:

  • Oracle Linux:

    次のコマンドを実行して、Oracle Instant Client Basicパッケージをダウンロードしてインストールします:

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

    (すべてのインスタント・クライアント・パッケージのリストを確認するには、http://yum.oracle.com/repo/OracleLinux/OL7/oracle/instantclient/x86_64/index.htmlに移動します。)

  • その他のOSesおよびアーキテクチャ:

    1. 「Oracle Instant Clientのダウンロード」ページに移動し、使用しているシステムのOSおよびアーキテクチャ用のダウンロードを選択します。

    2. ダウンロード・ページで、Oracle Technology Networkライセンス契約に同意し、最新バージョンのBasicパッケージをダウンロードしてから、ダウンロード・ページの下部にある指示に従ってインストールします。

ruby-oci8のダウンロードとインストール

ruby-oci8インタフェースをダウンロードしてOracle Databaseにインストールするには、「Oracle Instant Clientのインストール」ページの手順に従います。

データベースのクライアント資格証明のダウンロードとインストール

  1. データベースのクライアント資格証明を含むzipファイルをコンピュータ上の安全なディレクトリにダウンロードします。

    このzipファイルは、Oracle Cloudコンソールのデータベースの「詳細」ページからダウンロードできます。次のように資格証明をダウンロードします。

    1. WebブラウザでOracle Cloudにログインし、Autonomous Databaseの詳細ページに移動します。

    2. 「DB接続」をクリックします。

    3. 「データベース接続」ページで、「ダウンロード」をクリックします。

    4. 「ウォレットのダウンロード」ダイアログで、「パスワード」フィールドにウォレット・パスワードを入力し、「パスワードの確認」フィールドでパスワードを確認します。

      パスワードは8文字以上の長さで、少なくとも1つの文字と、1つの数字または1つの特殊文字を含める必要があります。

    5. 「ダウンロード」をクリックして、クライアント資格証明zipファイルを安全なディレクトリに保存します。

  2. zipファイルをダウンロードした後は、次のステップに従います:

    1. クライアント資格証明zipファイルを解凍します。

    2. クライアント資格証明内に提供されているsqlnet.oraファイルを編集し、"?/network/admin"を、クライアント資格証明の解凍先ディレクトリのフルパスに置き換えます。例: 変更前: 

      (DIRECTORY="?/network/admin")

      変更後:

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

    3. TNS_ADMIN環境変数を作成し、その値をクライアント資格証明の解凍先ディレクトリのフルパスに設定します。

データベース接続およびSQL文のコーディング

Autonomous DatabaseへのRubyアプリケーション接続をサポートするように開発システムを構成したら、次のガイドラインに従って、データベースへのアプリケーション接続の高パフォーマンスおよび継続的可用性を実現します:

  • 接続プールを使用します。
  • FAN (高速アプリケーション通知)を有効にします。
  • 実行する操作に最も適した事前定義済データベース・サービスを使用します。事前定義済データベース・サービスの詳細は、Autonomous Databaseの事前定義済データベース・サービス名を参照してください。

例:

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データベース・サービスへの接続用のプールを作成して、そのプールから接続を取得します。

その他のリソース

ruby-oci8の詳細は、Ruby-oci8ページを参照してください。