1. SQLワークショップ・ガイド
  2. RESTfulサービスを使用したデータ交換の有効化
  3. RESTfulサービスにアクセスする方法

7.4 RESTfulサービスにアクセスする方法

SQLワークショップからRESTfulサービスにアクセスします。

親トピック: RESTfulサービスを使用したデータ交換の有効化

7.4.1 RESTfulサービスへのアクセス

ワークスペースのホームページからRESTfulサービスにアクセスするには、「SQLワークショップ」、「RESTfulサービス」の順にクリックします。

RESTfulサービスにアクセスするには:

  1. ワークスペースのホームページで、「SQLワークショップ」をクリックします。
  2. 「RESTfulサービス」をクリックします。
    r_service.pngの説明が続きます
    図r_service.pngの説明

    「RESTfulサービス」ホームページが表示されます。

関連項目:

ORDS RESTfulサービス・モジュールの作成

親トピック: RESTfulサービスにアクセスする方法

7.4.2 ORDSへのスキーマの登録

新しいワークスペースでORDS RESTfulサービスにアクセスする場合は、ORDS RESTful Data Servicesにスキーマを登録する必要があります。

ORDS RESTful Data Servicesを使用してスキーマを登録するには:

  1. ワークスペースのホームページで、「SQLワークショップ」をクリックします。
  2. 「RESTfulサービス」をクリックします。

    「RESTfulサービス」ホームページが表示されます。

  3. 「ORDSベースのRESTfulサービス」をクリックします。

    ORDS RESTfulサービス・ページが表示されます。スキーマがORDS RESTfulデータ・サービスに登録されていない場合は、「ORDSに登録されていないスキーマ」というメッセージが表示されます

  4. 「ORDSにスキーマを登録」をクリックします。

    「ORDSスキーマ属性」ダイアログが表示されます。

    ノート:

    デフォルト・スキーマとして複数のワークスペースに割り当てられているスキーマをORDS対応にすると、ワークスペース関連の静的ファイルで問題が発生します。

    ords_schema_attributes.pngの説明が続きます。
    図ords_schema_attributes.pngの説明
  5. 属性の詳細を入力します。
    1. RESTfulアクセスの有効化 - スキーマに定義されているRESTサービスへのアクセスを有効にするには「オン」を選択し、無効にするには「オフ」を選択します。
    2. スキーマ別名 - スキーマ内のRESTfulサービスを参照するURLの形成に使用されるスキーマ別名の名前を入力します。
    3. サンプル・サービスのインストール - 「オン」または「オフ」を選択します。「オン」を選択すると、サンプルのoracle.example.hr RESTfulサービスがインストールされます。
    4. メタデータ・アクセスに必要な認可 - 「オン」または「オフ」を選択します。「オン」を選択すると、スキーマのORDSメタデータ・カタログへのアクセスを許可する前に、Oracle REST Data Servicesでユーザーの認可が必要になります。
  6. 「スキーマ属性の保存」をクリックします。

    ORDS RESTfulページが表示され、ORDS RESTfulサービスで使用するスキーマが有効で、サンプルのRESTfulサービスが正常にインストールされたというメッセージが表示されます。

親トピック: RESTfulサービスにアクセスする方法

7.4.3 ORDS RESTfulサービス・ダッシュボードについて

ORDS RESTfulサービス・ダッシュボードについて学習します。

ORDSへのスキーマの登録時に、ORDS RESTfulサービス・ダッシュボード・ページが表示され、ORDSのバージョンが表示されます。

restful_services_dashboard.pngの説明が続きます
図restful_services_dashboard.pngの説明
次の表に、ORDS RESTfulサービス・ダッシュボードで使用可能な情報を示します。
名前 説明
ORDSバージョン ORDSのバージョン。
ORDSからのスキーマの登録解除 クリックすると、スキーマが登録解除されます。
サンプル・サービスのリセット

クリックすると、インストールされたサンプル・サービスがリセットされます。

ノート: 「サンプル・サービスのリセットの検証」ダイアログが表示され、サービスが完全に削除されて再作成されることを警告します。

インポート クリックすると、SQL DeveloperまたはOracle APEXによって生成されたSQLスクリプトからORDSベースのRESTfulサービス定義がインポートされます。
エクスポート

クリックすると、ORDSベースのRESTfulサービス・メタデータがSQLスクリプト・ファイル形式にエクスポートされます。

ノート: ORDS 18.3以上を実行している場合は、「スキーマの有効化を含める」および「権限を含める」フィールドが表示されます。

スキーマの有効化を含める - (デフォルト: 有効)エクスポートされるスクリプトにORDS.ENABLE_SCHEMA文を含めるかどうかを指示します。

権限を含める - (デフォルト: 有効)エクスポートされるスクリプトに、選択したモジュールに関連付けられた権限定義を含めるかどうかを指示します(保護されたモジュール、ロールおよびリソース・パターンを含む)。

構成

クリックすると、ORDSスキーマ属性が構成されます。

ノート: デフォルト・スキーマとして複数のワークスペースに割り当てられているスキーマをORDS対応にすると、ワークスペース関連の静的ファイルで問題が発生します。
スキーマ・アクセス スキーマ内に定義されたRESTfulサービスへのアクセスが有効か無効かが表示されます。
メタデータ・アクセス このスキーマのORDSメタデータ・カタログへのアクセスを許可する前に、Oracle REST Data Servicesでユーザーの認可が必要になるかどうかが表示されます。
別名が指定されたスキーマ 現行のスキーマの別名が表示されます。
モジュール スキーマ内に定義されているモジュールの合計数が表示されます。クリックすると、定義済のモジュールのリストが表示されます。
権限 定義済の権限の合計数が表示されます。クリックすると、定義済の権限のリストが表示されます。
ロール 関連付けられたロールの合計数が表示されます。クリックすると、関連付けられたロールが表示されます。
有効なオブジェクト スキーマ内のREST対応データベース・オブジェクトの合計数が表示されます。クリックすると、REST対応オブジェクトのリストが表示されます。
モジュール・ステータス 公開済のモジュールと未公開のモジュールのステータスが表示されます。
モジュールのセキュリティ 保護されているモジュールと保護されていないモジュールのステータスが表示されます。
オブジェクト別名 別名指定済のオブジェクトと別名未指定のオブジェクトのステータスが表示されます。

親トピック: RESTfulサービスにアクセスする方法