88 DBMS_RLMGR

DBMS_RLMGRパッケージには、Rules Managerを使用してルールおよびルール・セッションを作成および管理する様々なプロシージャが含まれています。

Rules Managerサブプログラムの要約

表88-1に、DBMS_RLMGRパッケージのサブプログラムを示します。

特に明記されていないかぎり、DBMS_RLMGRパッケージに定義されているプロシージャに渡されるすべての値と名前で、大/小文字は区別されません。大/小文字の区別を保つには、値を二重引用符で囲んでください。

表88-1 DBMS_RLMGRパッケージのサブプログラム

サブプログラム	説明
ADD_ELEMENTARY_ATTRIBUTEプロシージャ	指定の属性をイベント構造（Expression Filterの属性セット）に追加します。
ADD_EVENTプロシージャ	アクティブなセッションのルール・クラスにイベントを追加します。
ADD_FUNCTIONSプロシージャ	イベント構造（Expression Filterの属性セット）を含むファンクションの承認リストに、ファンクション、タイプまたはパッケージを追加します。
ADD_RULEプロシージャ	ルール・クラスにルールを追加します。
CONSUME_EVENTファンクション	イベント識別子を使用してイベントをコンシュームし、対応するルールをアクションの実行用に準備します。
CONSUME_PRIM_EVENTSファンクション	1つ以上のプリミティブ・イベントを悉無律セマンティクスに基づいてコンシュームします。
CREATE_EVENT_STRUCTUREプロシージャ	イベント構造を作成します。
CREATE_RULE_CLASSプロシージャ	ルール・クラスを作成します。
DELETE_RULEプロシージャ	ルール・クラスのルールを削除します。
DROP_EVENT_STRUCTUREプロシージャ	イベント構造を削除します。
DROP_RULE_CLASSプロシージャ	ルール・クラスを削除します。
GRANT_PRIVILEGEプロシージャ	ルール・クラスに対する権限を他のユーザーに付与します。
PROCESS_RULESプロシージャ	指定したイベントのルールを処理します。
RESET_SESSIONプロシージャ	データベース・セッション内で、新しいルール・セッションを開始します。
REVOKE_PRIVILEGEプロシージャ	ルール・クラスに対するユーザー権限を取り消します。

ADD_ELEMENTARY_ATTRIBUTEプロシージャ

このプロシージャは、指定の属性をイベント構造（Expression Filterの属性セット）に追加します。このプロシージャはオーバーロードされています。複数の機能を構文形式ごとに、定義とともに示します。

構文

指定の要素属性を属性セットに追加します。

DBMS_RLMGR.ADD_ELEMENTARY_ATTRIBUTE (
              event_struct   IN   VARCHAR2,
              attr_name      IN   VARCHAR2,
              attr_type      IN   VARCHAR2,
              attr_defvl     IN   VARCHAR2 default NULL);

表の別名である要素属性を識別して、イベント構造に追加します。

DBMS_RLMGR.ADD_ELEMENTARY_ATTRIBUTE (
              event_struct   IN   VARCHAR2,
              attr_name      IN   VARCHAR2,
              tab_alias      IN   rlm$table_alias);

パラメータ

表88-2 ADD_ELEMENTARY_ATTRIBUTEプロシージャのパラメータ

パラメータ	説明
`event_struct`	この属性を追加するイベント構造（属性セット）の名前。
`attr_name`	追加する要素属性の名前。同じセット内の2つの属性に同じ名前を指定することはできません。
`attr_type`	属性のデータ型。この引数には、標準のSQLデータ型、または現行のユーザーがアクセス可能なオブジェクト・タイプの名前を指定できます。
`tab_alias`	属性の別名を設定するデータベース表を識別する型。
`attr_defv1`	要素属性のデフォルト値。

使用上の注意

このプロシージャは、要素属性をイベント構造に追加します。イベント構造は、Expression Filterの属性セットとして内部的に管理されます。最初に既存のオブジェクト・タイプから作成されたイベント構造には、他の属性は追加できません。

式が格納されている列にすでに割り当てられている属性セットには、要素属性は追加できません（この属性セットは、ルール・クラスで使用されるイベント構造と同じです）。
属性セット内の1つ以上またはすべての要素属性は、表の別名として使用できます。要素属性が表の別名である場合、その要素属性に割り当てられる値は、対応する表のROWIDです。表の別名属性が1つ以上ある属性セットは、既存のオブジェクト・タイプからは作成できません。表の別名の詳細は、『Oracle Databaseアプリケーション開発者ガイド-Rules ManagerおよびExpression Filter』の付録Aを参照してください。
式が格納されている列にすでに割り当てられている属性セットには、要素属性は追加できません。
要素属性の追加の詳細は、『Oracle Databaseアプリケーション開発者ガイド-Rules ManagerおよびExpression Filter』の属性セットの定義に関する項を参照してください。
関連ビュー: USER_EXPFIL_ATTRIBUTE_SETSおよびUSER_EXPFIL_ATTRIBUTES。

例

次のコマンドでは、2つの要素属性が属性セットに追加されます。

BEGIN
  DBMS_RLMGR.ADD_ELEMENTARY_ATTRIBUTE (
                               event_struct  => 'HRAttrSet',
                               attr_name => 'HRREP',
                               attr_type => 'VARCHAR2(30)');
  DBMS_RLMGR.ADD_ELEMENTARY_ATTRIBUTE (
                               event_struct  => 'HRAttrSet',
                               attr_name => 'DEPT',
                               tab_alias => exf$table_alias('DEPT'));
END;

ADD_EVENTプロシージャ

このプロシージャは、アクティブなルール・セッションのルール・クラスにプリミティブ・イベントを追加します。このプロシージャはオーバーロードされています。複数の機能を構文形式ごとに、定義とともに示します。

構文

プリミティブ・イベント・インスタンスの文字列表現をルール・クラスに追加します。

