1. <ProductName> REST APIOracle REST Data Services API
  2. クイック・スタート

クイック・スタート

.

ステップ1: Oracle REST Data Servicesのインストールと構成

データ・ディクショナリ、環境、一般、監視、パフォーマンスおよびプラガブル・データベースのライフサイクル管理エンドポイントは、Oracle REST Data Services (ORDS)によって提供されます。ORDSはOracle Databaseインストールに含まれており、$ORACLE_HOMEのORDSディレクトリにあります。

ORDSによって提供されるエンドポイントを使用する前に、次のタスクを実行します。

  1. ORDSのインストール: ORDSをインストールおよび構成するには、Oracle REST Data Servicesの構成とインストールを参照してください。
  2. データベースREST APIの有効化:デフォルトでは、ORDSデータベースAPI機能はORDSを初めてインストールするときは無効になっています。Oracle REST Data Services (ORDS) Database APIを有効にするには、ORDS Database APIの有効化を参照してください。
  3. スタンドアロン・モードでのORDSの起動: スタンドアロン・モードでOracle REST Data Servicesを起動する場合は、スタンドアロン・モードでの実行を参照してください。
  4. スキーマのREST対応: REST対応SQLサービスを使用するOracleデータベース・スキーマで、Oracleデータベース・スキーマをREST対応にする必要があります。Oracle DatabaseスキーマのREST対応を参照してください。管理者スキーマがORDS対応であり、DBAまたはDBAおよびPDB_DBAロールが付与されていることを確認します。

ORDSエンドポイントにアクセスしている場合、REST対応スキーマ・ユーザー資格証明を関連データベース・アカウント・パスワードとともに指定します。

ORDSは、Oracle REST Data Servicesダウンロードから別製品としてダウンロードできます。

ステップ2: cURLのインストール

このドキュメントで使用される例は、cURLコマンドライン・ツールを使用して、Oracle Database REST APIにアクセスする方法を示しています。RESTサーバーに安全に接続するには、SSLをサポートするcURLのバージョンをインストールする必要があります

cURLをシステムにインストールするには、次の手順を実行します。

  1. ブラウザで、http://curl.haxx.seにあるcURLホーム・ページに移動し、ナビゲーション・メニューの「Download」をクリックします。

  2. cURLの「Releases and Downloads」ページで、使用するオペレーティング・システム用のSSL対応バージョンcURLソフトウェアを探します。ZIPファイルをダウンロードするリンクをクリックして、目的のフォルダに実行可能ファイルを解凍します。

Windowsコマンド・シェルからcURLを実行している場合のみ、Verisign社のCS証明書に対して認証される、SSL認証局(CA)ファイルまたはバンドルを提供する必要があります。

  1. 「cURL CA Extract」ページ(http://curl.haxx.se/docs/caextract.html)にナビゲートし、cURLをインストールしたフォルダにcacert.pem SSL CA証明書ファイルをダウンロードします。

  2. コマンド・ウィンドウを開いて、cURLをインストールしたディレクトリにナビゲートし、cURL環境変数CURL_CA_BUNDLEをSSL CA証明書ファイルの場所に設定します。たとえば、Windowsシステムでは、次のように入力します。

    C:\curl> set CURL_CA_BUNDLE=cacert.pem

これで、cURLを使用してDatabase Rest APIインスタンスにRESTリクエストを送信する準備が整いました。認証およびcURLの使用を参照してください。