EXPORT 命令

权限

需要的连接

数据库。 如果启用了隐式连接，那么将建立与缺省数据库的连接。 从 Linux， UNIX 或 Windows 客户机对 Linux®， UNIX 或 Windows 数据库服务器的实用程序访问必须是通过引擎的直接连接。 访问权不得是通过 Db2 Connect 网关或回送环境的直接连接。

命令语法

traversal-order-list

命令参数

TO filename

指定要将数据导出到的文件的名称。 如果未指定文件的完整路径，那么导出实用程序将使用当前目录和缺省驱动器作为目标。

如果指定了现有文件的名称，那么导出实用程序将覆盖该文件的内容; 它不会附加该信息。

如果启用了 DB2_LOAD_RESTRICTED_IO_PATH ，那么该文件必须存在于受限路径中。

OF filetype

指定输出文件中数据的格式:

• DEL (定界 ASCII 格式) ，由各种 数据库管理器 和文件管理器程序使用。
• IXF (集成交换格式， PC 版本) 是专有二进制格式。

LOBS TO lob-path

指定要在其中存储 LOB 文件的目录的一条或多条路径。 每个 LOB 路径必须至少有一个文件，并且每个文件必须至少包含一个 LOB。 可以指定的最大路径数为 999。 此设置隐式激活 LOBSINFILE 行为。

如果启用了 DB2_LOAD_RESTRICTED_IO_PATH ，那么 lob-path 必须存在于受限路径中。

LOBFILE filename

为 LOB 文件指定一个或多个基本文件名。 当为第一个名称耗尽名称空间时，将使用第二个名称，依此类推。 此设置隐式激活 LOBSINFILE 行为。

在导出操作期间创建 LOB 文件时，将通过将当前基本名称从此列表追加到当前路径 (从 lob-path) 来构造文件名。 然后，必须附加要启动的三位数序号以及三个字符标识 lob。 例如，如果当前 LOB 路径是目录 /u/foo/lob/path/，而当前 LOB 文件名是 bar，那么创建的 LOB 文件是 /u/foo/lob/path/bar.001.lob， /u/foo/lob/path/bar.002.lob等。 使用 999 时， LOB 文件名中的三位数序号增大到四位数，使用 9999 时，四位数增大到五位数，依此类推。

XML TO xml-path

指定要在其中存储 XML 文件的目录的一个或多个路径。 每个 XML 路径至少有一个文件，每个文件至少包含一个 XQuery 数据模型 (XDM) 实例。 如果指定了多条路径，那么 XDM 实例将在路径之间均匀分布。

如果启用了 DB2_LOAD_RESTRICTED_IO_PATH ，那么 XML 路径必须存在于受限路径中。

XMLFILE filename

为 XML 文件指定一个或多个基本文件名。 当为第一个名称耗尽名称空间时，将使用第二个名称，依此类推。

在导出操作期间创建 XML 文件时，通过将当前基本名称从此列表追加到当前路径 (从 xml-path) 来构造文件名。 然后，必须附加一个三位数的序号以及三个字符的标识 xml。 例如，如果当前 XML 路径是目录 /u/foo/xml/path/，而当前 XML 文件名是 bar，那么创建的 XML 文件是 /u/foo/xml/path/bar.001.xml， /u/foo/xml/path/bar.002.xml等。

MODIFIED BY filetype-mod

指定文件类型修饰符选项。 请参阅 导出实用程序的文件类型修饰符。

XMLSAVESCHEMA

指定必须为所有 XML 列保存 XML 模式信息。 对于插入时针对 XML 模式验证的每个导出的 XML 文档，该模式的标准 SQL 标识存储为 SCH 属性。 此属性存储在相应的 XML 数据说明符 (XDS) 中。 如果未针对 XML 模式验证导出的文档，或者模式对象不再存在于数据库中，那么在相应的 XDS 中不包含 SCH 属性。

SQL 标识的模式和名称部分存储为 SYSCAT.XSROBJECTS 目录表对应于 XML 模式。

XMLSAVESCHEMA 选项与未生成格式正确的 XML 文档的 XQuery 序列不兼容。

METHOD N column-name

