V$AQ_SUBSCRIBER

7.29 V$AQ_SUBSCRIBER_LOAD

V$AQ_SUBSCRIBER_LOAD describes the load of all subscribers of sharded queues in terms of latency at every instance in an Oracle RAC environment.

Latency denotes the predicted amount of time (in seconds) required from the current time to drain all the messages for that subscriber at each respective instance. The latency calculation considers past enqueue/dequeue rates and future enqueue/dequeue rates based on history.

Column	Datatype	Description
`QUEUE_ID`	`NUMBER`	Queue ID
`QUEUE_SCHEMA`	`VARCHAR2(128)`	Queue schema
`QUEUE_NAME`	`VARCHAR2(128)`	Queue name
`SUBSCRIBER_ID`	`NUMBER`	Subscriber ID
`SUBSCRIBER_NAME`	`VARCHAR2(128)`	Subscriber name
`LATENCY_STATE`	`VARCHAR2(8)`	Possible values: FINITE - The subscriber will be able to dequeue all the messages in a finite amount of time INFINITE - The subscriber's dequeue rate may not catch up to the enqueue rate UNKNOWN - Latency is not yet known
`LATENCY`	`NUMBER`	Latency (in seconds). Valid only when `LATENCY_STATE` is `FINITE`.
`DEQUEUE_REQUESTS`	`NUMBER`	Approximate number of dequeue requests noted recently
`ACTIVE_SHARDS`	`NUMBER`	Number of queue shards that have messages for this subscriber
`ACTIVE_LISTENER`	`VARCHAR2(5)`	Indicates whether the subscriber is actively listening at this instance for messages (TRUE) or not (FALSE)
`DEQUEUE_SESSIONS`^Foot 1	`NUMBER`	Displays the number of active dequeue sessions for this subscriber
`FLAGS`	`NUMBER`	For internal use only
`MANDATORY_AFF_SWITCHES`	`NUMBER`	An affinity switch is a change in the dequeue instance for a shard-subscriber pair. A mandatory affinity switch is when there are local enqueues in the queue at the instance but no local dequeues present, so the dequeue affinity is switched to another instance for that shard-subscriber pair. This column shows the number of times mandatory affinity switches were needed from this instance to another for this subscriber.
`OPTIONAL_AFF_SWITCHES`	`NUMBER`	Optional affinity switches are affinity switches that are not mandatory. Optional affinity switches are done for global load balancing across the Oracle Real Application Clusters (Oracle RAC) database. This column shows the number of times optional affinity switches were needed from this instance to another for this subscriber.
`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 1This column is available starting with Oracle Database release 19c, version 19.1.