V$AQ_SHARDED_SUBSCRIBER_STAT

V$AQ_SHARDED_SUBSCRIBER_STAT displays basic statistical information about the subscribers of sharded queues. There is one row per queue per shard per subscriber.

Note: AQ sharded queues are deprecated in Oracle Database 21c. Oracle recommends that you instead use Transactional Event Queues (TxEventQs) for higher throughput and better performance.

Column Datatype Description
QUEUE_ID NUMBER Queue identifier
SUBSCRIBER_ID NUMBER Subscriber identifier
SHARD_ID NUMBER Shard identifier
PRIORITY NUMBER Priority value of the shard
MSG_SN NUMBER Message serial number
DEQUEUE_SUBSHARD NUMBER Last known dequeue position in this shard
ENQUEUED_MSGS NUMBER Number of enqueued messages
DEQUEUED_MSGS NUMBER Number of dequeued messages
ELAPSED_DEQUEUE_TIME NUMBER Amount of time spent performing dequeues (in seconds)
CPU_DEQUEUE_TIME NUMBER Actual amount of CPU time spent performing dequeues (in seconds)
DEQUEUE_RATE NUMBER Number of messages dequeued per second
DEQUEUE_POSITION RAW(16)

Message ID at the dequeue position of the subscriber in this shard

A NULL value indicates that either the shard is empty or no dequeues have been done on this shard.

TIME_SINCE_LAST_DEQUEUE NUMBER Time since last dequeue activity (in seconds)
ESTD_TIME_TO_DRAIN NUMBER Estimated amount of time to drain the shard (in seconds) with current enqueue and dequeue rates. Null, if the enqueue rate is greater than the dequeue rate.
ESTD_TIME_TO_DRAIN_NO_ENQ NUMBER Estimated amount of time to drain the shard (in seconds) with no new enqueues
MESSAGE_LATENCY_1 NUMBER Message latency within the last 5 minutes (in milliseconds). Null if no message is consumed or it is delay dequeue.
MESSAGE_LATENCY_2 NUMBER Message latency within the last 1 hour (in milliseconds). Null if no message is consumed or it is delay dequeue.
MESSAGE_LATENCY_3 NUMBER Message latency within the last 5 hours (in milliseconds). Null if no message is consumed or it is delay dequeue.
NUM_DEQUEUE_ATTEMPTSFoot 1 NUMBER

Number of dequeue attempts

A single dequeue call may result in multiple internal dequeue attempts, and this value may not match the number of dequeue calls made by the client.

WM_FLAGFoot 1 NUMBER Reserved for internal use
MIN_READY_MESSAGE_IDFoot 1 RAW(16) Message ID of the earliest next message (that is, the minimum READY time) with non-zero delay, not yet dequeued by the subscriber
MIN_READY_FLAGFoot 1 NUMBER Reserved for internal use
MIN_READY_TIMESTAMPFoot 1 TIMESTAMP(6) WITH TIME ZONE Ready time of the earliest next message (that is, the minimum READY time) with non-zero delay, not yet dequeued by the subscriber
EXPIRED_MSGSFoot 1 NUMBER Number of messages that were marked as expired before being dequeued by the subscriber
SKIPPED_MSGSFoot 1 NUMBER

Number of messages marked as skipped for rule-based subscribers

Messages that do not qualify for the subscriber's rule are marked as skipped.

DEQUEUE_LWM_SUBSHARDFoot 1 NUMBER Subshard identifier of the dequeue low watermark
DEQUEUE_LWM_SNFoot 1 NUMBER Sequence number of the dequeue low watermark message within the subshard identified by DEQUEUE_LWM_SUBSHARD
DEQUEUE_LWM_PROPFoot 1 NUMBER

Indicates the position of the dequeue low watermark relative to the message identified by DEQUEUE_LWM_SN:

  • 0 - The dequeue low watermark is at the message identified by DEQUEUE_LWM_SN.

  • 1 - The dequeue low watermark is after the message identified by DEQUEUE_LWM_SN.

RETENTION_TIME_ELAPSED_MSGS NUMBER

Number of messages whose retention time elapsed before being dequeued by the subscriber and were therefore marked for purging from the queue

This count is incremented only when the queue-level parameter RETENTION_TYPE is set to 1, meaning retention is computed with reference to the message ENQUEUE_TIME. Messages may be purged after the number of seconds specified by the RETENTION_TIME parameter has elapsed.

CON_ID NUMBER

The ID of the container to which the data pertains. Possible values include:

  • 0: This value is used for rows containing data that pertain to the entire CDB. This value is also used for rows in non-CDBs.

  • 1: This value is used for rows containing data that pertain to only the root

  • n: Where n is the applicable container ID for the rows containing data

Footnote 1 This column is available starting with Oracle AI Database 26ai, Release Update 23.26.1.