DBMS_RLMGR.ADD_EVENT (
   rule_class      IN VARCHAR2,
   event_inst      IN VARCHAR2,
   event_type      IN VARCHAR2 default null);

プリミティブ・イベント・インスタンスのAnyData表現をルール・クラスに追加します。

DBMS_RLMGR.ADD_EVENT (
   rule_class      IN VARCHAR2,
   event_inst      IN sys.AnyData);

パラメータ

表88-3 ADD_EVENTプロシージャのパラメータ

パラメータ	説明
`rule_class`	ルール・クラスの名前。スキーマ拡張したルール・クラス名を使用すると、現行のスキーマに属していないルール・クラスを参照できます。
`event_inst`	ルール・クラスに追加するイベント・インスタンスの文字列表現またはAnyData表現。
`event_type`	`event_inst`引数に割り当てられたイベント・インスタンスのタイプ（コンポジット・イベント用に構成されたルール・クラスに対してイベント・インスタンスの文字列表現を使用する場合）。

使用上の注意

このプロシージャは、アクティブなルール・セッション内のルール・クラスにプリミティブ・イベントまたは単純イベントを追加するために使用します。デフォルトでは、ルール・セッションはデータベース・セッションと同じです。オプションで、RESET_SESSIONまたはPROCESS_RULESプロシージャを使用して、複数の（連続する）ルール・セッションをデータベース・セッション内で開始できます。
ルール・クラスが（1つのみのプリミティブ・イベント構造で構成されている）単純イベント用に構成されている場合は、ADD_EVENTプロシージャのevent_type引数を無視できます。また、イベント・インスタンスをAnyData形式で渡す場合は、イベント・タイプ情報がAnyDataインスタンスに埋め込まれます。それ以外の場合は、ルール・クラスに追加するプリミティブ・イベント構造の名前をevent_type引数に割り当てる必要があります。
ADD_EVENTプロシージャは、イベント・インスタンスが有効な場合、ルール・クラスのルールを処理し、それらの結果を（ルール・クラスの作成時に構成される）ルール・クラスの結果ビューに取得します。これらの結果は、ルール・セッションが終了するまで保持されます。スキーマ拡張した名前をルール・クラスに使用する場合は、ルール・クラスに対するPROCESS RULES権限が必要です。詳細は、「GRANT_PRIVILEGEプロシージャ」を参照してください。event_type引数に指定する値は、ルール・クラスの所有者のスキーマ内で常に解決され、スキーマ拡張した名前は使用できません。コンポジット・イベント構造が表の別名のプリミティブ・イベント・タイプで構成されている場合は、対応する表の名前をevent_type引数に割り当てる必要があります。

例

次のコマンドでは、2種類のプリミティブ・イベント（AddFlightおよびAddRentalCar）用に構成されているCompTravelPromoルール・クラスに2つのイベントが追加されます。

BEGIN
 DBMS_RLMGR.ADD_EVENT(rule_class => 'CompTravelPromo',
                     event_inst =>
                        AddFlight.getVarchar(987, 'Abcair', 'Boston',
                                         'Orlando', '01-APR-2003', '08-APR-2003'),
                     event_type => 'AddFlight');

DBMS_RLMGR.ADD_EVENT(rule_class => 'Scott.CompTravelPromo',
                     event_inst =>
                        AnyData.convertObject(
                                        AddRentalCar(987, 'Luxury', '03-APR-2003',
                                                     '08-APR-2003', NULL)));
END;

ADD_FUNCTIONSプロシージャ

このプロシージャは、ファンクションの集合を表すユーザー定義ファンクション、パッケージ、またはタイプをイベント構造（Expression Filterの属性セット）に追加します。

構文

DBMS_RLMGR.ADD_FUNCTIONS (
   event_struct   IN   VARCHAR2,
   funcs_name     IN   VARCHAR2);

パラメータ

表88-4 ADD_FUNCTIONSプロシージャのパラメータ

パラメータ	説明
`event_struct`	ファンクションを追加するイベント構造の名前。
`funcs_name`	（ファンクションの集合を表す）ファンクション、パッケージまたはタイプの名前またはそのシノニム。

使用上の注意

デフォルトでは、属性セットによって、ルール条件で使用されるオラクル社提供のすべてのSQLファンクションを暗黙的に参照できます。式セットでユーザー定義ファンクションを参照する場合は、その式セットが属性セットに明示的に追加されている必要があります。
ADD_FUNCTIONSプロシージャは、ファンクションの集合を表すユーザー定義ファンクション、パッケージまたはタイプを属性セットに追加します。新しい式または変更された式は、このリストを使用して有効性が検証されます。
ファンクションまたはパッケージの名前は、スキーマ拡張を使用して指定できます。スキーマ拡張を使用せずにファンクション名を指定した場合、ルール条件ではスキーマ拡張を使用していない参照のみが有効であるとみなされます。条件式は、ファンクションまたはパッケージにシノニムを使用するように制限できます。そのためには、対応するシノニムを属性セットに追加します。これによって、他のスキーマに対する式セットの移植性が保持されます。
属性セットにファンクションを追加する方法の詳細は、『Oracle Databaseアプリケーション開発者ガイド-Rules ManagerおよびExpression Filter』の属性セットの定義に関する項を参照してください。
関連ビュー: USER_EXPFIL_ATTRIBUTE_SETSおよびUSER_EXPFIL_ASET_FUNCTIONS。

例

次のコマンドでは、2つのファンクションが属性セットに追加されます。

BEGIN
  DBMS_RLMGR.ADD_FUNCTIONS (attr_set   => 'Car4Sale',
                             funcs_name => 'HorsePower');
  DBMS_RLMGR.ADD_FUNCTIONS (attr_set   => 'Car4Sale',
                             funcs_name => 'Scott.CrashTestRating');
END;

ADD_RULEプロシージャ

このプロシージャは、ルール・クラスに新しいルールを追加します。

構文

