Oracle 视图 V$PERSISTENT_QUEUES 官方解释,作用,如何使用详细说明

本站中文解释

Oracle视图 V$PERSISTENT_QUEUES 是一个虚拟视图,提供了当前实例中持久队列的详细信息。通过检索该视图,可以获取系统上可用的持久队列,例如队列范围、密钥,可以以及有关任何消息传递到消息队列的细节。

使用Oracle视图 V$PERSISTENT_QUEUES 时,可以使用下面这些参数:

NAME:该列指定了持久队列的名称。

PROVIDER:该列指定当前使用的持久性消息队列的提供程序的名称。

CLASSNAME:该列指定了客户机连接到提供程序的资源选择器的类名称。

VERSION:该列指定了要使用提供程序的当前JMS版本。

CUR_NUM_MSGS:该列显示了当前队列中消息的数量。

MAX_NUM_MSGS:该列显示了队列允许的最大消息数量。

MAX_MSG_SIZE:该列显示了队列中允许消息的最大大小。

MAX_BYTES_IN_MSG:该列显示了每个消息允许的最大字节数。

官方英文解释

V$PERSISTENT_QUEUES displays information about all active persistent queues in the database since the queues’ first activity time. There is one row per queue. The rows are deleted when the database (or instance in an Oracle RAC environment) restarts.

Column Datatype Description

QUEUE_ID

NUMBER

Identifier for the queue

QUEUE_TABLE_ID

NUMBER

Queue table identifier

QUEUE_SCHEMA

VARCHAR2(128)

Owner of the queue

QUEUE_NAME

VARCHAR2(128)

Name of the queue

FIRST_ACTIVITY_TIME

TIMESTAMP(6)

First queue activity time since database startup

ENQUEUED_MSGS

NUMBER

Number of messages enqueued

DEQUEUED_MSGS

NUMBER

Number of messages dequeued

Note: This column will not be incremented until all the subscribers of the message have dequeued the message and its retention time has elapsed.

BROWSED_MSGS

NUMBER

Number of messages that have been browsed

ELAPSED_ENQUEUE_TIME

NUMBER

Total time (in hundredths of a second) spent doing enqueue

ELAPSED_DEQUEUE_TIME

NUMBER

Total time (in hundredths of a second) spent doing dequeue

ENQUEUE_CPU_TIME

NUMBER

Total CPU time for enqueue (in hundredths of a second)

DEQUEUE_CPU_TIME

NUMBER

Total CPU time for dequeue (in hundredths of a second)

AVG_MSG_AGE

NUMBER

Average age of messages in the queue

DEQUEUED_MSG_LATENCY

NUMBER

Last dequeued message latency (in seconds)

ELAPSED_TRANSFORMATION_TIME

NUMBER

Total time (in hundredths of a second) spent doing transformation

ELAPSED_RULE_EVALUATION_TIME

NUMBER

Total time (in hundredths of a second) spent doing rule evaluation

ENQUEUED_EXPIRY_MSGS

NUMBER

Number of messages enqueued with expiry

ENQUEUED_DELAY_MSGS

NUMBER

Number of messages enqueued with delay

MSGS_MADE_EXPIRED

NUMBER

Number of messages expired by time manager

MSGS_MADE_READY

NUMBER

Number of messages made ready by time manager

LAST_ENQUEUE_TIME

TIMESTAMP(6)

Last message enqueue time

LAST_DEQUEUE_TIME

TIMESTAMP(6)

Last message dequeue time

LAST_TM_EXPIRY_TIME

TIMESTAMP(6)

Last time message was expired by time manager

LAST_TM_READY_TIME

TIMESTAMP(6)

Last time message was made ready by time manager

ENQUEUE_TRANSACTIONS

NUMBER

Number of enqueue transactions

DEQUEUE_TRANSACTIONS

NUMBER

Number of dequeue transactions

EXECUTION_COUNT

NUMBER

Number of executions of the dequeue cursor

OLDEST_MSGID

RAW(16)

Message ID of the oldest message in the queue

OLDEST_MSG_ENQTM

TIMESTAMP(6)

Enqueue time of the oldest message in the queue

MANDATORY_AFF_SWITCHES_OUT

NUMBER

An affinity switch is a change in 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 queue.

OPTIONAL_AFF_SWITCHES_OUT

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 queue.

AFF_SWITCHES_BACK_IN

NUMBER

The number of times dequeue affinities have come back from other instances to this instance. (MANDATORY_AFF_SWITCHES_OUT + OPTIONAL_AFF_SWITCHES_OUTAFF_SWITCHES_BACK_IN) is the number of cross instance affinities present across all shard-subscriber pair for shards owned by this instance for this queue.

CROSS_STREAM_JOBS

NUMBER

The number of times a shard is being forwarded to another instance due to cross instance dequeues for this queue

RESTORE_BITMAP_JOBS

NUMBER

The number of times subscribers used existing shard forwarding to have cross instance dequeues for this queue

SHADOW_AFF_SWITCHES_IN

NUMBER

The number of affinity switches for this queue where this instance is the dequeue instance for a shard-subscriber pair where the shard is being enqueued at another instance

SHADOW_AFF_SWITCHES_OUT

NUMBER

The number of affinity switches for this queue where shadow affinity is switched back to source instance of the shard. (SHADOW_AFF_SWITCHES_INSHADOW_AFF_SWITCHES_OUT) is the number of dequeue affinities which are performing cross instance dequeues from non-local shards.

SHADOW_SHARDS_RECEIVED

NUMBER

The number of times a shard is being forwarded from another instance to this instance due to cross instance dequeues for this queue

SHADOW_SHARDS_FREED

NUMBER

The number of times a forwarded shard to this instance was stopped due to removal of cross instance dequeues for this queue

SHADOW_EVENT_STREAMS_RECEIVEDFoot 1

NUMBER

The number of times an event stream is being forwarded from another instance to this instance due to cross instance dequeues for this queue

SHADOW_EVENT_STREAMS_FREEDFoot 1

NUMBER

The number of times a forwarded event stream to this instance was stopped due to removal of cross instance dequeues for this queue

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 Database 21c.

Note:

For sharded queues, only the following columns in this view contain accurate information: FIRST_ACTIVITY_TIME, BROWSED_MSGS, LAST_ENQUEUE_TIME, LAST_DEQUEUE_TIME, ENQUEUE_TRANSACTIONS, and DEQUEUE_TRANSACTIONS. The rest of the columns in this view should be ignored when querying information about sharded queues.


数据运维技术 » Oracle 视图 V$PERSISTENT_QUEUES 官方解释,作用,如何使用详细说明