DBMS_EPG
パッケージは、WebブラウザからHTTPリスナーを介してPL/SQLストアド・プロシージャを起動できる、埋込みのPL/SQLゲートウェイを実装します。
この章では、次の項目について説明します。
概要
セキュリティ・モデル
例外
構成サブプログラム
認証サブプログラム
DBMS_EPG
パッケージは、PL/SQLユーザーがPL/SQL Webアプリケーションを開発およびデプロイするためのプラットフォームです。埋込みPL/SQLゲートウェイは、Oracle DatabaseのXMLデータベースHTTPサーバー内で実行されるゲートウェイの埋込みバージョンです。これにより、データベース内でmod_plsql
のコア機能が提供されますが、Oracle HTTP Server powered by Apacheは必要ありません。
ブラウザからHTTPを介してPL/SQLアプリケーションにアクセスできるようにするには、データベース・アクセス記述子(DAD)を作成して仮想パスにマップする必要があります。DADは、データベース・アクセスに使用される一連の構成値で、仮想パス・マッピングによって、XML DB HTTPサーバーの仮想パスのもとでのアプリケーションへのアクセスが可能になります。DADは、XML DB HTTPサーバー内ではサーブレットとして表示されます。
DBMS_EPG
パッケージは、TABLE
タイプを定義します。
DBMS_EPGは、2つのインタフェースで構成されています。
構成サブプログラム・グループには、埋込みPL/SQLゲートウェイのグローバル設定とデータベース・アクセス記述子(DAD)固有の設定を検証および変更するためのサブプログラム・インタフェースが含まれています。
表65-2 構成サブプログラム・グループ
サブプログラム | 説明 |
---|---|
|
新規DADを作成します。 |
|
DAD属性を削除します。 |
|
グローバル属性を削除します。 |
|
DADを削除します。 |
|
DADのすべての属性を取得します。 |
|
指定したDADがマップされる仮想パスをすべて取得します。 |
GET_ALL_GLOBAL_ATTRIBUTESプロシージャ |
すべてのグローバル属性およびグローバル値を取得します。 |
|
DAD属性の値を取得します。 |
|
埋込みゲートウェイ・インスタンス用のすべてのDADのリストを取得します。 |
|
グローバル属性の値を取得します。 |
|
指定した仮想パスにDADをマップします。 |
|
DADの値を設定します。 |
|
グローバル属性の値を設定します。 |
|
指定した仮想パスからDADをマッピング解除します。 |
表65-4 DBMS_EPGパッケージのサブプログラム
サブプログラム | 説明 |
---|---|
|
データベース・ユーザーの権限を使用してプロシージャを起動し、ドキュメント表にアクセスするためのDADを認証します。 |
|
新規DADを作成します。 |
|
データベース・ユーザーの権限を使用してプロシージャを起動し、ドキュメント表にアクセスするためのDADを認証解除します。 |
|
DAD属性を削除します。 |
|
グローバル属性を削除します。 |
|
DADを削除します。 |
|
DADのすべての属性を取得します。 |
|
指定したDADがマップされる仮想パスをすべて取得します。 |
GET_ALL_GLOBAL_ATTRIBUTESプロシージャ |
すべてのグローバル属性およびグローバル値を取得します。 |
|
DAD属性の値を取得します。 |
|
埋込みゲートウェイ・インスタンス用のすべてのDADのリストを取得します。 |
|
グローバル属性の値を取得します。 |
|
指定した仮想パスにDADをマップします。 |
|
DADの値を設定します。 |
|
グローバル属性の値を設定します。 |
|
指定した仮想パスからDADをマッピング解除します。 |
このプロシージャは、データベース・ユーザーの権限を使用してプロシージャを起動し、ドキュメント表にアクセスするためのDADを認証します。実行者は、常に自身の権限の使用を認証することができます。
このプロシージャは、データベース・ユーザーの権限を使用してプロシージャを起動し、ドキュメント表にアクセスするためのDADを認証解除します。実行者は、常に自身の権限の使用を認証解除することができます。
このプロシージャは、DADのすべての属性を取得します。名前/値ペア形式の、相関関係にある2つの索引付き表が出力されます。
構文
DBMS_EPG.GET_ALL_DAD_ATTRIBUTES ( dad_name IN VARCHAR2, attr_names OUT NOCOPY VARCHAR2_TABLE, attr_values OUT NOCOPY VARCHAR2_TABLE);
このプロシージャは、すべてのグローバル属性およびグローバル値を取得します。名前/値ペア形式の、相関関係にある2つの索引付き表が出力されます。
構文
DBMS_EPG.GET_ALL_GLOBAL_ATTRIBUTES ( attr_names OUT NOCOPY VARCHAR2_TABLE, attr_values OUT NOCOPY VARCHAR2_TABLE);
このプロシージャは、DADの値を設定します。
構文
DBMS_EPG.SET_DAD_ATTRIBUTE ( dad_name IN VARCHAR2, attr_name IN VARCHAR2, attr_value IN VARCHAR2);
パラメータ
表65-18 SET_DAD_ATTRIBUTEプロシージャのパラメータ
パラメータ | 説明 |
---|---|
|
属性を設定するDADの名前。 |
|
設定する属性の名前。 |
|
設定する属性値。 |
表65-19 mod_plsql DAD属性と埋込みPL/SQLゲートウェイDAD属性間のマッピング
mod_plsql DAD属性 | 埋込みPL/SQLゲートウェイDAD属性 | 複数回の出現を許可 | 有効な値 |
---|---|---|---|
|
|
いいえ |
文字列 |
|
|
いいえ |
On、Offの列挙 |
|
|
いいえ |
Basic、SingleSignOn、GlobalOwa、CustomOwa、PerPackageOwaの列挙 |
|
|
いいえ |
文字列 |
|
|
はい |
符号なしの整数 |
|
|
はい |
符号なしの整数 |
|
|
はい |
文字列 |
|
|
いいえ |
符号なしの整数 |
|
|
いいえ |
文字列 |
|
|
いいえ |
文字列 |
|
|
いいえ |
文字列 |
|
|
いいえ |
文字列 |
|
|
いいえ |
文字列 |
|
|
いいえ |
ApacheStyle、ModplsqlStyle、DebugStyleの列挙 |
|
|
はい |
文字列 |
|
|
いいえ |
符号なしの整数 |
|
|
いいえ |
InfoDebugの列挙 |
|
|
いいえ |
On、Offの列挙 |
|
|
いいえ |
符号なしの整数 |
|
|
いいえ |
文字列 |
|
|
いいえ |
文字列 |
|
|
いいえ |
文字列 |
|
|
いいえ |
文字列 |
|
|
いいえ |
文字列 |
|
|
いいえ |
StatelessWithResetPackageState、StatelessWithFastRestPackageState、StatelessWithPreservePackageStateの列挙 |
|
|
いいえ |
CHAR、RAWの列挙 |
|
|
いいえ |
文字列 |
このプロシージャは、グローバル属性の値を設定します。