DBMS_RLMGR.ADD_RULE (
   rule_class      IN  VARCHAR2,
   rule_id         IN  VARCHAR2,
   rule_cond       IN  VARCHAR2,
   actprf_nml      IN  VARCHAR2 DEFAULT NULL,
   actprf_vall     IN  VARCHAR2 DEFAULT NULL);

パラメータ

表88-5 ADD_RULEプロシージャのパラメータ

パラメータ	説明
`rule_class`	ルール・クラスの名前。スキーマ拡張したルール・クラス名を使用すると、現行のスキーマに属していないルール・クラスを参照できます。
`rule_id`	ルール・クラス内のルールの一意の識別子。
`rule_cond`	ルールの条件。条件では、ルール・クラスのイベント構造で定義された変数が使用されます。
`actprf_nml`	`actprf_vall`引数によって値が割り当てられるアクション・プリファレンス名のリスト。
`actprf_vall`	`actprf_nml`引数に割り当てられる名前リストに対するアクション・プリファレンス値のリスト。

使用上の注意

このプロシージャは、ルール・クラスに新しいルールを追加するために使用します。ADD_RULEプロシージャに渡されるルール条件は、ルール・クラスに関連付けられたイベント構造を使用して検証されます。アクション・プリファレンス名のリストは、ルール・クラスの作成時に構成されたアクション・プリファレンス・カテゴリのサブセットです。
スキーマ拡張した名前をルール・クラスに使用する場合は、ルール・クラスに対するADD RULE権限が必要です。詳細は、「GRANT_PRIVILEGEプロシージャ」を参照してください。
ルール・クラスの所有者が、（ルール・クラスと同じ名前の）ルール・クラス表に対してSQL INSERT文を使用してルールを追加することもできます。また、ルール・クラスの所有者は、ルール・クラス表に対する直接DML権限を他のユーザーに付与することもできます。

注意:
ADD_RULEプロシージャではなくSQL INSERT文を使用して新しいルールを追加する場合、ルール・クラスのAUTOCOMMITプロパティは無視されます。
ルール・クラス表の構造については、「CREATE_RULE_CLASSプロシージャ」を参照してください。

例

次のコマンドでは、ルール・クラスにルールが追加されます。

BEGIN
DBMS_RLMGR.ADD_RULE (
           rule_class => 'CompTravelPromo',
           rule_id => 'AB_AV_FL',
           rule_cond =>
             '<condition>
                 <and join="Flt.CustId = Car.CustId">
                    <object name="Flt">
                      Airline=''Abcair'' and ToCity=''Orlando''
                    </object>
                    <object name="Car">
                      CarType = ''Luxury''
                    </object>
                  </and>
               </condition>' ,
             actprf_nml => 'PromoType, OfferedBy',
             actprf_vall => '''RentalCar'', ''Acar''');
END;

適切な権限がある場合は、次のSQL INSERT文を使用してルールをルール・クラスに追加できます。

INSERT INTO CompTravelPromo (rlm$ruleid, rlm$rulecond, PromoType, OfferedBy)
  VALUES ('AB_AV_FL',
          '<condition>
             <and join="Flt.CustId = Car.CustId">
               <object name="Flt">
                   Airline=''Abcair'' and ToCity=''Orlando''
               </object>
               <object name="Car">
                   CarType = ''Luxury''
               </object>
             </and>
           </condition>',
          'RentalCar','Acar');

CONSUME_EVENTファンクション

このファンクションは、イベントをコンシュームし、対応するルールをアクションの実行用に準備します。これは、アクション（ルールの実行）がコールバックによってではなく、ユーザーのアプリケーションによって行われる場合にのみ必要です。

構文

DBMS_RLMGR.CONSUME_EVENT (
   rule_class       IN VARCHAR2,
   event_ident      IN VARCHAR2)
 RETURN NUMBER;

パラメータ

表88-6 CONSUME_EVENTファンクションのパラメータ

パラメータ	説明
`rule_class`	ルール・クラスの名前。スキーマ拡張したルール・クラス名を使用すると、現行のスキーマに属していないルール・クラスを参照できます。
`event_ident`	対応するルール・クラスの結果ビュー（RULEベースのコンシューム・ポリシー用に構成されるルール・クラスの場合はアクション・コールバック・プロシージャの引数）から取得されるイベント識別子。

戻り値

このファンクションは、次の値を戻します。

1: イベントが正常にコンシュームされた場合
0: イベントが（継続時間ポリシーによって）期限切れになったか、またはこのコールの前に別のセッションによってコンシュームされた場合

使用上の注意

ルール・クラスのイベントに対してEXCLUSIVEコンシューム・ポリシーが設定されている場合、そのイベントは、一致するルール（アクション）の実行直後にシステムから削除する必要があります。PROCESS_RULESプロシージャをコールしてルール・アクションをルール・クラスのコールバック・プロシージャで実行する場合、イベントのコンシュームは、Rules Managerによって自動的に処理されます。ただし、ADD_EVENTプロシージャを使用して、イベントとルールの一致結果をルール・クラスの結果ビューに要求する場合は、適切なアクションを実行して、ルールの実行に使用するルールとイベントの組合せを正確に示す必要があります。CONSUME_EVENTファンクションは、ルールの実行に使用するイベントの一意な識別子が渡されると、必要なハウスキーピング・サービスを実行します。
結果と一致するルール・クラスのフェッチと、ユーザーが開始するアクションの実行の間でタイム・ラグが発生する可能性があるため、アプリケーションでは、CONSUME_EVENTコールで正常にイベントがコンシュームされる場合にのみこのアクションを実行する必要があります。これによって、パラレル・セッションで同じイベントがコンシュームされる競合状態を回避できます。イベントが正常にコンシュームされると、このコールは1を戻します。その他の場合は、0（ゼロ）を戻します。戻り値が0（ゼロ）の場合、そのイベントは、別のセッションによってすでにコンシュームされているため、このセッションでは使用できないことを意味します。
CONSUME_EVENTファンクションは、EXCLUSIVEコンシューム・ポリシーで構成されているイベントを削除します。コンシューム・ポリシーで構成されているイベントに対しては何も行いません。
ルール・クラス・レベルで決定されるEXCLUSIVEおよびSHAREDコンシューム・ポリシーとは異なり、RULEコンシューム・ポリシーを使用すると、ルールに基づいてイベントのコンシュームを決定できます。つまり、ルールが一致した場合にイベントがシステムから削除されるようにルール・クラスのルールのサブセットを構成できます。同時に、その他のルール・セットでは、対応するアクションの実行後も、イベントをシステム内にそのまま残すこともできます。この場合、アプリケーション開発者が実装するアクション・コールバック・プロシージャは、（適切な引数で）CONSUME_EVENTファンクションをコールし、特定のルールに対するイベントを条件付きでコンシュームできます。RULEコンシューム・ポリシー用に構成されたルール・クラスについては、「CONSUME_PRIM_EVENTSファンクション」の使用方法に関する項も参照してください。

