Prepare command - Adding new tables
Once the replication has been configured and is running, new objects can be added to the replication.
New tables can be replicated with the command:
dbvrep> PREPARE TABLE schema.table_name
Ensure that the appropriate privileges are given to the Dbvisit Replicate owner on both the source and target. The privileges are:
SQL> grant select, update, insert, delete on schema.table_name to dbvrep;
If a DDL replication was enabled during the Setup Wizard (Step 2 - Replication pairs), the Dbvisit Replicate owner on the target database already has SELECT/INSERT/UPDATE/DELETE ANY privileges. No other grants should be necessary.
If a table is added to the replication that already has historic data, then this data needs to be added to the target table. Please see "Loading the data before table is added to replication" below.
In one-to-many replication, you have to choose which replication process you want the new table to belong to before preparing the table for replication.
dbvrep> CHOOSE REPLICATION APPLY dbvrep> PREPARE TABLE schema.table_name dbvrep> CHOOSE REPLICATION APPLY1 dbvrep> PREPARE TABLE schema.table_name
Loading the data before table is added to replication
When a new table is added to the replication, it is usually necessary to ensure that the historical data is in the target table before the replication starts. This is also called data instantiation. To ensure there is no gap between loading the historical data and starting the replication, we recommend the following steps:
- Pause the APPLY process (PAUSE APPLY)
- PREPARE the new table. Dbvisit Replicate will give the SCN of where the table will be replicated from.
- Use the SCN from step 2 to load the historical data (Example use datapump with flashback_scn=xxx)
- Resume the replication (RESUME APPLY)
The PREPARE commands add supplemental logging to the table if it was not there yet. This can sometimes result in the ORA-01466 error while performing step 3.
If this happens, we recommend using the internal commands to prepare a new table. In following example, scott.emp table is prepared. It first adds the supplemental logging, then waits for the SCN to advance then it does the actual PREPARE:
dbvrep>ENGINE SUPPLEMENTAL LOGGING TABLE SCOTT.EMP ENABLE PRIMARY KEY
dbvrep>PREPARE TABLE SCOTT.EMP
The table needs to exist on the target side before the APPLY process can be resumed. Using datapump in step 3 is a good choice, since the import creates the table automatically if it does not exist.
impdp does not actually compare the SCNs, but timestamp converted using dbms_flashback to SCN and the last_ddl time in dba_objects.
Adding new schemas
To add a new schema to the replication run the following command:
dbvrep> PREPARE SCHEMA schema
All the tables within the schema including the historical data must be initialized in the same way as described above for the single table preparation. Follow those steps to ensure there is no data missing on the target side before the replication is started.
Removing tables & schemas
To manually remove a table from the replication:
dbvrep> UNPREPARE TABLE schema.table_name
Use UNPREPARE SCHEMA command to manually remove the whole schema.