指定要在输出文件中使用的一个或多个列名。 如果未指定此参数，那么将使用表中的列名。 此参数仅对 IXF 文件有效，但在导出分层数据时无效。

MESSAGES message-file

指定导出操作期间发生的警告和错误消息的目标。 如果该文件存在，那么导出实用程序将追加该信息。 如果省略 message-file ，那么会将消息写入标准输出。

select-statement

指定返回要导出的数据的 SELECT 或 XQUERY 语句。 如果该语句导致错误，那么会将消息写入消息文件 (或标准输出)。 如果错误代码为 SQL0012W， SQL0347W， SQL0360W， SQL0437W或 SQL1824W之一，那么导出操作将继续执行; 否则将停止。

如果 SELECT 语句的格式为 SELECT * FROM tablename ，并且表包含隐式隐藏列，那么必须显式指定是否在导出操作中包含隐藏列的数据。 使用下列其中一种方法来指示是否包含隐藏列的数据：

• 使用其中一个隐藏列文件类型修饰符: 当导出包含隐藏列的数据时指定 implicitlyhiddeninclude ，否则指定 implicitlyhiddenmissing 。

  db2 export to t.del of del modified by implicitlyhiddeninclude
     select * from t

• 当数据移动实用程序迂到具有隐式隐藏列的表时，请在客户机端使用 DB2_DMU_DEFAULT 注册表变量来设置缺省行为。

  db2set DB2_DMU_DEFAULT=IMPLICITLYHIDDENINCLUDE
  db2 export to t.del of del select * from t 

HIERARCHY STARTING sub-table-name

使用缺省遍历顺序 (针对 ASC 或 DEL 文件的 OUTER 顺序，或存储在 PC/IXF 数据文件中的顺序) ，从 sub-table-name开始导出子层次结构。

HIERARCHY traversal-order-list

使用指定的遍历顺序导出子层次结构。 所有子表都必须以 PRE-ORDER 方式列出。 第一个子表名用作 SELECT 语句的目标表名。

示例

db2 export to myfile.ixf of ixf messages msgs.txt select * from staff

db2 export to awards.ixf of ixf messages msgs.txt select * from staff
      where dept = 20

   db2 export to myfile.del of del lobs to mylobs/
      lobfile lobs1, lobs2 modified by lobsinfile
      select * from emp_photo

   db2 export to myfile.del of del
      lobs to /db2exp1/, /db2exp2/ modified by lobsinfile
      select * from emp_photo

   db2 export to myfile.del of del
      modified by chardel'' coldel; decpt,
      select * from staff

使用说明

