impdp的TABLE_EXISTS_ACTION参数选项-白红宇

impdp有一个参数选项TABLE_EXISTS_ACTION，help=y的解释为：

Action to take if imported object already exists.

Valid keywords are: APPEND, REPLACE, [SKIP] and TRUNCATE.

官方文档有句话：

“Only objects created by the Import will be remapped. In particular, the tablespaces for preexisting tables will not be remapped if

TABLE_EXISTS_ACTION is set to

SKIP,

TRUNCATE, or

APPEND.”。

仅仅是import创建的对象会被重新映射，如果使用了SKIP、TRUNCATE或APPEND，已存表对应的表空间不会有变化。

官方文档(Oracle® Database Utilities11g Release 2 (11.2))中对这个参数的描述如下：

这个参数目的是为了告诉impdp，试图创建的表是否在库中已存在。

默认值是skip，但若设置了CONTENT=DATA_ONLY，则默认值是APPEND，不是SKIP。

TABLE_EXISTS_ACTION=[SKIP | APPEND | TRUNCATE | REPLACE]

SKIP：跳过这张表，继续下一个对象。如果CONTENT设置了DATA_ONLY参数，则不能使用SKIP。

APPEND：会加载数据至对象，但不会影响已存在的行。

TRUNCATE：删除已存在的行，然后加载所有的数据。

REPLACE：drop已存在的表，然后create并加载数据。如果CONTENT设置了DATA_ONLY，则不能使用REPLACE。

还有一些其他的考虑：

1. 使用TRUNCATE或REPLACE，确保所有涉及的表行不会存在其他的参照约束关系。容易理解，例如目标表是和其他表存在外键关联，但只导入这张表，就可能会破坏这种关系。

2. 使用SKIP，APPEND，TRUNCATE，已存在表的依赖对象，例如索引、grants授权、触发器和约束，不会被修改。对于REPLACE，如果依赖对象未被显式或隐式使用EXCLUDE排除，并且存在于dump文件中，则会drop然后create重建。

3. 使用APPEND或TRUNCATE，会在执行操作前进行一些检查，以确保源dump和已存表兼容，包括：

(1) 若已存在的表有active的约束和触发器，就会使用外部表访问的方法加载数据。如果任何行违反了约束，则加载失败，不会有任何数据加载进来。当然，可以使用DATA_OPTIONS=SKIP_CONSTRAINT_ERRORS来跳过这环节。

(2) 如果需要加载一些可能会违反约束的数据，可以考虑先disable这些约束，加载数据后，删除这些有问题的记录，然后再enable约束。

(3) 使用APPEND，数据会加载至新的空间，即使现有空间仍能重用。可以加载完成后，压缩数据。

另外，如果数据泵发现原表和目标表不匹配(例如两张表的列数量不同，或者目标表中有一列不在原表中)，他会比较两张表的列名。如果两张表至少有一个列相同，则会导入这个列的数据(前提是数据类型兼容)。这种做法也有一些限制，

(a) 如果使用network参数导入则不能使用。

(b) 以下列的类型不能删除：列对象、列属性、嵌套表列、基于主键的引用列。

还有就是TRUNCATE不能用于聚簇表。

通过对一张表使用以上四种选项的实验，来看看区别。

测试表：

create table test(id number);

insert into test values(1);

commit;

expdp user_exp/user_exp directory=EXPDP_DIR dumpfile=user_exp.dmp

insert into test values(2);

commit;

此时user_exp.dmp包含test表，且有一条id=1的记录。表中有id=1和id=2两条记录。

REPLACE选项：

impdp user_exp/user_exp TABLE_EXISTS_ACTION=replace dumpfile=user_exp.dmp directory=expdp_dir

SQL> select * from test;

----------

此时表中只有id=1的记录，说明使用dmp覆盖了test表。

SKIP选项：

impdp user_exp/user_exp TABLE_EXISTS_ACTION=skip dumpfile=user_exp.dmp directory=expdp_dir

ORA-39151: Table "USER_EXP"."TEST" exists. All dependent metadata and data will be skipped due to table_exists_action of skip

SQL> select * from test;

----------

此时导入报错，说明是skip了已存在的对象，test表仍保持原状。

APPEND选项：

impdp user_exp/user_exp TABLE_EXISTS_ACTION=append dumpfile=user_exp.dmp directory=expdp_dir

ORA-39152: Table "USER_EXP"."TEST" exists. Data will be appended to existing table but all dependent metadata will be skipped due to table_exists_action of append

SQL> select * from test;

----------

虽然报错，但仍插入了test记录，报错提示了数据会append附加至已存在表中，但若有依赖关系的元数据，则会忽略。

TRUNCATE选项：

impdp user_exp/user_exp TABLE_EXISTS_ACTION=truncate dumpfile=user_exp.dmp directory=expdp_dir

ORA-39153: Table "USER_EXP"."TEST" exists and has been truncated. Data will be loaded but all dependent metadata will be skipped due to table_exists_action of truncate

SQL> select * from test;

----------

报错提示对象已被truncate，但若有依赖关系的元数据，会被忽略。