6.4 オブジェクト・ブラウザからRESTオブジェクトを有効にする方法
ワークスペースのホームページからオブジェクト・ブラウザにアクセスするには、「SQLワークショップ」、「オブジェクト・ブラウザ」の順にクリックします。
- オブジェクト・ブラウザからのRESTオブジェクトの有効化について
オブジェクト・ブラウザからのRESTオブジェクトの有効化について説明します。 - オブジェクト・ブラウザからのRESTオブジェクトの有効化
TABLE、VIEW、PACKAGE、PROCEDUREまたはFUNCTIONを選択すると、オブジェクト・ブラウザに新しい「REST」タブが表示されます。このタブには、ORDSを使用してデータベース・オブジェクトをREST対応にする機能を持つフォームが表示されます。
親トピック: RESTfulサービスを使用したデータ交換の有効化
6.4.1オブジェクト・ブラウザからのRESTオブジェクトの有効化について
オブジェクト・ブラウザからのRESTオブジェクトの有効化について説明します。
Oracle REST Data Services (ORDS) 17.4以降を使用するOracle Application Express 19.1のインストール環境では、ORDSのAutoREST機能を使用してデータベース・オブジェクトをREST対応にする機能がサポートされています。AutoRESTを使用すると、表、ビュー、パッケージ、プロシージャおよびファンクションをREST対応にすることができます。AutoRESTはRESTを介してデータベース・オブジェクトを公開するための最も迅速な方法ですが、この機能は柔軟性とカスタマイズしやすさに難点があります。AutoRestによってデータを素早く公開できますが、(例えた言い方をすると)ガイド・レールのセットに乗せてしまいます。たとえば、出力形式や入力形式をカスタマイズできず、追加の検証も実行できません。
6.4.2 オブジェクト・ブラウザからのRESTオブジェクトの有効化
TABLE、VIEW、PACKAGE、PROCEDUREまたはFUNCTIONを選択すると、オブジェクト・ブラウザに新しい「REST」タブが表示されます。このタブには、ORDSを使用してデータベース・オブジェクトをREST対応にする機能を持つフォームが表示されます。
オブジェクト・ブラウザからRESTオブジェクトを有効にするには、次の手順に従います。
- ワークスペースのホームページで、「SQLワークショップ」をクリックして、「オブジェクト・ブラウザ」をクリックします。
- オブジェクト・タイプのリストから、「表」を選択します。
- 「REST」タブをクリックします。
注意:
スキーマがORDS RESTfulデータ・サービスに登録されていない場合。スキーマを登録するようにメッセージが表示されます。
- 「RESTfulサービス」をクリックします。
「RESTfulサービス」ホームページが表示されます。
- 「ORDSにスキーマを登録」をクリックします。
「ORDSスキーマ属性」ダイアログが表示されます。
- 属性の詳細で、スキーマ内のRESTfulサービスを参照するURLの作成に使用するスキーマ別名の名前を入力し、他のすべてのオプションはデフォルト値のままにします。
- オブジェクト・タイプのリストから、「表」を選択します。
表の詳細がORDSバージョンとともに表示され、オブジェクトをAutoREST対応にするためのフォームが表示されます。
- 「適用」をクリックします。
成功メッセージが表示され、フォームに新しい「RESTful URI」フィールドが表示されます。
RESTful URI - REST対応オブジェクトへのアクセスに使用される、大/小文字が区別されるURIが表示されます。
- 「RESTful URI」の右隅にある
ボタンをクリックします。 - 新しいブラウザ・タブを開き、コピーしたURIをURLリージョンに貼り付けて[Enter]を押します。
選択した表の表データを公開するJSONドキュメントが、ブラウザに表示されます。
注意:
オブジェクトがREST対応になると、提供されたURIを使用してデータにアクセスできます。
- 新しい「認可ロール」フィールドが表示され、AutoREST対応オブジェクトに関連付けられているORDSで作成されたロールが示されます。
注意:
オブジェクトのRESTful URIにアクセスしようとすると、401 - Unauthorizedというエラー・メッセージが表示されます。