例

次のコマンドでは、ルールの実行で使用されるイベントが識別され、その識別子を使用してイベントがコンシュームされます。

var eventid VARCHAR(40);
var evtcnsmd NUMBER;

BEGIN
  SELECT rlm$eventid INTO :eventid FROM MatchingPromos WHERE rownum < 2;

  -- carry the required action for a rule matched by the above event --
  :evtcnsmd := DBMS_RLMGR.CONSUME_EVENT(rule_class  => 'TravelPromotion',
                                        event_ident => :eventid);
END;

CONSUME_PRIM_EVENTSファンクション

このファンクションは、RULEベースのコンシューム・ポリシーで構成されたルール・クラスの場合、悉無律セマンティクスに基づいて一連のプリミティブ・イベントをコンシュームします。

構文

DBMS_RLMGR.CONSUME_PRIM_EVENTS (
   rule_class       IN VARCHAR2,
   event_idents     IN RLM$EVENTIDS)
 RETURN NUMBER;

パラメータ

表88-7 CONSUME_PRIM_EVENTSファンクションのパラメータ

パラメータ	説明
`rule_class`	ルール・クラスの名前。スキーマ拡張したルール・クラス名を使用すると、現行のスキーマに属していないルール・クラスを参照できます。
`event_ident`	対応するルール・クラスの結果ビューまたはアクション・コールバック・プロシージャの引数から取得されたイベント識別子。

戻り値

このファンクションは、次の値を戻します。

1: すべてのイベント（渡されたイベント識別子）が正常にコンシュームされた場合
0: 1つ以上のプリミティブ・イベントをコンシュームできなかった場合

使用上の注意

ルール・クラスがRULEベースのコンシューム・ポリシー用に構成されている場合は、CONSUME_PRIM_EVENTSファンクションを使用して、コンポジット・イベントを構成する1つ以上のプリミティブ・イベントをコンシュームできます。この操作は、渡したすべてのイベントが有効で、コンシューム可能な場合にのみ正常に実行されます。ユーザーが開始するアクションは、CONSUME_PRIM_EVENTSコールの戻り値をチェックした後で実行する必要があります。

例

次のコマンドは、RULEコンシューム・ポリシー用に構成されたルール・クラスのアクション・コールバック・プロシージャの本体を示しています。ここでは、CONSUME_PRIM_EVENTSプロシージャを使用して、一致するルールに対するアクションを実行する前にイベントをコンシュームする方法を示します。

create or replace procedure PromoAction (
      Flt        AddFlight,
      Flt_EvtId  ROWID,    --- rowid for the flight primitive event
      Car        AddRentalCar,
      Car_EvtId  ROWID,
      rlm$rule   TravelPromotions%ROWTYPE) is
  evtcnsmd   NUMBER;
BEGIN
  evtcnsmd := DBMS_RLMGR.CONSUME_PRIM_EVENTS(
                    rule_class   => 'TravelPromotions',
                    event_idents => RLM$EVENTIDS(Flt_EvtId, Car_EvtId));

  if (evtcnsmd = 1) then
    -- consume operation was successful; perform the action ---
    OfferPromotion (Flt.CustId, rlm$rule.PromoType, rlm$rule.OfferedBy);
  end if;
END;

CREATE_EVENT_STRUCTUREプロシージャ

このプロシージャは、イベント構造を作成します。

構文

DBMS_RLMGR.CREATE_EVENT_STRUCTURE  (
   event_struct  IN  VARCHAR2);

パラメータ

表88-8 CREATE_EVENT_STRUCTUREプロシージャのパラメータ

パラメータ	説明
`event_struct`	現行のスキーマ内に作成するイベント構造の名前。

使用上の注意

このプロシージャは、現行のスキーマ内にダミーのイベント構造を作成します。このイベント構造には、ADD_ELEMENTARY_ATTRIBUTEプロシージャを使用して1つ以上の属性を追加できます。

例

次のコマンドでは、イベント構造が作成されます。

BEGIN
  DBMS_RLMGR.CREATE_EVENT_STRUCT(event_struct => 'AddFlight');
END;

CREATE_RULE_CLASSプロシージャ

このプロシージャは、ルール・クラスを作成します。

構文

DBMS_RLMGR.CREATE_RULE_CLASS  (
   rule_class      IN  VARCHAR2,
   event_struct    IN  VARCHAR2,
   action_cbk      IN  VARCHAR2,
   actprf_spec     IN  VARCHAR2  default null,
   rslt_viewnm     IN  VARCHAR2  default null,
   rlcls_prop      IN  VARCHAR2  default <simple/>);

パラメータ

表88-9 CREATE_RULE_CLASSプロシージャのパラメータ

