My Oracle Support Banner

How to perform a movement of Advanced Queueing Tables across tablespaces using DBMS_AQADM.MOVE_QUEUE_TABLE (Doc ID 2867445.1)

Last updated on MAY 05, 2022

Applies to:

Oracle Database Cloud Exadata Service - Version N/A and later
Oracle Database Cloud Service - Version N/A and later
Oracle Database - Enterprise Edition - Version 12.1.0.2 and later
Oracle Database Cloud Schema Service - Version N/A and later
Gen 1 Exadata Cloud at Customer (Oracle Exadata Database Cloud Machine) - Version N/A and later
Information in this document applies to any platform.

Purpose

The purpose of this article is to discuss and provide a procedure which enables you to perform a movement of  Advanced Queuing (AQ) tables using interface DBMS_AQADM.MOVE_QUEUE_TABLE.

Scope

This article is intended for anyone who needs to move AQ objects from one tablespace to another or within the same tablespace. The procedure can be executed in 19c or later databases.DBMS_AQADM.MOVE_QUEUE_TABLE is a new and standard interface to be used for moving a queue table from its original tablespace to a new (target) tablespace.

There are two modes in which the interface DBMS_AQADM.MOVE_QUEUE_TABLE can be run:

  1. OFFLINE Mode:

This is a default mode. This will move the queue table by first stopping all the queues owned by a queue table. With this, we make sure no queueing activity is running in parallel when the move operation is going on. The queues are restored to their original state once the move operation is completed.

  1. ONLINE Mode:

This can be turned on by specifying the MOVEQT_ONLINE option in the MOVE_QUEUE_TABLE interface. Given this is an online mode, the table movement will happen without affecting the parallel queueing activities. This mode can run into ORA-54 error (resource busy), if the parallel queueing activities are very intense and not enough resources are available for table movement. In such cases, you may either retry the operation after waiting for some time or switch to an OFFLINE mode.  

 Note: By 'queueing activity', we mean enqueue and dequeue operations.

Details

To view full details, sign in with your My Oracle Support account.

Don't have a My Oracle Support account? Click to get started!


In this Document
Purpose
Scope
Details
References

My Oracle Support provides customers with access to over a million knowledge articles and a vibrant support community of peers and Oracle experts.