この章では、エンキューおよび伝播におけるOracle Streams AQの使用方法と管理方法を説明します。ANYDATA
キューおよびユーザー・メッセージを説明します。
Oracle Streamsでは、ANYDATA
型のキューを使用して次の3種類のメッセージが格納されます。
取得済の論理変更レコード(LCR)
このメッセージ型はOracle Streamsの取得プロセスにより生成されます。このマニュアルでは、このメッセージ型については説明しません。
関連項目: 『Oracle Streams概要および管理』のストリームの取得プロセスに関する項 |
ユーザーによってエンキューされたLCR
これは、ユーザーまたはアプリケーションによってエンキューされたLCRを含むメッセージです。
ユーザー・メッセージ
これは、ユーザーまたはアプリケーションによって作成されエンキューされた、LCR以外のメッセージです。
この3種類のメッセージはいずれも、単一データベース内またはデータベース間での情報共有に使用できます。
内容は次のとおりです。
関連項目: ANYDATA 型の詳細は、『Oracle Database PL/SQLパッケージ・プロシージャおよびタイプ・リファレンス』を参照してください。
|
内容は次のとおりです。
関連項目 『Oracle Streams概要および管理』 |
ANYDATA
ペイロード内のほとんどのペイロード型は、ANYDATA
型の静的関数Convert
data_type
でラップできます。data_type
は、ラップするオブジェクトの型です。これらの関数は入力としてオブジェクトを取得し、ANYDATA
オブジェクトを戻します。
次のデータ型は、ANYDATA
ラッパーでラップできません。
ネストした表
NCLOB
ROWIDおよびUROWID
次のデータ型はANYDATA
ラッパーで直接ラップできますが、ANYDATA
ラッパーでラップされたユーザー定義型ペイロードで表示することはできません。
CLOB
BLOB
BFILE
VARRAY
関連項目: ANYDATA 型の詳細は、『Oracle Database PL/SQLパッケージ・プロシージャおよびタイプ・リファレンス』を参照してください。
|
アプリケーションでは、次のプログラム・インタフェースを使用してユーザー・メッセージをANYDATA
キューにエンキュー、およびANYDATA
キューからユーザー・メッセージをデキューできます。
次のセクションでは、これらのインタフェースを使用してユーザー・メッセージをANYDATA
キューにエンキューしたり、ANYDATA
キューからデキューする方法を説明します。
PL/SQLを使用して、LCRを含むユーザー・メッセージをANYDATA
キューにエンキューするには、まずエンキュー対象のLCRを作成します。SYS.LCR$_ROW_RECORD
型のコンストラクタを使用してLCR行を作成し、SYS.LCR$_DDL_RECORD
型のコンストラクタを使用してDDL LCRを作成します。次に、ANYDATA.ConvertObject
関数を使用してLCRをANYDATA
ペイロードに変換し、DBMS_AQ.ENQUEUE
プロシージャを使用してそれをエンキューします。
PL/SQLを使用してLCR以外のオブジェクトを含むユーザー・メッセージをANYDATA
キューにエンキューするには、ANYDATA.Convert*
関数の1つを使用してオブジェクトをANYDATA
ペイロードに変換し、DBMS_AQ.ENQUEUE
プロシージャを使用してそれをエンキューします。
JMSまたはOCIを使用して、LCRを含むユーザー・メッセージをANYDATA
キューにエンキューするには、LCRをXMLフォーマットで表示する必要があります。LCRを構成するには、oracle.xdb.XMLType
クラスを使用します。LCRはSYS
スキーマで定義されています。ORACLE_HOME
/rdbms/admin
にあるcatxlcr.sql
スクリプトを使用して、LCRスキーマをSYS
スキーマにロードする必要があります。
OCIを使用してメッセージをエンキューするには、メッセージを型指定キューにエンキューする場合と同じアクションを実行します。JMSを使用してメッセージをエンキューするには、ユーザーにはDBMS_AQ
、DBMS_AQIN
およびDBMS_AQJMS
の各パッケージに対するEXECUTE
権限が必要です。
注意: DBMS_STREAMS_ADM.SET_UP_QUEUE( queue_name ) の後でDBMS_AQADM.ENABLE_JMS_TYPES( queue_table_name ) をコールしないと、JMS型とXML型のエンキューはANYDATA キューでは機能しません。キューをこれらの型に対して使用可能にすると、キュー表のインポート/エクスポートに影響が出る場合があります。
|
LCR以外のユーザー・メッセージでは、任意のユーザー定義型またはJMS型のメッセージが有効です。JMS型には、次のものが含まれます。
javax.jms.TextMessage
javax.jms.MapMessage
javax.jms.StreamMessage
javax.jms.ObjectMessage
javax.jms.BytesMessage
ユーザー定義型を使用する場合は、ORAData
インタフェースを実装しているJPublisherを使用してメッセージのJavaクラスを生成する必要があります。ANYDATA
キューにメッセージをエンキューする場合は、QueueSender.send
メソッドまたはTopicPublisher.publish
メソッドを使用できます。
関連項目:
|
PL/SQLを使用して、ANYDATA
キューからユーザー・メッセージをデキューするには、DBMS_AQ.DEQUEUE
プロシージャを使用してANYDATA
をペイロードとして指定します。ユーザー・メッセージには、LCRまたは他の型のオブジェクトを含めることができます。
ANYDATA
キューでは、XMLフォーマットのLCRを含むユーザー・メッセージはoracle.xdb.XMLType
として表されます。LCR以外のメッセージでは、任意のユーザー定義型またはJMS型が有効です。
JMSを使用して、ANYDATA
キューからメッセージをデキューする場合は、QueueReceiver
、TopicSubscriber
またはTopicReceiver
の各メソッドを使用できます。キューにはANYDATA
ラッパーでラップされた異なるオブジェクト型を含めることができるため、SQL型のリストおよび対応するJavaクラスをJMSセッションのTypeMapに登録する必要があります。JMS型はTypeMapに事前登録済です。
たとえば、キューにoracle.xdb.XMLType
と表されるユーザーによってエンキューされたLCRメッセージと、person
型とaddress
型のLCR以外のメッセージが含まれているとします。JPerson.java
およびJAddress.java
の各クラスは、それぞれperson
およびaddress
のORAData
マッピングです。メッセージをデキューする前に、TypeMapを次のように移入する必要があります。
java.util.Map map = ((AQjmsSession)q_sess).getTypeMap(); map.put("SCOTT.PERSON", Class.forName("JPerson")); map.put("SCOTT.ADDRESS", Class.forName("JAddress")); map.put("SYS.XMLTYPE", Class.forName("oracle.xdb.XMLType")); // For LCRs
QueueReceiver
またはTopicPublisher
でmessageSelector
を使用する場合は、セレクタには次のうちの1つ以上の組合せを持つ任意のSQL92式を含めることができます。
JMSメッセージ・ヘッダー・フィールドまたはプロパティ
これには、JMSPriority
、JMSCorrelationID
、JMSType
、JMSXUserI
、JMSXAppID
、JMSXGroupID
およびJMSXGroupSeq
などが含まれます。次は、JMSメッセージ・フィールドmessageSelector
の例です。
JMSPriority < 3 AND JMSCorrelationID = 'Fiction'
ユーザー定義のメッセージ・プロパティ
次は、ユーザー定義のメッセージ・プロパティmessageSelector
の例です。
color IN ('RED', 'BLUE', 'GREEN') AND price < 30000
PL/SQLファンクション
次は、PL/SQLファンクションmessageSelector
の例です。
hr.GET_TYPE(tab.user_data) = 'HR.EMPLOYEES'
OCIを使用してANYDATA
キューからメッセージをデキューするには、メッセージを型指定キューからデキューする場合と同じアクションを実行します。
関連項目:
|
ANYDATA
キューは、型指定キューと相互運用できます。表22-1は、キュー間で伝播可能な型を示したものです。
表22-1 異なるキュー型間の伝播
ソース・キュー | 宛先キュー | 変換 |
---|---|---|
ANYDATA
|
ANYDATA
|
なし。 |
型指定 | ANYDATA
|
暗黙的。
注意: 伝播は、型指定キューのメッセージが「オブジェクト型のサポート」の制約概要に一致する場合のみ可能です。 |
ANYDATA
|
型指定 | メッセージをフィルタリングするルールとユーザー定義の変換が必要です。型指定キューと同じ型のペイロードを含むメッセージのみを型指定キューに伝播できます。 |
型指定 | 型指定 | Oracle Streams AQルールに従います。 |
注意: 異なるキャラクタ・セットを使用するデータベース間でオブジェクト型、VARRAYまたはネストした表のペイロードをカプセル化する、ユーザーによってエンキューされたANYDATA メッセージは伝播できません。同じキャラクタ・セットを使用するデータベース間では、この種のメッセージを伝播できます。
|
Simple Object Access Protocol(SOAP)を使用してANYDATA
キューと直接交信することはできませんが、ANYDATA
キューと型指定キュー間でメッセージを伝播するとSOAPを使用できます。SOAPを使用してメッセージをANYDATA
キューにエンキューする場合は、最初に型指定キューからANYDATA
キューへの伝播を構成する必要があります。これで、SOAPを使用してメッセージを型指定キューにエンキューできます。メッセージは、型指定キューからANYDATA
キューに自動的に伝播されます。
SOAPを使用して、ANYDATA
キュー内のメッセージをデキューする場合は、伝播をANYDATA
キューから型指定キューに設定できます。メッセージは、ANYDATA
キューからSOAPを使用してアクセス可能な型指定キューに自動的に伝播されます。
関連項目: 『Oracle Streams概要および管理』のANYDATAキューと型指定キュー間のメッセージの伝播に関する項 |
この項では、ANYDATA
キューにメッセージをエンキューする例を示します。この項の例では、SQL*Plusテスト環境でdb01
およびdb02
という2つのデータベースにアクセスできることを前提としています。最初の数例では、この章の他の例に使用できるようにテスト環境を準備します。
例22-1では、データベースdb01
およびdb02
に管理権限を持つユーザーとして接続し、管理者ユーザーstrmadmin
を作成し、サンプル・スキーマ・ユーザーoe
にDBMS_AQ
パッケージに対するEXECUTE
権限を付与します。
例22-1 ANYDATAユーザーの作成
GRANT EXECUTE ON DBMS_AQ TO oe; CREATE USER strmadmin IDENTIFIED BY strmadmin DEFAULT TABLESPACE example; GRANT DBA TO strmadmin; GRANT EXECUTE ON DBMS_STREAMS_ADM TO strmadmin; GRANT EXECUTE ON DBMS_TRANSFORM TO strmadmin;
例22-2では、db01
にstrmadmin
として接続し、ANYDATA
キューoe_queue_any
を作成します。oe
ユーザーは、oe_queue_any
キューの保護ユーザーとして自動的に設定され、キューに対するENQUEUE
権限とDEQUEUE
権限が付与されます。
例22-2 ANYDATAキューの作成
CONNECT strmadmin;
Enter password: password
BEGIN
DBMS_STREAMS_ADM.SET_UP_QUEUE(
queue_table => 'oe_qtab_any',
queue_name => 'oe_queue_any',
queue_user => 'oe');
END;
/
例22-3では、oe_queue_any
キューにサブスクライバを追加します。このサブスクライバによってメッセージの明示的デキューが実行されます。ADD_SUBSCRIBER
プロシージャにより、AQ_AGENT
が自動的に作成されます。
例22-3 ANYDATAキューへのサブスクライバの追加
DECLARE subscriber SYS.AQ$_AGENT; BEGIN subscriber := SYS.AQ$_AGENT('LOCAL_AGENT', NULL, NULL); SYS.DBMS_AQADM.ADD_SUBSCRIBER( queue_name => 'strmadmin.oe_queue_any', subscriber => subscriber); END; /
例22-4では、oe
ユーザーをlocal_agent
エージェントに関連付けます。
例22-4 ユーザーとAQ_AGENTとの関連付け
BEGIN DBMS_AQADM.ENABLE_DB_ACCESS( agent_name => 'local_agent', db_username => 'oe'); END; /
例22-5では、データベースdb01
にユーザーoe
として接続し、エンキュー・プロシージャを作成します。このプロシージャは入力パラメータとしてANYDATA
型のオブジェクトを取り、ペイロードを含むメッセージを既存のANYDATA
キューにエンキューします。
例22-5 エンキュー・プロシージャの作成
set echo off set verify off ACCEPT password CHAR PROMPT 'Enter the password for OE: ' HIDE CONNECT oe/&password@db01; set echo on CREATE PROCEDURE oe.enq_proc (payload ANYDATA) IS enqopt DBMS_AQ.ENQUEUE_OPTIONS_T; mprop DBMS_AQ.MESSAGE_PROPERTIES_T; enq_msgid RAW(16); BEGIN mprop.SENDER_ID := SYS.AQ$_AGENT('LOCAL_AGENT', NULL, NULL); DBMS_AQ.ENQUEUE( queue_name => 'strmadmin.oe_queue_any', enqueue_options => enqopt, message_properties => mprop, payload => payload, msgid => enq_msgid); END; /
例22-6では、プロシージャoe.enq_proc
を使用してVARCHAR2
型のメッセージをANYDATA
キューにエンキューします。
例22-6 ANYDATAキューへのVARCHAR2メッセージのエンキュー
EXEC oe.enq_proc(ANYDATA.ConvertVarchar2('Chemicals - SW')); COMMIT;
例22-7では、プロシージャoe.enq_proc
を使用してNUMBER
型のメッセージをANYDATA
キューにエンキューします。
例22-8では、プロシージャoe.enq_proc
を使用してユーザー定義型のメッセージをANYDATA
キューにエンキューします。
例22-8 ANYDATAキューへのユーザー定義型メッセージのエンキュー
BEGIN oe.enq_proc(ANYDATA.ConvertObject(oe.cust_address_typ( '1646 Brazil Blvd','361168','Chennai','Tam', 'IN'))); END; / COMMIT;
関連項目: 『Oracle Streams概要および管理』のキューにおけるユーザーによってエンキューされたイベントの内容の表示に関する項 |
この項では、ANYDATA
キューからメッセージをデキューする例を示します。この項の例では、「ANYDATAキューへのユーザー・メッセージのエンキュー」の例を完了していることを前提としています。
メッセージをデキューするには、メッセージのコンシューマを知っている必要があります。キュー内のメッセージのコンシューマを検索するには、キューの所有者として接続しAQ$
queue_table_name
ビューを問い合せます。queue_table_name
は、キューを含んでいるキュー表の名前です。
例22-9では、データベースdb01
にキューoe_queue_any
の所有者であるstrmadmin
として接続し、AQ$OE_QTAB_ANY
ビューの問合せを実行します。この問合せでは3行が戻され、各行にCONSUMER_NAME
としてLOCAL_AGENT
が含まれています。
例22-9 キュー内のメッセージのコンシューマの判別
CONNECT strmadmin;
Enter password: password
SELECT MSG_ID, MSG_STATE, CONSUMER_NAME FROM AQ$OE_QTAB_ANY;
例22-10では、データベースdb01
にユーザーoe
として接続し、デキュー・プロシージャを作成します。このプロシージャは、入力としてデキュー対象のメッセージのコンシューマを取得し、oe.cust_address_typ
のメッセージをデキューして、メッセージの内容を出力します。
例22-10 ANYDATAキューのデキュー・プロシージャの作成
CONNECT oe; -- @db01
Enter password: password
CREATE PROCEDURE oe.get_cust_address (
consumer IN VARCHAR2) AS
address OE.CUST_ADDRESS_TYP;
deq_address ANYDATA;
msgid RAW(16);
deqopt DBMS_AQ.DEQUEUE_OPTIONS_T;
mprop DBMS_AQ.MESSAGE_PROPERTIES_T;
new_addresses BOOLEAN := TRUE;
next_trans EXCEPTION;
no_messages EXCEPTION;
pragma exception_init (next_trans, -25235);
pragma exception_init (no_messages, -25228);
num_var pls_integer;
BEGIN
deqopt.consumer_name := consumer;
deqopt.wait := 1;
WHILE (new_addresses) LOOP
BEGIN
DBMS_AQ.DEQUEUE(
queue_name => 'strmadmin.oe_queue_any',
dequeue_options => deqopt,
message_properties => mprop,
payload => deq_address,
msgid => msgid);
deqopt.navigation := DBMS_AQ.NEXT;
DBMS_OUTPUT.PUT_LINE('****');
IF (deq_address.GetTypeName() = 'OE.CUST_ADDRESS_TYP') THEN
DBMS_OUTPUT.PUT_LINE('Message TYPE is: ' || deq_address.GetTypeName());
num_var := deq_address.GetObject(address);
DBMS_OUTPUT.PUT_LINE(' **** CUSTOMER ADDRESS **** ');
DBMS_OUTPUT.PUT_LINE(address.street_address);
DBMS_OUTPUT.PUT_LINE(address.postal_code);
DBMS_OUTPUT.PUT_LINE(address.city);
DBMS_OUTPUT.PUT_LINE(address.state_province);
DBMS_OUTPUT.PUT_LINE(address.country_id);
ELSE
DBMS_OUTPUT.PUT_LINE('Message TYPE is: ' || deq_address.GetTypeName());
END IF;
COMMIT;
EXCEPTION
WHEN next_trans THEN
deqopt.navigation := DBMS_AQ.NEXT_TRANSACTION;
WHEN no_messages THEN
new_addresses := FALSE;
DBMS_OUTPUT.PUT_LINE('No more messages');
END;
END LOOP;
END;
/
例22-11では、コンシューマとしてLOCAL_AGENT
を指定して、例22-10で作成したプロシージャoe.get_cust_address
を使用します。
例22-11 ANYDATAキューからのメッセージのデキュー
SET SERVEROUTPUT ON SIZE 100000 EXEC oe.get_cust_address('LOCAL_AGENT');
この例は、次の行を戻します。
**** Message TYPE is: SYS.VARCHAR2 **** Message TYPE is: SYS.NUMBER **** Message TYPE is: OE.CUST_ADDRESS_TYP **** CUSTOMER ADDRESS **** 1646 Brazil Blvd 361168 Chennai Tam IN No more messages
この項では、ANYDATA
キューと型指定キュー間でLCR以外のユーザー・メッセージを伝播する方法を示す例について説明します。
最初の数例では、例22-2で作成したANYDATA
キューoe_queue_any
からデータベースdb02
内の型指定キューへの伝播を設定します。例22-12では、サンプル・スキーマ・ユーザーoe
として接続し、データベースdb01
およびdb02
のoe.cust_address_typ
に対するEXECUTE
権限を管理者ユーザーstrmadmin
に付与します。
例22-12 型に対するEXECUTE権限の付与
CONNECT oe; -- @db01 Enter password: password GRANT EXECUTE ON oe.cust_address_typ TO strmadmin; CONNECT oe; -- @db02 Enter password: password GRANT EXECUTE ON oe.cust_address_typ TO strmadmin;
例22-13では、データベースdb02
に管理者ユーザーstrmadmin
として接続し、oe.cust_address_typ
型の宛先キューを作成します。
例22-13 型指定の宛先キューの作成
CONNECT strmadmin;
Enter password: password
BEGIN
DBMS_AQADM.CREATE_QUEUE_TABLE(
queue_table => 'strmadmin.oe_qtab_address',
queue_payload_type => 'oe.cust_address_typ',
multiple_consumers => true);
DBMS_AQADM.CREATE_QUEUE(
queue_name => 'strmadmin.oe_queue_address',
queue_table => 'strmadmin.oe_qtab_address');
DBMS_AQADM.START_QUEUE(
queue_name => 'strmadmin.oe_queue_address');
END;
/
例22-14では、データベースdb01
に管理者ユーザーstrmadmin
として接続し、db01
からdb02
へのデータベース・リンクを作成します。
例22-14 データベース・リンクの作成
CONNECT strmadmin; Enter password: password CREATE DATABASE LINK db02 CONNECT TO strmadmin IDENTIFIED BY password USING 'db02';
例22-15では、db01
のstrmadmin
スキーマ内にファンクションany_to_cust_address_typ
を作成します。このファンクションは、oe.cust_address_typ
オブジェクトを含むANYDATA
ペイロードを取得してoe.cust_address_typ
オブジェクトを戻します。
例22-15 ANYDATAオブジェクトから型指定オブジェクトを抽出するファンクションの作成
CONNECT strmadmin;
Enter password: password
CREATE FUNCTION strmadmin.any_to_cust_address_typ(in_any IN ANYDATA)
RETURN OE.CUST_ADDRESS_TYP
AS
address OE.CUST_ADDRESS_TYP;
num_var NUMBER;
type_name VARCHAR2(100);
BEGIN
type_name := in_any.GetTypeName();
IF (type_name = 'OE.CUST_ADDRESS_TYP') THEN
num_var := in_any.GetObject(address);
RETURN address;
ELSE
raise_application_error(-20101, 'Conversion failed - ' || type_name);
END IF;
END;
/
例22-16では、db01
でDBMS_TRANSFORM
パッケージを使用して変換を作成します。
例22-16 ANYDATAから型指定オブジェクトへの変換の作成
BEGIN DBMS_TRANSFORM.CREATE_TRANSFORMATION( schema => 'strmadmin', name => 'anytoaddress', from_schema => 'SYS', from_type => 'ANYDATA', to_schema => 'oe', to_type => 'cust_address_typ', transformation => 'strmadmin.any_to_cust_address_typ(source.user_data)'); END; /
例22-17では、型指定キューのサブスクライバを作成します。サブスクライバには、適切な型のメッセージのみが宛先キューに伝播されるルールが含まれている必要があります。
例22-17 サブスクライバADDRESS_AGENT_REMOTEの作成
DECLARE subscriber SYS.AQ$_AGENT; BEGIN subscriber := SYS.AQ$_AGENT ('ADDRESS_AGENT_REMOTE', 'STRMADMIN.OE_QUEUE_ADDRESS@DB02', 0); DBMS_AQADM.ADD_SUBSCRIBER( queue_name => 'strmadmin.oe_queue_any', subscriber => subscriber, rule => 'TAB.USER_DATA.GetTypeName()=''OE.CUST_ADDRESS_TYP''', transformation => 'strmadmin.anytoaddress'); END; /
例22-18では、db01
にあるANYDATA
キューとdb02
にある型指定キューの間の伝播をスケジュールします。
例22-18 ANYDATAキューから型指定キューへの伝播のスケジューリング
BEGIN DBMS_AQADM.SCHEDULE_PROPAGATION( queue_name => 'strmadmin.oe_queue_any', destination => 'db02'); END; /
例22-19では、データベースdb01
にサンプル・スキーマ・ユーザーoe
として接続し、ANYDATA
ラッパーでラップされたoe.cust_address_typ
型のメッセージをエンキューします。この例では、例22-5で作成したエンキュー・プロシージャoe.enq_proc
を使用します。
例22-19 ANYDATAラッパー内の型指定メッセージのエンキュー
CONNECT oe;
Enter password: password
BEGIN
oe.enq_proc(ANYDATA.ConvertObject(oe.cust_address_typ(
'1668 Chong Tao','111181','Beijing',NULL,'CN')));
END;
/
COMMIT;
伝播されるまで少し待ちます。その後、例22-20では、db02
でキュー表AQ$OE_QTAB_ADDRESS
を問い合せて、伝播されたメッセージを表示します。
例22-20 伝播されたメッセージの表示
CONNECT strmadmin;
Enter password: password
SELECT MSG_ID, MSG_STATE, CONSUMER_NAME FROM AQ$OE_QTAB_ADDRESS;
この例では、次のようにADDRESS_AGENT_REMOTE
に関するメッセージが1件戻されます。
MSG_ID MSG_STATE CONSUMER_NAME -------------------------------- ---------------- ------------------------------ EBEF5CACC4665A6FE030578CE70A370D READY ADDRESS_AGENT_REMOTE 1 row selected.
ユーザーによってエンキューされたLCRを適切な型指定キューに伝播することはできますが、取得済LCRの型指定キューへの伝播はサポートされていません。
関連項目: 取得プロセスの詳細は、『Oracle Streams概要および管理』のStreamsの取得プロセスに関する項を参照してください。 |
ユーザーによってエンキューされたLCRをANYDATA
キューから型指定キューに伝播するには、LCR以外のメッセージの場合と同じ手順を実行します。Oracleでは変換用関数を提供しています。DBMS_STREAMS
パッケージの次の関数を使用して、ANYDATA
キューのLCRを型指定キューのメッセージに変換できます。
CONVERT_ANYDATA_TO_LCR_ROW
は、LCR行を含むANYDATA
ペイロードをSYS.LCR$_ROW_RECORD
ペイロードに変換します。
CONVERT_ANYDATA_TO_LCR_DDL
は、DDL LCRを含むANYDATA
ペイロードをSYS.LCR$_DDL_RECORD
ペイロードに変換します。
この項の例では、oe_queue_any
というANYDATA
キューからoe_queue_lcr
というSYS.LCR$_ROW_RECORD
型の型指定キューへのLCR行の伝播を設定します。ソース・キューoe_queue_any
はデータベースdb01
にあり、宛先キューoe_queue_lcr
は例22-21でデータベースdb02
に作成します。
注意: この項の例では、すでに前項の例を実行していることを前提としています。 |
例22-21 LCR$_ROW_RECORD型のキューの作成
CONNECT strmadmin;
Enter password: password
BEGIN
DBMS_AQADM.CREATE_QUEUE_TABLE(
queue_table => 'strmadmin.oe_qtab_lcr',
queue_payload_type => 'SYS.LCR$_ROW_RECORD',
multiple_consumers => true);
DBMS_AQADM.CREATE_QUEUE(
queue_name => 'strmadmin.oe_queue_lcr',
queue_table => 'strmadmin.oe_qtab_lcr');
DBMS_AQADM.START_QUEUE(
queue_name => 'strmadmin.oe_queue_lcr');
END;
/
例22-22では、db01
に管理者ユーザーstrmadmin
として接続し、DBMS_TRANSFORM
パッケージを使用してdb01
にANYDATA
からLCR$_ROW_RECORD
への変換を作成します。
例22-22 ANYDATAからLCR$_ROW_RECORDへの変換の作成
CONNECT strmadmin;
Enter password: password
BEGIN
DBMS_TRANSFORM.CREATE_TRANSFORMATION(
schema => 'strmadmin',
name => 'anytolcr',
from_schema => 'SYS',
from_type => 'ANYDATA',
to_schema => 'SYS',
to_type => 'LCR$_ROW_RECORD',
transformation =>
'SYS.DBMS_STREAMS.CONVERT_ANYDATA_TO_LCR_ROW(source.user_data)');
END;
/
例22-23では、型指定キューのサブスクライバを作成します。このサブスクライバでは、transformation
パラメータに例22-22で作成したanytolcr
変換を指定します。
例22-23 サブスクライバROW_LCR_AGENT_REMOTEの作成
DECLARE subscriber SYS.AQ$_AGENT; BEGIN subscriber := SYS.AQ$_AGENT( 'ROW_LCR_AGENT_REMOTE', 'STRMADMIN.OE_QUEUE_LCR@DB02', 0); DBMS_AQADM.ADD_SUBSCRIBER( queue_name => 'strmadmin.oe_queue_any', subscriber => subscriber, rule => 'TAB.USER_DATA.GetTypeName()=''SYS.LCR$_ROW_RECORD''', transformation => 'strmadmin.anytolcr'); END; /
例22-24では、データベースdb01
にサンプル・スキーマ・ユーザーoe
として接続し、LCR行を構成してstrmadmin.oe_queue_any
キューにエンキューするプロシージャを作成します。
例22-24 LCR行を構成してエンキューするプロシージャの作成
CONNECT oe;
Enter password: password
CREATE PROCEDURE oe.enq_row_lcr_proc(
source_dbname VARCHAR2,
cmd_type VARCHAR2,
obj_owner VARCHAR2,
obj_name VARCHAR2,
old_vals SYS.LCR$_ROW_LIST,
new_vals SYS.LCR$_ROW_LIST)
AS
eopt DBMS_AQ.ENQUEUE_OPTIONS_T;
mprop DBMS_AQ.MESSAGE_PROPERTIES_T;
enq_msgid RAW(16);
row_lcr SYS.LCR$_ROW_RECORD;
BEGIN
mprop.SENDER_ID := SYS.AQ$_AGENT('LOCAL_AGENT', NULL, NULL);
row_lcr := SYS.LCR$_ROW_RECORD.CONSTRUCT(
source_database_name => source_dbname,
command_type => cmd_type,
object_owner => obj_owner,
object_name => obj_name,
old_values => old_vals,
new_values => new_vals);
DBMS_AQ.ENQUEUE(
queue_name => 'strmadmin.oe_queue_any',
enqueue_options => eopt,
message_properties => mprop,
payload => ANYDATA.ConvertObject(row_lcr),
msgid => enq_msgid);
END enq_row_lcr_proc;
/
例22-25では、最初にoe.enq_row_lcr_proc
プロシージャを使用して、oe.inventories
表に1行を挿入するLCR行を作成した後、そのLCR行をstrmadmin.oe_queue_any
キューにエンキューします。
注意: この例では、oe.inventories 表に新規の行を挿入しません。新規の行は、Oracle Streamsの適用プロセスによりLCR行がデキューされて適用されると挿入されます。
|
例22-25 LCR行の作成とエンキュー
DECLARE newunit1 SYS.LCR$_ROW_UNIT; newunit2 SYS.LCR$_ROW_UNIT; newunit3 SYS.LCR$_ROW_UNIT; newvals SYS.LCR$_ROW_LIST; BEGIN newunit1 := SYS.LCR$_ROW_UNIT( 'PRODUCT_ID', ANYDATA.ConvertNumber(3503), DBMS_LCR.NOT_A_LOB, NULL, NULL); newunit2 := SYS.LCR$_ROW_UNIT( 'WAREHOUSE_ID', ANYDATA.ConvertNumber(1), DBMS_LCR.NOT_A_LOB, NULL, NULL); newunit3 := SYS.LCR$_ROW_UNIT( 'QUANTITY_ON_HAND', ANYDATA.ConvertNumber(157), DBMS_LCR.NOT_A_LOB, NULL, NULL); newvals := SYS.LCR$_ROW_LIST(newunit1,newunit2,newunit3); oe.enq_row_lcr_proc( source_dbname => 'DB01', cmd_type => 'INSERT', obj_owner => 'OE', obj_name => 'INVENTORIES', old_vals => NULL, new_vals => newvals); END; / COMMIT;
LCRは、例22-18で作成したスケジュールに従ってデータベースdb02
に伝播します。伝播されるまで少し待ちます。その後、例22-26では、db02
でキュー表AQ$OE_QTAB_LCR
を問い合せて、伝播されたメッセージを表示します。
例22-26 伝播されたLCRの表示
CONNECT strmadmin;
Enter password: password
SELECT MSG_ID, MSG_STATE, CONSUMER_NAME FROM AQ$OE_QTAB_LCR;
この例では、次のようにROW_LCR_AGENT_REMOTE
に関するメッセージが1件戻されます。
MSG_ID MSG_STATE CONSUMER_NAME -------------------------------- ---------------- ------------------------------ ECE2B0F912DDFF5EE030578CE70A04BB READY ROW_LCR_AGENT_REMOTE
関連項目: LCR行およびDDL LCR変換関数の詳細は、『Oracle Database PL/SQLパッケージ・プロシージャおよびタイプ・リファレンス』のDBMS_STREAMSに関する項を参照してください。 |