SCHEMAEXCLUDE
Valid For
Extract, Replicat, DEFGEN
Description
Use the SCHEMAEXCLUDE
parameter to exclude source objects that are owned by the specified source owner (such as a schema) from the Oracle GoldenGate configuration when wildcards are being used to specify the owners in TABLE
or MAP
statements. This parameter is valid for two- and three-part names.
Wildcards can be used for the optional catalog
or container
specification, as well as the schema
specification. Make certain not to use wildcards such that all objects are excluded. Follow the rules for using wildcards in Administering Oracle GoldenGate.
The positioning of SCHEMAEXCLUDE
in relation to parameters that specify files or trails determines its effect. Parameters that specify trails or files are: EXTFILE
, RMTFILE
, EXTTRAIL
, RMTTRAIL
. The parameter works as follows:
-
When a
SCHEMAEXCLUDE
specification is placed before anyTABLE
orSEQUENCE
parameters, and also before the parameters that specify trails or files, it applies globally to all trails or files, and to allTABLE
andSEQUENCE
parameters. -
When a
SCHEMAEXCLUDE
specification is placed after a parameter that specifies a trail or file, it is effective only for that trail or file and only for theTABLE
orSEQUENCE
parameters that are associated with it. Multiple trail or file specifications can be made in a parameter file, each followed by a set ofTABLE
,SEQUENCE
, andTABLEEXCLUDE
specifications.
SCHEMAEXCLUDE
is evaluated before evaluating the associated TABLE
or SEQUENCE
parameters. Thus, the order in which they appear does not make a difference.
See also the EXCLUDEWILDCARDOBJECTSONLY
parameter.
Default
None
Syntax
SCHEMAEXCLUDE [container
.]schema
-
container
. -
If the database requires three-part names, specifies the source Oracle container that contains the source owner that is to be excluded. Use if a qualifier is required to identify the correct owner to exclude.
-
schema
-
Specifies the name of the source owner that is to be excluded. For databases that require three-part names, you can use
schema
withoutcontainer
if theSCHEMAEXCLUDE
specification precedes a set ofTABLE
orMAP
parameters for which the default container is specified with theSOURCECATALOG
parameter.
Examples
- Example 1
-
This Oracle example requires both
container
andschema
specifications and demonstrates how wildcards can be used as part of the specification.EXTRACT capt USERIDALIAS alias1 RMTHOST sysb, MGRPORT 7809 RMTTRAIL /ggs/dirdat/aa SCHEMAEXCLUDE pdbtest.test* TABLE pdb*.*.*;
- Example 2
-
This example shows how to use
SCHEMAEXCLUDE
when the database requires only a two-part name.TABLE abc*.*; SCHEMAEXCLUDE abctest*