パラメータ	説明
`rule_class`	現行のスキーマ内に作成するルール・クラスの名前。
`event_struct`	ルール・クラスのイベント構造を表す、現行のスキーマ内のオブジェクト・タイプまたはExpression Filterの属性セットの名前。
`action_cbk`	ルール・クラスに対して作成するアクション・コールバック・プロシージャの名前。
`actprf_spec`	ルール・クラスに関連付けられているアクション・プリファレンスの仕様（名前とSQLデータ型の組合せ）。
`rlst_viewnm`	セッション内の一致するイベントとルールが表示されるルール・クラスの結果ビューの名前。この名前のビューが現行のスキーマ内に作成されます。
`rlcls_prop`	ルール・クラスのプロパティを設定するためのXML文書。デフォルトでは、ルール・クラスは単純イベント（非コンポジット）用に作成されます。

使用上の注意

ルール・クラスを正常に作成するには、ビュー、オブジェクト・タイプ、表、パッケージおよびプロシージャを作成するための十分な権限が必要です。
このコマンドは、ルール・クラスおよびその依存オブジェクトをユーザーのスキーマ内に作成します。この操作を正常に実行するには、イベント構造に指定する名前が、ユーザーのスキーマ内の既存のオブジェクト・タイプまたはExpression Filter属性セットを指している必要があります。イベント構造にオブジェクト・タイプを使用すると、CREATE_RULE_CLASSプロシージャは、オブジェクト・タイプの属性セットを暗黙的に作成します。また、コンポジット・イベント用に構成されるルール・クラスの場合、このプロシージャは、イベント構造のオブジェクト・タイプ（または属性セット）に直接組み込まれるオブジェクト・タイプの属性セットも作成します。コンポジット・ルール・クラスで使用されるイベント構造では、最大32個の埋込みオブジェクトまたは表の別名（あるいはその両方）を指定できます。このプロシージャで作成される依存オブジェクトのタイプおよび構造は、ルール・クラスおよびそのイベント構造のプロパティによって異なります。ルール・クラスに対して作成される最小セットの依存オブジェクトは、次のとおりです。
- ルール・クラス表: ルールの定義（ルール識別子、ルール条件、ルールの説明およびアクション・プリファレンス）を格納するために、ルール・クラスと同じ名前のルール・クラス表がユーザーのスキーマ内に作成されます。この表には、rlm$ruleid、rlm$rulecond、rlm$ruledescの3つの列が暗黙的に含まれ、rlm$ruleidにはルール識別子、rlm$rulecondにはルール条件、rlm$ruledescにはルールの説明が格納されます。ルール・クラス表には、これらの3つの列に加えて、ルール・クラスのアクセス・プリファレンス仕様に基づくいくつかの列があります。たとえば、ルール・クラスTravelPromotionでそのアクセス・プリファレンス仕様（actpref_spec引数に割当て）として'PromoType VARCHAR(20), OfferedBy VARCHAR(20)'が使用される場合は、次の構造を持つルール・クラス表が作成されます。
```
TABLE TravelPromotion (
      rlm$ruleid VARCHAR(100),     -- rule identifier column --
      PromoType VARCHAR(20),       -- access preference 1 --
      OfferedBy VARCHAR(20),       -- access preference 2 --
      rlm$rulecond VARCHAR(4000),  -- rule condition –-
      rlm$ruledesc VARCHAR(1000)); -- rule description --
```
  ルール・クラス表の構造は、そのルール・クラスに対して指定されたアクション・プリファレンス・カテゴリのリストに厳密に基づき、ルール・クラスごとに異なります。
- アクション・コールバック・プロシージャ: 指定した名前のアクション・コールバック・プロシージャのスケルトンがユーザーのスキーマ内に作成され、ルール・クラスに関連付けられます。コールバック・プロシージャは、ルールの評価時に、一致するルールとイベントごとにコールされます。各ルールに対して適切なアクションを実行するには、アクション・コールバック・プロシージャの本体を実装する必要があります。ルールに対して実行するアクションは、そのルールに一致したイベント、ルール定義、およびそのアクション・プリファレンスに基づいて厳密に決定できます。この情報は、引数によってアクション・コールバック・プロシージャに渡されます。したがって、アクション・コールバック・プロシージャの引数リストは、ルール・クラスに関連付けられたイベント構造およびルール・クラス自体によって異なります。
  
  単純イベント（ルール・クラスのプロパティに割り当てられた<simple/>）用に構成されているルール・クラスの場合、ルールに一致するイベントは、イベント構造と同じタイプとして宣言されるrlm$event引数によって渡されます。また、ルール定義は、対応するルール・クラス表のROWTYPEとして宣言されるrlm$rule引数を使用してアクション・コールバック・プロシージャに渡されます。たとえば、単純な（非コンポジットの）イベント構造AddFlightに対して構成されるルール・クラスTravelPromotion用のアクション・コールバック・プロシージャPromoActionは、次のような構造で作成されます。
```
PROCEDURE PromoAction (rlm$event AddFlight,
                       rlm$rule TravlePromotion%ROWTYPE);
```
  コンポジット・イベント（ルール・クラスのプロパティに割り当てられた<composite/>）用に作成されたルール・クラスの場合は、各プリミティブ・イベントを別々の引数として渡すようにアクション・コールバック・プロシージャを作成します。たとえば、プリミティブ・イベントAddFlightおよびAddRentalCarを持つコンポジット・イベントに対して構成されるルール・クラスCompTravelPromo用のアクション・コールバック・プロシージャCompPromoActionは、次のような構造で作成されます。
