Default: There is no default. If this parameter is not used, then the special data handling options it provides simply do not take effect.
Purpose
The DATA_OPTIONS
parameter designates how certain types of data should be handled during import operations.
Syntax and Description
DATA_OPTIONS = [DISABLE_APPEND_HINT | SKIP_CONSTRAINT_ERRORS | REJECT_ROWS_WITH_REPL_CHAR]
DISABLE_APPEND_HINT
- Specifies that you do not want the import operation to use the APPEND
hint while loading the data object. Disabling the APPEND
hint can be useful if there is a small set of data objects to load that already exist in the database and some other application may be concurrently accessing one or more of the data objects.
If DISABLE_APPEND_HINT
is not set, then the default behavior is to use the APPEND
hint for loading data objects.
SKIP_CONSTRAINT_ERRORS
- affects how non-deferred constraint violations are handled while a data object (table, partition, or subpartition) is being loaded. It has no effect on the load if deferred constraint violations are encountered. Deferred constraint violations always cause the entire load to be rolled back.
The SKIP_CONSTRAINT_ERRORS
option specifies that you want the import operation to proceed even if non-deferred constraint violations are encountered. It logs any rows that cause non-deferred constraint violations, but does not stop the load for the data object experiencing the violation.
If SKIP_CONSTRAINT_ERRORS
is not set, then the default behavior is to roll back the entire load of the data object on which non-deferred constraint violations are encountered.
REJECT_ROWS_WITH_REPL_CHAR
- specifies that you want the import operation to reject any rows that experience data loss because the default replacement character was used during character set conversion.
If REJECT_ROWS_WITH_REPL_CHAR
is not set, then the default behavior is to load the converted rows with replacement characters.
Restrictions
If DISABLE_APPEND_HINT
is used, then it can take longer for data objects to load.
If SKIP_CONSTRAINT_ERRORS
is used and if a data object has unique indexes or constraints defined on it at the time of the load, then the APPEND
hint will not be used for loading that data object. Therefore, loading such data objects will take longer when the SKIP_CONSTRAINT_ERRORS
option is used.
Even if SKIP_CONSTRAINT_ERRORS
is specified, it is not used unless a data object is being loaded using the external table access method.
Example
This example shows a data-only table mode import with SKIP_CONSTRAINT_ERRORS
enabled:
> impdp hr TABLES=employees CONTENT=DATA_ONLY DUMPFILE=dpump_dir1:table.dmp DATA_OPTIONS=skip_constraint_errors
If any non-deferred constraint violations are encountered during this import operation, then they will be logged and the import will continue on to completion.