1. RESTのためのSODA開発者ガイド
  2. RESTのためのSODAのインストール

2 RESTのためのSODAのインストール

RESTのためのSODAのインストールについて、すべての手順を説明します。

ノート:

SODA for RESTは、Oracle REST Data Services (ORDS)の一部として配布されます。Oracleでは、常に最新バージョンのORDSを使用することをお薦めします。

また、JSONデータにJSONデータ型を使用することをお薦めします。SODA for RESTで実行するには、ORDSバージョン20.4.1以降が必要です。また、データベース初期化パラメータcompatibleは、少なくとも20である必要があります(データベースはリリース21c以降である必要があります)。この場合、JSON型はデフォルトでSODAコレクションに使用されます。

SODA for RESTに必要なORDSの最小必須バージョンの詳細は、『Oracle Database Simple Oracle Document Access (SODA)の概要』のSODAドライバに関する項を参照してください。

  1. 次のOracle Databaseリリースのいずれかをインストールしていることを確認します。

    • Oracle Database 12cリリース2 (12.2)以降

    • マージ・ラベル・リクエスト(MLR)バンドル・パッチ20885778 (パッチ20885778がパッチ20080249を廃止)を使用したOracle Database 12cリリース1 (12.1.0.2)

      My Oracle Support (My Oracle Support)からこのパッチを取得します。「パッチと更新版」タブを選択します。パッチ番号20885778を検索するか、または次のURL: https://support.oracle.com/rs?type=patch&id=20885778に直接アクセスします。

  2. データベースを起動します。

  3. Oracle REST Data Services(ORDS)をダウンロードし、zipファイルを解凍します。

  4. ORDSを構成します。

    • データベースが標準ポート1521を使用している場合:

      java -jar ords.war install

    • データベースが非標準ポート(1521を除くすべてのポート)を使用している場合:

      java -jar ords.war install advanced

    ノート:

    画面に指示が表示されたら、次のようにします。

    • Oracle REST Data Servicesスキーマの検証/インストールのステップをスキップしないでください。

    • PL/SQLゲートウェイを構成するステップをスキップします。

    • Application ExpressのRESTfulサービスのデータベース・ユーザーを構成するステップをスキップします。

    • スタンドアロン・サーバーの起動を拒否します。

    • セキュリティを強化するために、少なくとも本番環境ではHTTPではなくHTTPSを選択します。

  5. ORDSでアクセスするデータベース・スキーマ(ユーザー・アカウント)に接続します。

  6. 次のSQLコマンドを実行して、そのデータベース・スキーマ内でORDSを有効にします。

    EXEC ords.enable_schema;
COMMIT;

  7. ロールSODA_APPを、ステップ6で有効にしたデータベース・スキーマ(ユーザー・アカウント) database-schemaに付与します。 

    GRANT SODA_APP TO database-schema;

  8. 開発環境の場合のみ、次の手順を実行します。

    1. デフォルトのセキュリティ制約を削除します。

      BEGIN
  ords.delete_privilege_mapping(
    'oracle.soda.privilege.developer',
    '/soda/*');
  COMMIT;
END;

      ノート:

      これにより、サービスへの匿名アクセスが有効になるため、本番システムではお薦めしません。

    2. スタンドアロン・モードでORDSを起動します。

      java -jar ords.war standalone

      ノート:

      スタンドアロン・モードでのORDSの実行は、本番システムではお薦めしません。

  9. Webブラウザで、次のページを開きます。

    http://localhost:8080/ords/database-schema/soda/latest/

    database-schemaは、ステップ6でORDSを有効にしたデータベース・スキーマの小文字の名前です。インストールが成功した場合は、次のように表示されます。 

    {"items":[],"more":false}

関連項目:

関連項目