Valid and Invalid Extract Parameters for SQL Server Change Data Capture
This section describes parameters used for the CDC Capture method. For more information about supported and unsupported parameters for the CDC Capture method, review Parameters and Functions Reference for Oracle GoldenGate.
TRANLOGOPTIONS LOB_CHUNK_SIZE
The Extract parameter LOB_CHUNK_SIZE
is added for the CDC Capture method to support large objects. If you have huge LOB data sizes, then you can adjust the LOB_CHUNK_SIZE
from the default of 4000 bytes, to a higher value up to 65535 bytes, so that the fetch size is increased, reducing the trips needed to fetch the entire LOB.
Example: TRANLOGOPTIONS LOB_CHUNK_SIZE 8000
TRANLOGOPTIONS MANAGECDCCLEANUP/NOMANAGECDCCLEANUP
The Extract parameter MANAGECDCCLEANUP/NOMANAGECDCCLEANUP
is used by the CDC Capture method to instruct the Extract on whether or not to maintain recovery checkpoint data in the Oracle GoldenGate CDC Cleanup job. The default value is MANAGECDCCLEANUP
and it doesn’t have to be explicitly listed in the Extract. However, it does require creating the Oracle GoldenGate CDC Cleanup job prior to starting the Extract. MANAGECDCCLEANUP
should be used for all production environments, where NOMANAGECDCCLEANUP
may be used for temporary and testing implementations as needed.
Example: TRANLOGOPTIONS MANAGECDCCLEANUP
TRANLOGOPTIONS
EXCLUDEUSER/EXCLUDETRANS
The SQL Server CDC Capture job does not capture user information or
transaction names associated with a transaction, and as this information is not
logged in the CDC staging tables, Extract has no method of excluding DML from a
specific user or DML of a specific transaction name. The
EXCLUDEUSER
and EXCLUDETRANS
parameters are
therefore not valid for the CDC Capture process.
TRANLOGOPTIONS
MANAGESECONDARYTRUNCATIONPOINT/NOMANAGESECONDARYTRUNCATIONPOINT/ACTIVESECONDARYTRUNCATIONPOINT
The SQL Server Change Data Capture job is the only process that captures data from the transaction log when using the Oracle GoldenGate CDC Capture method. The secondary truncation point management is not handled by the Extract, and for the Change Data Capture Extract, these parameters are not valid.
TRANLOGOPTIONS ALWAYSONREADONLYROUTING
The ALWAYSONREADONLYROUTING
parameter allows Extract for SQL
Server to route its read-only processing to an available read-intent Secondary
when connected to an Always On availability group listener.
TRANLOGOPTIONS QUERYTIMEOUT
Specifies how long queries to SQL Server will wait for results before reporting a timeout error message. This option takes an integer value to represent the number of seconds. The default query timeout value is 300 seconds (5 minutes). The minimum value is 0 seconds (infinite timeout). The maximum is 2147483645 seconds.
TRANLOGOPTIONS TRANCOUNT
Allows adjustment of the number of transactions processed per each call by Extract to pull data from the SQL Server change data capture staging tables. Based on your transaction workload, adjusting this value may improve capture rate throughput, although not all workloads will be positively impacted. The minimum value is 1, maximum is 100, and the default is 10.