命令行选项
您可以将以下命令行选项与 Optim™ High Performance Unload 命令时，可以使用以下命令行选项。
- -a | --application
- 使用此选项来设置连接到 Db2®的客户机应用程序的名称。 缺省情况下，与 Db2 连接关联的客户机应用程序名称设置为值 db2hpu。 对于特定任务，可以通过此命令行选项设置另一个值来覆盖此默认值。 Optim High Performance Unload 任务，通过此命令行选项设置另一个值即可。注意: 还可以使用 CLIENT APPLICATION NAME 选项在控制文件中设置客户机应用程序名称。 如果在两个级别都设置了值，那么将考虑命令行中指定的值。
- 语法
-a | --application application_name- 变量
application_name指定一个名称，用作 Optim High Performance Unload 建立的 Db2 连接的客户端应用程序名称。
- 缺省值
- db2hpu
- --binary-numerics
- 使用此选项可卸载二进制格式的数字数据 (整数和实数据)。 使用的二进制表示将始终是大尾数法，即 Db2 Load所期望的大尾数法。 默认情况下， Optim High Performance Unload 不使用二进制格式来表示数字数据。 此选项只能与带有 asc 参数的 -- format 选项结合使用。 如果使用控制文件来运行卸载，那么不能指定 -- binary-numerics 命令行选项。
- 语法
--binary-numerics- 变量
- 无。
- 缺省值
- 无。
- -c | --catn
- 对此选项指定的值标识包含多分区数据库中的目录的数据库分区号。 仅当从备份映像卸载时，才会考虑此参数。 仅当您使用控制文件时，才能从备份映像卸载，因此 -c 选项仅与 -f 选项一起工作，并且仅当您在控制文件的 GLOBAL 块中指定 USING BACKUP CATALOG 子句时。注意: 如果在控制文件中指定 CATN 选项，那么它将覆盖 -- catn 命令行选项。
- 语法
-c | --catn catalog_database_partition_number- 变量
catalog_database_partition_number- 缺省值
- 如果未在控制文件中设置 CATN 选项，那么将采用数据库分区 0。
- --check-consistency
- 此选项可用于验证 Optim High Performance Unload 机器上安装的版本是否与特定执行所需的版本相同。 为了进行验证，最初 Optim High Performance Unload 任务收集了控制文件所引导的所有远程机器上安装的产品版本，然后将其与自身版本进行比较。
假设有一个 Optim High Performance Unload 使用场景涉及10台机器，所有机器都安装了相同版本的 Optim High Performance Unload ，并且想要升级 Optim High Performance Unload 更新到更近的代码版本。 请想象一下，错误的是，此升级将仅在这 10 台机器中的 9 上执行。 此时，如果 Optim High Performance Unload 启动执行此方案，执行报告可能会显示守护程序错误，因为所涉及的 Optim High Performance Unload 代码级别与协议不兼容，无法启动所有相关机器上运行的任务之间的通信 Optim High Performance Unload 所有相关机器上运行的任务。 然后， Optim High Performance Unload 可以通过此命令行选项启动，以识别潜在的版本差异。
仅当 Optim High Performance Unload 所有待考虑的机器上安装的版本具有足够高的代码级别，能够理解它。 否则，使用时观察到的行为将不可预测。
- 语法
--check-consistency- 变量
- 无。
- 缺省值
- 无。
- --credentials
- 使用此选项可在用户级别指定凭证。 凭证信息存储在 db2hpu.creds 配置文件中。 有关更多信息， 请参阅定义用户凭据。
- -d | --database
- 使用此选项来指定包含要卸载的表的数据库。 Optim High Performance Unload 与数据库建立单独连接。
- 语法
-d | --database database_name | database_name:url:port[:ssl]- 变量
database_name- 缺省值
- db2hpu.cfg 中的
db2dbdft
- --data-server-driver
- 使用此选项可使用 IBM Data Server Driver 连接到远程 Db2 数据库。 此工具允许您从其安装所在的客户端机器连接到远程 Db2 数据库。 在这种情况下，甚至不需要在此机器上安装 Db2 客户机以从远程 Db2 数据库卸载数据。
- 语法
--data-server-driver data_server_driver_path- 变量
data_server_driver_path
- --db2
- 使用 --db2 选项来指示是否可以或必须通过 Db2处理给定订单。 如果使用控制文件来运行卸载，那么不能指定 --db2 命令行选项。
NO 表示如果无法直接处理该命令， Optim High Performance Unload （因为SELECT语句的语法过于复杂或不支持），卸载运行将失败。
YES 指示如果 SELECT 语句过于复杂，无法通过卸载直接处理，那么该语句将移交给 Db2 以抽取行。
FORCE 指示将使用 Db2 来抽取所请求的行。 如果您的 SELECT 语句包含 DBCS 单词，而您没有指定 DB2 YES ，则 Optim High Performance Unload 将无法处理该表。- 语法
- --db2 是 | 否 | 强制
- 变量
- 无。
- 缺省值
- 无。
注意: 如果未设置 db2hpu.cfg 文件参数 db2，那么此选项将缺省为 YES。 否则，必须显式设置此控制文件选项以更改在 db2hpu.cfg 文件中为 db2 设置的值。 - --debug
- 使用此选项运行 Optim High Performance Unload 使用调试编译器而非优化编译器编译的可执行文件。 此选项只能在 IBM的指导下使用。
--debug 选项使 Optim High Performance Unload 在调试模式下运行。
根据平台不同， Optim High Performance Unload 仅安装32位可执行文件，或仅安装64位可执行文件。 在所有情况下，它将安装两个二进制文件: 一个普通二进制文件和一个调试二进制文件。 调试版本在编译时启用了编译器调试选项，并包含额外的 Optim High Performance Unload 跟踪调用。指定 --debug 以使调试过程开始。 请参阅本节中的 -- trace 选项，以获取有关在不使用 --debug 选项的情况下运行跟踪的信息。注意: -- trace 可以与 --debug 一起使用，也可以不使用 --debug ，它控制是否执行跟踪。 任一可执行文件都可以生成跟踪，但是，如果同时指定了 --debug ，那么跟踪会更广泛。 调试模块在仅使用--debug选项而不使用--traces选项的情况下可以正常运行，但 Optim High Performance Unload 调试模块在仅使用 --debug选项而不使用 --traces选项的情况下可以正常运行，但 Optim High Performance Unload 不会产生任何跟踪输出。- 语法
--debug- 变量
- 无。
- 缺省值
- 无。
- --format
- 使用此选项来选择要生成的输出格式。 如果使用控制文件来运行卸载，那么不能指定 -- format 命令行选项。
- 语法
--format asc|del|delimited|dsntiaul|ixf|json|orc|parquet|xml- 变量
- 无。
- 缺省值
del
提示: 有关每种输出格式的详细描述，请参阅 FORMAT 控制文件选项描述。 - -f | --file
- 使用此选项指定您想要 Optim High Performance Unload 使用的控制文件名称。
如果使用控制文件，那么需要下列其中一个输入选项。
- 语法
-f | --file { [control_file_name|stdin] }- 变量
[control_file_name|stdin]指定对运行 Db2 的操作系统有效的文件名和路径。 如果希望 Optim High Performance Unload 从标准输入读取控制信息，请指定 stdin 关键字。要点: 要在实际卸载任何数据之前测试控制文件中的语法，请将 -- noexecute 选项与 -- file 选项配合使用。- 缺省值
- 无。
- -h | --help
- 使用此选项可显示 Optim High Performance Unload 帮助。
- 语法
-h | --help- 变量
- 无。
- 缺省值
- 无。
- -i | --instance
- 使用此选项为包含要卸载的表的数据库指定 Db2 实例。 Optim High Performance Unload 与数据库建立单独连接。
- 语法
-i | --instance instance_name- 变量
instance_name请指定有效的 Db2 实例名称。 缺省值是
db2hpu.cfg文件中指定的实例名称。- 缺省值
- db2hpu.cfg 文件中的
db2instance设置 (如果存在)。 如果未设置db2instance，则 Optim High Performance Unload 从环境变量中获取值。 DB2INSTANCE 环境变量。 否则，将返回错误消息，并且卸载将失败。
- --import-credentials
- 使用此选项来指定将凭证从传递给它的文件导入到 db2hpu.creds 配置文件中。 传递给它的文件必须是一个包含通过 --to-file 选项预先创建的有效凭证的文件。
- -k | --kill
- 在 UNIX™ 和 系统上，使用此选项可干净、安全地停止正在运行的 Optim High Performance Unload 在 UNIX™ 和 Linux™ 系统上干净、安全地停止正在运行的进程。限制： 此选项不适用于 Windows™ 系统。
- 语法
-k | --kill process_ID- 变量
process_ID请指定您要停止的 Optim High Performance Unload 您想要停止的任务。
重要信息: 请确保您具有相应的许可权来停止指定的进程。- 缺省值
- 无。
- --list-backups
- 启动时使用此选项启用备份列表模式 Optim High Performance Unload 时启用备份列表模式。
- --load-only
- 使用此选项仅运行与 Optim High Performance Unload 与 Db2 Load部分相关的
- --memory-limit
- 要指定 Optim High Performance Unload 可以使用尽可能多的内存来完成给定的任务，请将 memory_limit 设置为
no。 仅当已将 allow_unlimited_memory 配置文件参数设置为yes时，才能设置 memory_limit 。- 语法
--memory-limit yes | no- 变量
- 无。
- 缺省值
- 是。
- -m | --message
- 使用此选项来指定写入信息，警告和错误消息的目标。
- 语法
-m | --message message_file- 变量
message_file请指定一个文件名，该文件名必须与运行 Optim High Performance Unload 正在运行的操作系统。 如果未指定文件名，那么会将消息发送到标准错误 (stderr)。
如果您指定了现有文件的名称， Optim High Performance Unload 将新消息信息添加到文件末尾。 程序不会覆盖文件中已有的任何信息。
- 缺省值
stderr
- --monitor
- 使用此选项，通过指定要监控的任务的进程ID，监控特定运行 Optim High Performance Unload ，只需指定要监控的任务的进程ID即可。 该进程ID可以从待监控任务的执行报告中确定，因为当启动该任务时，会显示一条信息。
- 语法
- --monitor 进程ID
- 变量
- 进程标识
- 缺省值
- 无。
- -n | --noexecute
- 使用此选项来测试控制文件脚本的语法。 -- noexecute 选项将输出发送到消息文件或标准错误 (stderr) ，而不是标准输出 (stdout)。 如果未指定此选项，那么缺省行为是运行控制文件脚本。注: 没有等同于 -- noexecute 命令行选项的控制文件选项。
- 语法
-n | --noexecute- 变量
- 无。
- 缺省值
- 无。
- -o | --output
- 使用此选项来指定完整输出文件名，包括路径。
Optim High Performance Unload 将所有数据加载到指定的文件中。 缺省情况下，如果缺少此选项，并且控制文件中没有 OUTFILE 子句，那么所有行都将发送到标准输出 (stdout)。
注: 如果使用控制文件选项 -- file，那么该控制文件中的任何输出子句都将覆盖使用此选项指定的内容。- 语法
-o | --output output_file_name- 变量
output_file_name- 缺省值
- 标准输出 (stdout)
- --packed-decimal
- 使用此选项可卸载压缩表示法中的十进制数据。 此选项只能与带有 asc 参数的 -- format 选项结合使用。 以 ASC 格式卸载时，如果未指定此选项，那么将以扩展格式卸载十进制数据。 如果使用控制文件来运行卸载，那么不能指定 -- packed-decimal 命令行选项。
- 语法
--packed-decimal- 变量
- 无。
- 缺省值
- 无。
- --partition
- 使用此选项来指示哪些数据库分区将参与分区数据库环境的卸载。 在单分区环境中将忽略此选项。 在以下信息中， n1 和 n2 表示数据库分区号。需求: 对于非分区 Db2 实例，如果指定了数据库分区号，那么必须使用 PART (ALL) 或 PART (0)。
- 语法
--partition all | current | n1[{-|,} n2...]- 变量
all | current | n1[{-|,} n2...]使用缺省值
all来指示将从为源表定义的所有节点中卸载源表中的数据。 (源表是在命令行或控制文件中指定的表。)输入
current表示源表数据将从启动 Optim High Performance Unload 启动的机器上所有数据库分区中。输入n1[{-|,} n2...]以将卸载的源表数据限制为列出的节点。 此命令行选项将覆盖控制文件中列出的节点。 这些节点必须满足以下条件:- 必须在 db2nodes.cfg 文件中定义数据库分区。
- 数据库分区必须遵循 Db2 节点号语法。
- 必须仅指定一次数据库分区。
- 数据库分区必须位于源表的节点组中。
- 缺省值
all
- -r | --remote
- 当您想运行 Optim High Performance Unload 从远程 Db2 实例中卸载数据，这些数据可以在本地 Db2 客户端上分类，也可以通过 IBM 数据服务器驱动程序进行分类。 未安装在远程数据服务器上， Optim High Performance Unload 未安装在远程数据服务器上，因此 Optim High Performance Unload 即使未明确指定，也将仅使用 DB2 FORCE选项进行远程处理。 如果 DB2 设置为
YES或NO，那么将返回错误。注意: 如果远程 Db2 实例配置了其数据库管理器以在服务器级别进行认证，那么需要使用 -- credentials 命令行选项来创建用户凭证。- 语法
-r | --remote name- 变量
- 如果使用 Db2 客户机，请指定本地编目的远程节点的名称，如果使用 IBM Data Server Driver ，请指定数据源名称。
- 缺省值
- 无。
- --select
- 当您想发出选择请求，而不必将其嵌入到完整请求中时，请使用此选项 Optim High Performance Unload 请求中。 此选项与 -- table 选项不兼容; 但是，如果指定的控制文件仅包含选择请求，那么可以将其与 -- file 选项配合使用。
- 语法
--select- 缺省值
- 无。
- 示例
- 以下示例使用单独的控制文件 file.ctl ，该文件包含选择请求，例如
'select * from employee'。 该命令将执行选择请求并将结果输出到 file.out 文件中:db2hpu -f file.ctl -i db2inst1 -d sample -o file.out --select以下示例使用从 stdin 获取的选择请求。 该命令将从样本数据库的 employee 表中选择所有条目，并将结果输出到 file.out 文件中:
echo 'select * from employee' | db2hpu -f -i db2inst -d sample -o file.out --select
- -s | --standalone
- 从从其他系统获取的备份中抽取数据时，请使用此选项。 您还可以使用该选项以独立方式对从备份获取的数据进行重新分区。 此选项告诉 Optim High Performance Unload 不要在此系统上寻找 Db2 实例文件和目录。 此选项修改 -i 选项的含义。 当指定 -s 时，应该使用生成备份的实例的 Db2 实例所有者标识来指定 -i 。
可选参数使您能够以独立方式从 Db2 V9 压缩备份映像卸载数据。 该参数允许 Optim High Performance Unload 找到 Db2 压缩库，该库用于处理从 Db2 V9 压缩备份镜像中卸载的内容。
- 语法
-s | --standalone db2_installation_path- 变量
- 指定 Db2 安装路径。
- 缺省值
- 无。
- -t | --table
- 使用此选项来指定包含要卸载的数据的表的名称。 需要下列其中一个选项: -f， -t或 -v。 只能从命令行指定一个表名。 如果要在控制文件中提供卸载指示信息，那么必须在控制文件中提供表名。 可以使用该选项卸载 Db2 ™ 汇总表。如果表名为小写，那么不能指定
db2hpu -t "table"，因为双引号 (") 是命令解释器的特殊字符: 相反，必须指定以下命令:
然后将解释双引号字符，并且将接受小写形式的表名。db2hpu -t \"table\"- 语法
-t | --table [[SYSTEM.]owner.] table_name- 变量
owner and table_name如果您不是 Db2 表的所有者，请指定
owner的值，后跟要卸载的表的名称。 Optim High Performance Unload 将名称转换为大写，除非名称被双引号括起来，例如："table_name"。- 缺省值
- 无。
- --tenant
- 使用此选项指定一个租户，以便从本地数据库中卸载数据时考虑该租户。
- --to-file
- 使用此选项来指定将凭证创建到传递给它的文件中，而不是将它们创建到 db2hpu.creds 配置文件中。
- --traces
- 当 IBM 要求您激活 Optim High Performance Unload 服务跟踪。 此选项只能在 IBM的指导下使用。当您开始跟踪时， Optim High Performance Unload 将跟踪文件保存在您启动 db2hpu 命令的目录中，并为每个处理过的关键词提供一个文件。 文件名为 KEYWORD_nnnnn ，其中 KEYWORD 是跟踪关键字， nnnnn 是运行的卸载的进程标识。 例如：
将要求您对这些文件进行 tar 操作，并将其发送给 IBM 软件支持人员。$ARGS_456789将为所有应用的跟踪关键字创建跟踪文件。 关键词包含在安装过程中创建的 db2hpu.trace 文件中， Optim High Performance Unload 在安装过程中创建。 跟踪使用
db2hpum文件 (以优化方式编译的卸载可执行文件) 运行。跟踪选项还可以与 --debug 选项一起使用。 如果 -trace 选项与 --debug 选项一起使用，那么使用的关键字将是 db2hpu.debug 文件中指定的关键字。 此文件包含更多跟踪关键字。 此外，指定 --debug 时，跟踪将使用
db2hpum_debug文件运行，该文件是在调试方式下编译的卸载可执行文件。- 语法
--traces- 变量
- 无。
- 缺省值
- 无。
- --umask
- 执行自动数据迁移时，请使用 -- umask 选项来覆盖目标系统许可权。 缺省情况下，远程卸载的 umask 值是 xinetd (或 inetd) 守护程序入门模板的 umask 值。 然后，根 umask 会限制所生成文件的许可权。 执行自动数据迁移时，此限制可能有问题，因为 Db2 Load 需要数据文件可供目标数据库的实例用户读取。 在某些情况下 (取决于系统配置) ，应用的 umask 限制过多，并且生成的文件对于目标数据库实例用户不可见。 umask功能允许您覆盖此限制性umask，并生成具有适当权限的文件。 Optim High Performance Unload umask功能允许您覆盖此限制性umask，并生成具有适当权限的文件。
- -v | --version
- db2hpu 如果您不确定正在运行哪个版本的 Optim High Performance Unload。 --version选项显示 Optim High Performance Unload 当前运行的版本、发行版本和修改编号，格式如下：
修改号 (vv.rr.mmm.iimmm) 是最近应用的修订包的编号，ii是临时修订号。- 语法
-v | --version- 变量
- 无。
- 缺省值
- 无。
- --warehouse
- 当需要 Optim High Performance Unload 远程 Db2 Warehouse 数据库作为数据源。 此选项仅与 DB2 FORCE 选项兼容，因为针对此类 Db2 Warehouse 数据库的关联 SQL 语句只能通过 Db2 SQL 引擎以其他方式执行。 如果未显式指定 DB2 选项，那么当使用此命令行选项时，其缺省值将变为 FORCE。 如果 DB2 选项设置为 YES 或 NO ，那么将返回错误。
- 语法
--warehouse别名- 变量
alias- 缺省值
- 无。