• 在启动导出操作之前，请确保完成所有表操作并释放所有锁定。 可以通过在关闭所有 WITH HOLD 打开的游标之后发出 COMMIT 来完成此步骤，也可以通过发出 ROLLBACK 来完成此步骤。
• 可以在 SELECT 语句中使用表别名。
• 当 SQL27981W 消息似乎不适用时 (例如，未对 EXPORT 表进行分区时) ，可能会迂到该消息。 在这种情况下，您可以安全地忽略此警告。 如果 EXPORT 命令的 SELECT 语句包含单词 ' 从 ' 在 SQL 关键字 FROM 之前。
• 放入消息文件中的消息包括从消息检索服务返回的信息。 每条消息都以新行开头。
• 必须使用 PC/IXF 导入在数据库之间移动数据。 如果将包含行分隔符的字符数据导出到定界 ASCII (DEL) 文件并由文本传输程序处理，那么包含行分隔符的字段将缩小或展开。
• 如果可以从同一客户机访问源数据库和目标数据库，那么不需要执行文件复制步骤。
• Db2 Connect 可用于从 DRDA 服务器 (例如 Db2® for z/OS®， Db2 for VM and VSE 以及 Db2 for OS/400®) 导出表。 仅支持 PC/IXF 导出。
• 导出到 IXF 格式时，如果标识超过 IXF 格式支持的最大大小，那么导出将成功。 但是，后续导入操作无法使用 CREATE 方式 (SQL27984W) 来使用生成的数据文件。
• 导出为 IXF 格式时，导出实用程序不会维护 按列组织 表元数据，在后续导入操作期间，使用 CREATE 方式重新创建 按列组织 表时需要这些元数据。
• 当您在 Windows 上导出到软盘，并且该表具有比单个软盘的容量更多的数据时，系统会提示输入另一个软盘。 生成多部分 PC/IXF 文件 (也称为多卷 PC/IXF 文件或逻辑分割的 PC/IXF 文件) 并将其存储在单独的软盘中。 在每个文件中，除最后一个文件外，将写入 Db2 延续记录 (简称 "AC" 记录)。 此记录指示文件在逻辑上已分割，并显示下一个文件的查找位置。 然后，可以将这些文件传输到 AIX® 系统以由导入和装入实用程序读取。 当从 AIX 系统启动时，导出实用程序不会创建多部分 PC/IXF 文件。 有关详细用法，请参阅 IMPORT 命令或 LOAD 命令。
• 如果提供的 SELECT 语句的格式为 SELECT * FROM tablename，那么导出实用程序会将该表的 NOT NULL WITH DEFAULT 属性存储在 IXF 文件中。
• 导出类型表时，只能通过指定目标表名和 WHERE 子句来表示子 SELECT 语句。 导出层次结构时，不能指定全查询和 select-statement 。
• 对于 IXF 以外的文件格式，请指定遍历顺序列表。 此列表告诉 Db2 如何遍历层次结构以及要导出的子表。 如果未指定此列表，那么将导出层次结构中的所有表，并且缺省顺序为 OUTER 顺序。 替代方法是使用缺省顺序，即 OUTER 函数给出的顺序。
• 在导入操作期间使用相同的遍历顺序。 LOAD 实用程序不支持装入层次结构或子层次结构。
• 从包含受保护行的表中导出数据时，会话授权标识持有的 LBAC 凭证可能会限制导出的行。 如果会话授权标识对这些行没有只读访问权，那么不会导出这些行。 未提供任何错误或警告。
• 会话授权标识持有的 LBAC 凭证必须允许从导出中包含的一个或多个受保护列进行读取。 如果这些凭证不允许从这些受保护的列中读取，那么导出将失败并返回 SQLSTATE 42512 错误。
• 当您运行数据移动实用程序 (例如 export 和 db2move) 时，查询编译器可能会确定底层查询对 MQT 运行的效率高于基本表。 在这种情况下，针对刷新延迟 MQT 运行查询，实用程序的结果可能无法准确表示底层表中的数据。
• 导出包使用 DATETIME ISO 格式进行绑定。 因此，在强制转换为字符串表示时，所有日期/时间/时间戳记值都将转换为 ISO 格式。 由于 CLP 包是使用 DATETIME LOC 格式 (特定于语言环境的格式) 进行绑定的，因此如果 CLP DATETIME 格式与 ISO 不同，那么您可能会看到 CLP 与 export 之间的行为不一致。 例如，以下 SELECT 语句可能返回预期结果:

     db2 select col2 from tab1 where char(col2)='05/10/2005';
        COL2
        ----------
        05/10/2005
        05/10/2005
        05/10/2005
        3 record(s) selected.

  但是，使用相同 select 子句的导出命令将不会:

     db2 export to test.del of del select col2 from test 
     where char(col2)='05/10/2005';
        Number of rows exported: 0

  现在，将 LOCALE 日期格式替换为 ISO 格式会产生预期的结果:

     db2 export to test.del of del select col2 from test
     where char(col2)='2005-05-10';
        Number of rows exported: 3

导出实用程序的文件类型修饰符

   modified by chardel""

   modified by chardel''

   db2 "export to temp of del modified by coldel;
      select * from staff where dept = 20"

   db2 create table decimalTable ( c1 decimal( 31, 2 ) )
   db2 insert into decimalTable values ( 1.1 )
   
   db2 export to data of del select * from decimalTable
    
   db2 export to data of del modified by STRIPLZEROS 
      select * from decimalTable

   "YYYY/MM/DD HH:MM:SS.UUUUUU"

   db2 export to delfile2 of del
      modified by timestampformat="yyyy.mm.dd hh:mm tt"
      select * from schedule