```
-- composite event structure --
TYPE TSCompEvent (Flt AddFlight,
                  Car AddRentalCar);
-- corresponding action callback procedure --
PROCEDURE PromoAction (Flt AddFlight,
                       Car AddRentalCar,
                       rlm$rule CompTravelPromo%ROWTYPE)
```
- ルール・クラスの結果ビュー: イベントとルールの一致結果を表示するビューが、ルール・クラスと同じスキーマ内に作成されます。デフォルトでは、このビューは、システム生成された名前で作成されます。オプションで、ルール・クラスの作成者が、このビューの名前をCREATE_RULE_CLASSプロシージャのrlst_viewnm引数で指定することもできます。ADD_EVENTプロシージャを使用して、ルール・セッション内のRules Managerにイベントを追加すると、一致するイベントとルールのリストがルール・クラスの結果ビューに表示されます。
  
  ルール・クラスの結果に対して定義されるビューの構造は、ルール・クラスに対して構成されるイベント構造およびアクション・プリファレンスによって異なります。このビューには3つ以上の列が含まれ、システム生成されたイベント識別子（rlm$evenetid）、そのイベントに一致するルールの識別子（rlm$ruleid）およびルール条件（rlm$rulecond）が表示されます。また、イベント情報およびルール・アクション・プリファレンスを表示する列も含まれます。
  
  イベント情報は、単純イベント用に構成されたルール・クラスの場合、イベント構造のタイプとして宣言されるrlm$eventとして表示されます。したがって、単純なイベント構造AddFlightに対して構成されるルール・クラスTravelPromotion用のビューMatchingPromosは、次のように作成されます。
```
VIEW MatchingPromos (
    rlm$eventid ROWID,
    rlm$event AddFlight,
    rlm$ruleid VARCHAR(100),
    PromoType VARCHAR(30), -- action preference 1 --
    OffredBy VARCHAR(30), -- action preference 2 --
    rlm$rulecond VARCHAR(4000),
    rlm$ruledesc VARCHAR(1000)
);
```
  コンポジット・イベント用に構成されるルール・クラスの場合は、ルールに一致したプリミティブ・イベントが、対応する列に別々に表示されます。前述のルール・クラスCompTravelPromoの場合、ビューMatchingCompPromosは、次の構造で作成されます。
```
VIEW MatchingCompPromos (
    rlm$eventid ROWID,
    Flt AddFlight,
    Car AddRentalCar,
    rlm$ruleid VARCHAR(100),
    PromoType VARCHAR(30),   -- action preference 1 --
    OffredBy VARCHAR(30),    -- action preference 2 --
    rlm$rulecond VARCHAR(4000),
    rlm$ruledesc VARCHAR(1000)
);
```
  rlm$eventid列の値は、対応するルールの実行時に、ルール・クラスのコンシューム・ポリシーを適用するために使用されます。詳細は、「CONSUME_EVENTファンクション」を参照してください。

例

次のコマンドでは、単純イベント（AddFlightタイプ）用のルール・クラスが作成されます。

CREATE or REPLACE TYPE AddFlight AS OBJECT (
                  CustId NUMBER,
                  Airline VARCHAR(20),
                  FromCity VARCHAR(30),
                  ToCity VARCHAR(30),
                  Depart DATE,
                  Return DATE);
