18.5.5 例: MySQLでのREST対応SQLサービス参照の作成

リモートMySQLデータベースに対するREST対応SQLサービス参照を作成する例を確認します。

次の例では、ベースURL http://server.example.com:8080/ords/mysqldbを使用して、MySQL REST Enabled SQL Exampleという名前の架空のREST対応SQLサービス参照を作成します。

ヒント:

REST対応SQL参照を作成する前に、開発者は、「開始する前に: REST対応SQLサービスの要件」で説明されている要件を満たす必要があります

MySQLデータベースへのREST対応SQLサービス参照を作成するには:

1. REST対応SQLページにナビゲートします。
   1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。
   2. 「ワークスペース・ユーティリティ」をクリックします。
   3. 「ワークスペース・ユーティリティ」ページで、「REST対応SQLサービス」をクリックします。
2. REST対応SQLページで、「作成」をクリックします。
3. 「一般」の場合:
   1. 名前 - このREST対応SQLサービスのわかりやすい名前を入力します。 たとえば:

      MySQL REST Enabled SQL Example

   2. エンドポイントURL - このREST対応SQLサービスのベースURLを入力します。たとえば:

      http://server.example.com:8080/ords/mysql/

      
      図rest_enabled_sql_general_mysql.pngの説明
   3. 「次」をクリックします。
4. 「認証」の場合:
   1. 資格証明 - 認証のための既存の資格証明を選択します。たとえば: 新しい資格証明を作成するには、「- 新規入力 -」を選択します。
   2. 資格証明名 - 資格証明のわかりやすい名前を入力します。たとえば:

      Credentials for MySQL REST Enabled SQL Example

   3. 資格証明の格納 - デフォルト(有効)を受け入れます。無効にすると、ユーザー名とパスワードとして空の値が格納された名前付き資格証明が作成されます。REST対応SQL参照を使用するには、APEX_CREDENTIAL.SET_SESSION_CREDENTIALSプロシージャを使用してAPEXセッションに資格証明を設定する必要があります。
   4. ユーザー名 - 基本認証の場合は、データベース・ユーザー名を入力します。

      ヒント:

      MySQLユーザー名はほとんどの場合小文字であるため、「大/小文字が区別されるユーザー名」属性を有効にします。
   5. パスワード - パスワードを入力します。この情報は、暗号化して保存されており、クリア・テキストで取得できません。
   6. パスワードの確認 - パスワードを再入力して、入力を検証します。
   7. 大/小文字が区別されるユーザー名 - 大/小文字を区別するユーザー名を格納するには、このスイッチを有効にします。それ以外の場合、ユーザー名は大文字に変換されます。通常、ユーザー名はOracleデータベースでは大文字ですが、ほとんどの場合、MySQLユーザー名は小文字になります。
   
   図rest_enabled_sql_auth_mysql.pngの説明
5. 「作成」をクリックします。

   APEXで、REST対応SQLサービスがテストされます。すべてが正しく実行された場合(つまり、正しいURL、スキーマ名およびパスワードを指定した場合)、次のイメージに示すように「REST対応SQLサービスのテスト」メッセージが表示されます。

   
   図test_rest_enabled_ref_mysql.pngの説明
6. デフォルト・データベースの設定 -
   1. 「デフォルト・データベース」リストから、このMySQL REST対応SQL参照の操作に使用するデータベースを選択します。
   2. 「デフォルト・データベースの設定」をクリックします。
7. 「閉じる」をクリックします。

REST対応SQLサービス参照がREST対応SQLページに表示されます。