DB2 import

DB2 IMPORT 实用程序

IMPORT 实用程序概述

IMPORT 实用程序用一个输入文件将数据填充到一个表中，输入文件的文件类型可以是 ASC、DEL、IXF 或 WSF。目标是一个表、一个类型化表（typed table）或者一个视图。但是，不能导入到系统表、临时表和物化查询表。建议使用 MESSAGES 子句，以便记录错误、警告和包含有用信息的消息。

要想成功地导入数据，必须拥有 SYSADM 或 DBADM 权限，或者目标表或数据库上的底层特权（SELECT、INSERT、CONTROL 或 CREATETAB），这取决于使用什么选项。为了将数据导入到一个包含受保护的行和列的表中，必须拥有允许对表中所有受保护数据进行写访问的 LBAC 凭证。此外，将数据导入包含受保护行的表时，要求您的 LBAC 凭证是保护表的安全策略的一部分。

下面显示的 IMPORT 命令具有五个不同的选项：

IMPORT FROM file_name OF file_type
MESSAGES message_file
[ INSERT | INSERT_UPDATE | REPLACE | REPLACE_CREATE | CREATE ]
INTO target_table_name

INSERT 选项将导入的数据插入表中。目标表必须已经存在。
INSERT_UPDATE 将数据插入表中，或者更新表中具有匹配主键的行。目标表必须已经存在，并且定义了一个主键。
REPLACE 选项删除所有已有的数据，并将导入的数据插入到一个已有的目标表中。
使用 REPLACE_CREATE 选项时，如果目标表已经存在，则导入实用程序删除已有的数据，并插入新的数据，就像 REPLACE 选项那样。如果目标表还没有定义，那么首先创建这个表以及它的相关索引，然后再导入数据。正如您可能想像的那样，输入文件必须是 PC/IXF 格式的文件，因为那种格式包含对导出表的结构化描述。如果目标表是被一个外键引用的一个父表，那么就不能使用 REPLACE_CREATE。
CREATE 选项首先创建目标表和它的索引，然后将数据导入到新表中。该选项惟一支持的文件格式是 PC/IXF。还可以指定新表所在表空间的名称。
例子：

IMPORT FROM emp.ixf OF IXF
MESSAGES msg.out
CREATE INTO employee IN datatbsp INDEX IN indtbsp

--------------------------------------------------------------------------------
回页首
IMPORT 选项

IMPORT 基本上是用于成批插入数据的一个实用程序。这种成批插入操作就像一般的插入语句一样，也涉及到活动的日志记录、索引的更新、参照完整性检查和表约束检查。默认情况下，IMPORT 只在操作结束时提交一次。如果将大量的行一次性导入或插入到表中，那么需要有足够的事务记录用于回滚和恢复。此外也可以采用周期性的提交，以防日志写满。通过定期地提交插入，还可以减少导入操作期间出现失败时丢失的行数。COMMITCOUNT 选项规定在导入一组记录后强制执行 COMMIT。还可以指定 AUTOMATIC 选项，该选项允许导入实用程序在内部决定何时需要执行提交。该实用程序将考虑发出一个提交命令，以避免日志写满或者避免锁升级。下面是关于如何使用 COMMITCOUNT 选项的一个例子：

IMPORT FROM myfile.ixf OF IXF
COMMITCOUNT 500
MESSAGES msg.out
INSERT INTO newtable

如果由于某种原因导致以上命令在执行期间遭到失败，那么可以使用消息文件来确定成功导入且已提交的最后一行。然后，可以使用 RESTARTCOUNT 选项重新开始导入。注意，SKIPCOUNT 选项的行为与 RESTARTCOUNT 是相同的。在下面的命令中，该实用程序在开始 IMPORT 操作之前，将忽略前 30,000 条记录。

IMPORT FROM myfile.ixf OF IXF
COMMITCOUNT 500 RESTARTCOUNT 30000 ROWCOUNT 100000
MESSAGES msg.out
INSERT INTO newtable

注意，这个例子中还使用了 ROWCOUNT 选项。该选项指定要导入的物理记录的条数。由于使用了 RESTARTCOUNT 选项，导入实用程序将忽略前 30,000 条记录，并且将剩下的 100,000 条记录导入到表中。

默认情况下，在插入任何行之前，导入实用程序将获得目标表上的一个排它锁。一旦导入完成，这个排它锁将被释放。这是 ALLOW NO ACCESS 选项的行为。为了允许并发应用程序访问表数据，可以使用 ALLOW WRITE ACCESS 选项。注意，该选项与 REPLACE、CREATE 或 REPLACE_CREATE 导入选项不兼容。下面是关于 ALLOW WRITE ACCESS 选项的一个例子。