BEGIN
  DBMS_RLMGR.CREATE_RULE_CLASS (
              rule_class   => 'TravelPromotion', -- rule class name --
              event_struct => 'AddFlight', -- event struct name --
              action_cbk    => 'PromoAction', -- callback proc name –-
              rslt_viewnm   => 'MatchingPromos', -- results view --
              actprf_spec   => 'PromoType VARCHAR(20),
                              OfferedBy VARCHAR(20)');
END;

次のコマンドでは、2つのプリミティブ・イベント（AddFlightおよびAddRentalCar）で構成されるコンポジット・イベント用のルール・クラスが作成されます。

CREATE or REPLACE TYPE TSCompEvent (Flt AddFlight,
                                    Car AddRentalCar);
BEGIN
  DBMS_RLMGR.CREATE_RULE_CLASS (
              rule_class    => 'CompTravelPromo', -- rule class name --
              event_struct  => 'TSCompEvent', -- event struct name --
              action_cbk    => 'CompPromoAction', -- callback proc name –-
              rslt_viewnm   => 'MatchingCompPromos', -- results view --
              actprf_spec   => 'PromoType VARCHAR(20),
                              OfferedBy VARCHAR(20)',
              properties    => '<composite/>');
END;

DELETE_RULEプロシージャ

このプロシージャは、ルール・クラスからルールを削除します。

構文

DBMS_RLMGR.DELETE_RULE (
   rule_class    IN    VARCHAR2,
   rule_id       IN    VARCHAR2);

パラメータ

表88-10 DELETE_RULEプロシージャのパラメータ

パラメータ	説明
`rule_class`	ルール・クラスの名前。スキーマ拡張したルール・クラス名を使用すると、現行のスキーマに属していないルール・クラスを参照できます。
`rule_id`	削除するルールの識別子。

使用上の注意

このプロシージャは、ルール・クラスからルールを削除するために使用します。削除するルールの識別子は、（ルール・クラスと同じ名前の）ルール・クラス表を問い合せることによって取得できます。また、ルール・クラスの所有者は、1つのルール・クラス表に対してSQL DELETE文を使用してルールを削除することもできます。スキーマ拡張した名前をルール・クラスに使用する場合は、ルール・クラスに対するDELETE RULE権限が必要です。詳細は、「GRANT_PRIVILEGEプロシージャ」を参照してください。

注意:
DELETE_RULEプロシージャではなくSQL DELETE文を使用してルールを削除する場合、ルール・クラスのAUTOCOMMITプロパティは無視されます。
ルール・クラス表の構造については、「CREATE_RULE_CLASSプロシージャ」を参照してください。

例

このコマンドでは、ルール・クラスからルールが削除されます。

BEGIN
  DBMS_RLMGR.DELETE_RULE (
           rule_class  => 'CompTravelPromo',
           rule_id     => 'AB_AV_FL');
END;

また、前述のルールは、次のSQL DELETE文を発行してルール・クラスから削除することもできます。

DELETE FROM CompTravelPromo WHERE rlm$ruleid = 'AB_AV_FL';

DROP_EVENT_STRUCTUREプロシージャ

このプロシージャは、イベント構造を削除します。

構文

DBMS_RLMGR.DROP_EVENT_STRUCTURE  (
   event_struct  IN  VARCHAR2);

パラメータ

表88-11 DROP_EVENT_ STRUCTUREプロシージャのパラメータ

パラメータ	説明
`event_struct`	現行のスキーマ内のイベント構造の名前。

使用上の注意

このプロパティは、現行のスキーマ内のイベント構造を削除します。これによって、イベント構造を管理するために作成されたすべての依存オブジェクトが削除されます。

例

次のコマンドでは、イベント構造が削除されます。

BEGIN
  DBMS_RLMGR.DROP_EVENT_STRUCT(event_struct => 'AddFlight');
END;

DROP_RULE_CLASSプロシージャ

このプロシージャは、ルール・クラスを削除します。

構文

DBMS_RLMGR.DROP_RULE_CLASS  (
   rule_class  IN  VARCHAR2);

パラメータ

表88-12 DROP_RULE_CLASSプロシージャのパラメータ

パラメータ	説明
`rule_class`	現行のスキーマ内のルール・クラスの名前。

使用上の注意

このプロパティは、現行のスキーマ内のルール・クラスを削除します。これによって、ルール・クラスを管理するために作成されたすべての依存オブジェクトが削除されます。ユーザーのスキーマ内のイベント構造は複数のルール・クラスで共有できるため、イベント構造はこのコマンドでは削除されません。コンポジット・イベントおよび個々のプリミティブ・イベントの場合、使用されていないイベント構造を削除するには、DROP_EVENT_STRUCTURE APIを使用する必要があります。

例

次のコマンドでは、ルール・クラスが削除されます。

BEGIN
  DBMS_RLMGR.DROP_RULE_CLASS(rule_class => 'CompTravelPromo');
END;

GRANT_PRIVILEGEプロシージャ

このプロシージャは、ルール・クラスに対する権限を他のユーザーに付与します。

構文

DBMS_RLMGR.GRANT_PRIVILEGE  (
   rule_class      IN  VARCHAR2,
   priv_type       IN  VARCHAR2,
   to_user         IN  VARCHAR2);

パラメータ

表88-13 GRANT_PRIVILEGEプロシージャのパラメータ

パラメータ	説明
`rule_class`	現行のスキーマ内のルール・クラスの名前。
`priv_type`	付与するルール・クラス権限のタイプ。
`to_user`	権限を付与されるユーザー。

使用上の注意

このプロシージャは、ルール・クラスの所有者ではないユーザーに権限を付与します。ユーザーに付与できる権限のタイプは、次のとおりです。
- PROCESS RULES: ルール・クラスに対するPROCESS RULES権限を持つユーザーは、PROCESS_RULESプロシージャまたはADD_EVENTプロシージャを使用して、そのルール・クラスのルールを処理できます。また、この権限を持つユーザーは、対応するルール・クラスの結果ビューを検索できます。
- ADD RULE: ルール・クラスに対するADD RULE権限を持つユーザーは、そのルール・クラスにルールを追加できます。また、ルール・クラスの所有者は、1つのルール・クラス表に対するINSERT権限を他のユーザーに付与することもできます。
- DELETE RULE: ルール・クラスに対するDELETE RULE権限を持つユーザーは、そのルール・クラスからルールを削除できます。また、ルール・クラスの所有者は、1つのルール・クラス表に対するDELETE権限を他のユーザーに付与することもできます。
- ALL: ルール・クラスに対するALL権限を付与すると、そのルール・クラスに対する前述のすべての権限がユーザーに付与されます。
ルール・クラスの所有者は、ルール・クラスの削除、ルール・クラス内のルールの処理、ルール・クラスに対するルールの追加と削除を実行する権限を常に所有しています。ルール・クラスの所有者のみがルール・クラスを削除できます。この権限は、他のユーザーには付与できません。
ユーザーがルール・クラスの結果ビューを利用するには、対応するルール・クラスに関連付けられているプリミティブ・イベント・タイプに対するEXECUTE権限も必要です。

例

次のコマンドでは、ルール・クラスTravelPromoのPROCESS RULES権限がユーザーSCOTTに付与されます。

BEGIN
  DBMS_RLMGR.GRANT_PRIVILEGE(rule_class => 'TravelPromo',
                             priv_type => 'PROCESS RULES',
                             to_user => 'SCOTT');
END;

PROCESS_RULESプロシージャ

このプロシージャは、指定したイベントのルールを処理します。このプロシージャはオーバーロードされています。複数の機能を構文形式ごとに、定義とともに示します。

構文

ルール・クラスに追加するイベント・インスタンスの文字列表現に対するルールを処理します。

DBMS_RLMGR.PROCESS_RULES  (
   rule_class    IN  VARCHAR2,
   event_inst    IN  VARCHAR2,
   event_type    IN  VARCHAR2 default null);

ルール・クラスに追加するイベント・インスタンスのAnyData表現に対するルールを処理します。

DBMS_RLMGR.PROCESS_RULES  (
   rule_class    IN  VARCHAR2,
   event_inst    IN  sys.AnyData);

パラメータ

表88-14 PROCESS_RULESプロシージャのパラメータ

パラメータ	説明
`rule_class`	ルール・クラスの名前。スキーマ拡張したルール・クラス名を使用すると、現行のスキーマに属していないルール・クラスを参照できます。
`event_inst`	ルール・クラスに追加するイベント・インスタンスの文字列表現またはAnyData表現。
`event_type`	`event_inst`引数に割り当てられたイベント・インスタンスのタイプ（コンポジット・イベント用に構成されたルール・クラスに対してイベント・インスタンスの文字列表現を使用する場合）。

使用上の注意

このプロシージャは、event_inst引数に割り当てられたイベント・インスタンスに対するルール・クラス内のルールの処理に使用します。
単純イベント（非コンポジット）用に構成されるルール・クラスの場合、イベント・インスタンスは、対応するイベント構造がインスタンス化されたものです。ルールは（最終的に）このイベントに対して評価され、一致するルールごとに、対応するアクション・コールバック・プロシージャがコールされます。イベントに一致するルールがない場合、それ以降、アクションは実行されません。イベントが複数のルールに一致する場合は、ルール・クラスに対して構成されている順序付け句に基づいて、ルールの順序が決定され、アクション・コールバック・プロシージャが起動されます。ルール・クラスがEXCLUSIVEコンシューム・ポリシーに対して構成されている場合、最初のルールがこの順序で実行され、対応するアクション・コールバック・プロシージャがコールされると、イベントに一致する残りのルールは無視されます。
コンポジット・イベント用に構成されているルール・クラスの場合、event_inst引数に割り当てられたイベント・インスタンスは、コンポジット・イベント内のプリミティブ・タイプのイベントがインスタンス化されたものです。インスタンスを文字列として表現する場合は、対応するタイプ名をevent_type引数に割り当てる必要があります。コンポジット・イベント用に構成されているルール・クラスに対するPROCESS_RULESコールは、ルール・クラスの状態およびルール・クラスのルールの種類に応じて、様々なアクションを実行します。
- 渡されたプリミティブ・イベントに対してのみ適用されるルールが最終的に評価され、前述のとおり、一致するルールに対してアクション・コールバック・プロシージャがコールされます。
- 複数のプリミティブ・イベントに対して適用されるルールの場合、PROCESS_RULESプロシージャで渡されるイベント・インスタンスは、ルールの一部にのみ一致する可能性があります。
  - ルールの残りの部分に一致するプリミティブ・イベント・インスタンスが他にある場合、現行のイベント・インスタンスが他のインスタンスと組み合され、ルール・クラスのルールに一致する完全なコンポジット・イベントが形成されます。したがって、PROCESS_RULESプロシージャのevent_inst引数に割り当てられたイベント・インスタンスは、他の様々な（処理済の）プリミティブ・イベントと組み合せられ、1つ以上のルールが最終的に評価される可能性があります。ルール・クラスのアクション・コールバック・プロシージャは、プリミティブ・イベント（コンポジット・イベント）とルールで構成される組合せごとにコールされます。アクション・コールバック・プロシージャの起動時、ルール・クラスの順序付け句およびプリミティブ・イベントに対するコンシューム・ポリシーが考慮されます。
  - ルールの残りの部分に一致する他のプリミティブ・イベントがない場合、現行のイベント・インスタンスおよびその（増分の）評価結果がデータベースに記録されます。これらの結果は、ルール・クラスで使用される継続時間ポリシーに基づいてイベントがコンシュームされるか、またはシステムから削除されるまで保持されます。

例

次のコマンドでは、指定したイベントのルール・クラスTravelPromotionのルールが処理されます。

BEGIN
  DBMS_RLMGR.PROCESS_RULES (
               rule_class => 'TravelPromotion',
               event_inst =>
                 AddFlight.getVarchar(987, 'Abcair', 'Boston', 'Orlando',
                                      '01-APR-2003', '08-APR-2003'));
END;

次のコマンドでは、示されている2つのプリミティブ・イベントのルール・クラスCompTravelPromoのルールが処理されます。

BEGIN  DBMS_RLMGR.PROCESS_RULES(
               rule_class => 'CompTravelPromo',
               event_inst =>
                 AddFlight.getVarchar(987, 'Abcair', 'Boston', 'Orlando',
                                      '01-APR-2003', '08-APR-2003'),
               event_type => 'AddFlight');
  DBMS_RLMGR.PROCESS_RULES(
               rule_class => 'Scott.CompTravelPromo',
               event_inst =>
                  AnyData.convertObject(AddRentalCar(987, 'Luxury', '03-APR-2003',
                                        '08-APR-2003', NULL)));
END;

RESET_SESSIONプロシージャ

このプロシージャは、新しいセッションを開始し、ルール・クラスの結果ビュー内の結果を破棄します。

構文

DBMS_RLMGR.RESET_SESSION  (
   rule_class  IN  VARCHAR2);

パラメータ

表88-15 RESET_SESSIONプロシージャのパラメータ

パラメータ	説明
`rule_class`	ルール・クラスの名前。スキーマ拡張したルール・クラス名を使用すると、現行のスキーマに属していないルール・クラスを参照できます。

使用上の注意

ADD_EVENTプロシージャを使用してルール・クラスにイベントを追加すると、イベントとルールの一致結果がルール・クラスの結果ビューに記録されます。デフォルトでは、これらの結果は、データベース・セッションの終了時にリセットされます。また、RESET_SESSIONプロシージャを使用して、リセットを行い、同じデータベース・セッション内で新しいルール・セッションを開始することもできます。
このプロシージャは、ADD_EVENTプロシージャを使用してルールを評価する場合にのみ適用できます。

例

次のコマンドでは、ルール・クラス・セッションがリセットされます。

BEGIN  DBMS_RLMGR.RESET_SESSION(
             rule_class => 'CompTravelPromo');
END;

REVOKE_PRIVILEGEプロシージャ

このプロシージャは、他のユーザーが持つルール・クラスに対する権限を取り消します。

構文

DBMS_RLMGR.REVOKE_PRIVILEGE  (
   rule_class      IN  VARCHAR2,
   priv_type       IN  VARCHAR2,
   from_user       IN  VARCHAR2);

パラメータ

表88-16 REVOKE_PRIVILEGEプロシージャのパラメータ

パラメータ	説明
`rule_class`	現行のスキーマ内のルール・クラスの名前。
`priv_type`	取り消すルール・クラス権限のタイプ。
`from_user`	権限を取り消されるユーザー。

使用上の注意

このプロシージャは、ユーザーに付与されている権限を取り消します。取り消すことができる権限のタイプは、「GRANT_PRIVILEGEプロシージャ」に示されている権限のタイプと同じです。ルール・クラスの所有者が持つルール・クラスに対する権限は取り消すことができません。

例

次のコマンドでは、ルール・クラスTravelPromoに対するPROCESS RULES権限がユーザーSCOTTから取り消されます。

BEGIN
  DBMS_RLMGR.REVOKE_PRIVILEGE(rule_class  => 'TravelPromo',
                              priv_type   => 'PROCESS RULES',
                              from_user   => 'SCOTT');
END;