You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs-source/transactional-event-queues/content/aq-migration/migration.md
+12-7Lines changed: 12 additions & 7 deletions
Original file line number
Diff line number
Diff line change
@@ -1,13 +1,24 @@
1
1
+++
2
2
archetype = "page"
3
-
title = "AQ Migration
3
+
title = "AQ Migration"
4
4
weight = 1
5
5
+++
6
6
7
7
This section covers the use of the [DBMS_AQMIGTOOL](https://docs.oracle.com/en/database/oracle/oracle-database/23/arpls/DBMS_AQMIGTOOL.html) package for migrating Advanced Queuing (AQ) classic queues to TxEventQ.
8
8
9
9
Users of AQ are recommended to migrate to TxEventQ for increased support, performance, and access to new database features. It is recommended to read through the document fully before attempting migration.
*[Checking and Handling Migration Errors](#checking-and-handling-migration-errors)
18
+
*[Cancelling and Recovering Migration](#cancelling-and-recovering-migration)
19
+
*[Limitations and Workarounds](#limitations-and-workarounds)
20
+
21
+
11
22
## DBMS_AQMIGTOOL Overview
12
23
13
24
The migration tool interface provides the following functionalities:
@@ -17,17 +28,11 @@ The migration tool interface provides the following functionalities:
17
28
- DBMS_AQMIGTOOL.INTERACTIVE (Default): Enqueue and dequeue operations are allowed, and the user must commit the migration.
18
29
- DBMS_AQMIGTOOL.OFFLINE: Only dequeue operations are allowed during migration, which can help in draining the AQ.
19
30
- DBMS_AQMIGTOOL.ONLY_DEFINITION: A TxEventQ copy is made from the AQ configuration, and messages are not migrated. Both the AQ and TxEventQ remain in the system after migration is committed with separate message streams. This option is recommended for users who prefer a more manual or custom migration.
20
-
21
31
- Users may decide to commit the migration or revert to AQ via the migration interface.
22
-
23
32
- During migration, in-flight messages can be tracked by viewing messages not in the PROCESSED state for both the AQ and TxEventQ.
24
-
25
33
- A migration history is recorded for all queues.
26
-
27
34
- Users may optionally purge old AQ messages if they wish to discard the data after migration.
28
-
29
35
- AQ Migration supports both rolling upgrades and Oracle GoldenGate (OGG) replication.
30
-
31
36
- During online migrations, it is safe for applications to continue enqueue/dequeue operations as normal.
0 commit comments