IMPORT FROM myfile.ixf OF IXF
ALLOW WRITE ACCESS
MESSAGES msg.out
INSERT INTO newtable

--------------------------------------------------------------------------------
回页首
导入 XML 数据

为了导入 XML 文件，可以使用 XML FROM 选项指定 XML 文件所在的一个或多个路径。否则，导入实用程序将在当前目录中查找 XML 文件。您可以选择如何解析 XML 文档；是去掉空白还是保留空白。如果没有指定 XMLPARSE 选项，那么将根据 CURRENT XMLPARSE OPTION 专用寄存器来决定对 XML 文档的解析行为。下面是关于 XML FROM 和 XMLPARSE 选项的一个例子。

IMPORT FROM myfile.ixf OF IXF
XML FROM d:\xmlpath
XMLPARSE PRESERVE WHITESPACE
MESSAGES msg.out
INSERT INTO newtable

当插入或更新一个 XML 文档时，您可能想确定 XML 文档的结构、内容和数据类型是否有效。导入实用程序还通过 XMLVALIDATE 选项提供了对 XML 验证的支持。下面是可用的三种方法。

USING XDS —— 回想一下，您可以导出 XML 模式信息并将它存储在 XML Data Specifier （XDS） 的 SCH 属性中。SCH 属性的值将用于执行验证。如果在 XDS 中没有 SCH 属性，则考虑 DEFAULT、IGNORE 或 MAP 三者之中的一个值。
USING SCHEMA schema-sqlid —— 使用这个子句中指定的 XML 模式。
USING SCHEMALOCATION HINTS —— 根据源 XML 文档中 XML 模式位置提示所标识的模式来验证 XML 文档。
IMPORT FROM myfile.ixf OF IXF
XML FROM d:\xmlpath
XMLPARSE PRESERVE WHITESPACE
XMLVALIDATE USING XDS
DEFAULT S1.SCHEMA_A
IGNORE (S1.SCHEMA_X, S1.SCHEMA_Y, S1.SCHEMA_Z)
MAP (S1.SCHEMA_A, S1.SCHEMA_B)
COMMITCOUNT 500 RESTARTCOUNT 30000
MESSAGES msg.out
INSERT INTO newtable

前面的 IMPORT 命令将：

插入 myfile.ixf 和 d:\xmlpath 下的 XML 文件中的数据。
当解析 XML 文档时，保留空白。
使用 XDS 的 SCH 属性标识的模式信息对每个 XML 文档进行验证。但是，如果用于任何特定行的 XDS 没有包含 SCH 属性，那么使用 S1.SCHEMA_A。
如果 SCH 属性被指定为 S1.SCHEMA_X 或 S1.SCHEMA_Y 或 S1.SCHEMA_Z，那么对于导入的 XML 文档不执行验证。
如果 SCH 属性被指定为 S1.SCHEMA_A，它将被映射到 S1.SCHEMA_B。注意，尽管 DEFAULT 子句指定了 S1.SCHEMA_A，但是后面的任何映射都将不会执行。
每导入 500 行之后，导入实用程序将发出一次提交命令。
导入操作从第 30,001 条记录开始。前 30,000 条记录被忽略。
任何错误、警告和包含信息的消息都写到 msg.out 文件中。
将新数据插入（或附加）到 newtable 中。
这个例子只是让您对如何验证导入的 XML 文档有一些认识。DB2 Information Center 中还有更多的例子来演示 XMLVALIDATE 选项的威力。

--------------------------------------------------------------------------------
回页首
文件类型修饰符

IMPORT 实用程序还支持五种文件类型修饰符来定制导入操作。在 DB2 Command Reference 的 IMPORT 小节下有这些修饰符的一个完整的列表。下面列出了其中一些修饰符：

compound=x
使用非原子复合 SQL 插入数据。x 是每次将尝试的语句数量。
indexschema=schema
使用索引创建期间指定的用于索引的模式。
striptblanks
将数据装载到可变长度字段时，截去结尾空白。
lobsinfile
表明将导入 LOB 数据。导入实用程序将检查 LOBS FROM 子句，以获得输入 LOB 文件的路径。
下面是使用这些文件类型修饰符的一个例子：

IMPORT FOR inputfile.asc OF ASC
LOBS FROM /u/db2load/lob1, /u/db2load/lob2
MODIFIED BY compount=5 lobinsfile
INSERT INTO newtable

--------------------------------------------------------------------------------
回页首
使用 Control Center 执行导入

Control Center 提供了易于使用的图形界面来执行导入操作。这个界面中还提供了前一屏中讨论的所有导入选项和文件修饰符。