Oracle

Advanced Queuing
Naresh Kumar Y

Agenda

Introduction
Environment setup
Packages to manage AQs
Payload
Queue table
Create Queue
Grant privileges
Message properties
Enqeue options
Enqueue message
Deqeue options
Dequeue message

Introduction

Exchanging messages and

communicating between two or more
different application modules

Environment setup

Administration and access privileges

for advanced queuing are controlled
using the below two roles
AQ_ADMINISTRATOR_ROLE - Allows
creation and administration of queuing
infrastructure.
AQ_USER_ROLE - Allows access to
queues for enqueue and dequeue
operations.

Packages to manage AQs

DBMS_AQADM - To perform below

Admin operations like creating
queue, queue tables, stop queue,
drop queue etc.
DBMS_AQ - To manage the Queues
like enqueue, dequeue etc.

Payload

AQ handles messages known as

payloads.
The format and structure of the
messages are designed by payload
Payload type can be either userdefined objects , xml type, ANYDATA,
RAW.

Queue table

Queue table store the queue information

We can create multiple queues for the
single queue table
Create queue table using the DBMS_AQ
package.
Example ::
DBMS_AQADM.create_queue_table
(queue_table
=>
'xx_event_queue_tbl',
queue_payload_type
=> 'customer_msg'
);

Create queue
Create and start queue using DBMS_AQ
package.
Example ::
DBMS_AQADM.create_queue (queue_name
=> XX_CUSTOMER_Q',
queue_table
=> 'xx_event_queue_tbl'
);
DBMS_AQADM.start_queue
(queue_name => XX_CUSTOMER_Q',
enqueue => TRUE);

Grant privileges
After creating and starting queue, we need
to give grants to user schema to manage
the queues.
Example
DBMS_AQADM.grant_queue_privilege
( privilege => 'ALL',
queue_name => 'aq_admin.event_queue',
grantee => 'aq_user
);

Message Properties

Before enqueue a message, We must

create and set the properties of
message by using the below record
type
DBMS_AQ.message_properties_t;

Message Properties(Contd.)

message_properties_tTYPE
message_properties_t IS RECORD (
priority BINARY_INTEGER DEFAULT 1,
delay BINARY_INTEGER DEFAULT NO_delay,
expiration BINARY_INTEGER DEFAULT NEVER,
correlation VARCHAR2(128) DEFAULT NULL,
attempts BINARY_INTEGER,
recipient_list aq$_recipient_list_t,
exception_queue VARCHAR2(51) DEFAULT NULL,
enqueue_time DATE,
state BINARY_INTEGER,
sender_id aq$_agent DEFAULT NULL,
original_msgid RAW(16) DEFAULT NULL);
/

Enqeue options

enqueue_options_t TYPE
enqueue_options_t IS RECORD (
visibilityBINARY_INTEGER DEFAULT
ON_COMMIT,
relative_msgid RAW(16) DEFAULT NULL,
sequence_deviation BINARY_INTEGER
DEFAULT NULL,
transformation VARCHAR2(60) DEFAULT
NULL);
/

Enqueue message

After creating the queue, we can enqueue the

queue using DBMS_AQ
Example ::
DBMS_AQ.enqueue
(queue_name => 'AQADMIN.XX_CUSTOMER_Q',
enqueue_options => aq_enqueue_options,
message_properties
=>
aq_message_properties,
payload
=> aq_message,
msgid
=> raw_message_handle
);

Deqeue options

dequeue_options_t TYPE dequeue_options_t IS

RECORD (
consumer_name VARCHAR2(30) DEFAULT NULL,
dequeue_mode BINARY_INTEGER DEFAULT
REMOVE,
navigation BINARY_INTEGER DEFAULT
NEXT_MESSAGE,
visibility BINARY_INTEGER DEFAULT ON_COMMIT,
wait BINARY_INTEGER DEFAULT FOREVER,
msgid RAW(16) DEFAULT NULL,
correlation VARCHAR2(128) DEFAULT NULL,
deq_condition VARCHAR2(4000) DEFAULT NULL,
signature aq$_sig_prop DEFAULT NULL,
transformation VARCHAR2(60) DEFAULT NULL,
delivery_mode PLS_INTEGER DEFAULT
PERSISTENT);

Dequeue message

After Enqueue the message, We can dequue the

message.
Example ::
DBMS_AQ.dequeue
(queue_name => 'AQADMIN.XX_CUSTOMER_Q',
dequeue_options
=>
aq_dequeue_options,
message_properties
=>
aq_message_properties,
payload
=> aq_message,
msgid
=> raw_message_handle
);