iqunload 实用程序

是针对 SAP IQ 12.7 数据库迁移的命令行实用程序，用于在当前安装的新数据库目录中重新创建旧目录。

iqunload 不会更改 SAP IQ 数据和临时 dbspace。实用程序将保留所有的旧数据库选项，并将其应用于新数据库。 SAP IQ 会忽略不再适用于当前版本软件的所有旧选项。注意如果重装 12.7 数据库，请将标识符中的所有方括号或反引号删除，否则将导致重装失败。

语法

iqunload [ parameters ]   [ @]
:[  |  ]

参数

-ap （可选）设置新目录存储库的页大小。

-au 是迁移模式所必需的。迁移数据库。指定 -au 参数以在迁移模式下启动 iqunload，也可以指定 -n 参数，但不能同时指定这两者。

-c " = , ..." （必需）提供数据库连接参数。必须指定 DBF 参数才能指定要迁移的数据库文件的名称。该文件路径可以是服务器启动目录的绝对路径或相对路径。

-dc （可选）重新计算数据库中的计算列。

-ms_filename 对于 Simplex 迁移是可选的；但对于 Multiplex 迁移是必需的。使用 -ms_filename 为迁移期间创建的新的空 IQ_SYSTEM_MAIN 存储库指定文件名。如果不指定文件名，则缺省的新主存储库是名为 new_main_store.iq 的文件系统文件

-ms_reserve （可选）指定新 IQ_SYSTEM_MAIN 保留空间的大小（以 MB 为单位）。如果未指定，则缺省值为零。

-ms_size （可选）根据数据库大小指定新 IQ_SYSTEM_MAIN 存储的大小（以 MB 为单位）。最小值为 200 MB（假定采用缺省页面大小）。如果指定的 –ms_size 值小于计算出的值，则 SAP IQ 将使用计算出的值；否则使用指定的值。

-n 仅对于模式卸载是必需的。仅卸载模式定义。-n 参数需要 12.7 ESD #5 或更高版本。指定 -au 或 -n 参数，但不要同时指定两者。

-new_startline （可选）为作为迁移目标的新服务器指定启动开关。有关服务器启动开关的完整列表，请参见实用程序指南。

-o （可选）将输出消息记录到。

-q （可选）禁止消息和窗口。

-r （可选）指定文件名。

-t （可选）仅输出列出的表。可以单独指定 OwnerName.TableName 或 TableName。

-ul （可选）卸载口令散列。

-v （可选）返回详细消息。

-y （可选）将现有的重装模式 SQL 脚本替换为新输出而无需确认。

示例

将 simplex 数据库迁移到当前服务器。
```
iqunload –au –c
“UID=DBA;PWD=;DBF=/mydevice/test_dir/test2.db”
```
卸载旧数据库模式并将生成的 SQL 脚本重命名为 test2_reload.sql ：
```
iqunload –n -c “UID=DBA;PWD=;DBF=D:\\test_dir\\test2\\test2.db;
```
```
ENG=myserver_test2” –r “D:\test\unload_dir\test2_reload.sql”
```
迁移数据库 test3.db 。 START 连接参数指定用于启动正在重装的数据库的开关。 -new_startline 参数指定用于启动 utility_db 以创建新目录存储的开关。
```
iqunload –au –c
"UID=DBA;PWD=;DBF=test3.db;
START=–ch 128M –iqmc 50" –new_startline "–ch 256M –iqtc 400"
```
```
iqunload –au -c “
UID=DBA;PWD=;DBF=D:\\test\\test3\\test3.db;
START=–ch 128M –iqmc 50" –new_startline "–ch 256M –iqtc 400"
```
新启动行中不要包含 -iqnotemp ，否则迁移将会失败。作为迁移过程的一部分，会将临时文件添加到 IQ_SYSTEM_TEMP 中。如果使用 -iqnotemp 选项启动服务器，则 iqunload 无法添加这些临时文件使用 IQ_SYSTEM_MAIN 存储的原始设备迁移旧数据库 asiqdemo.db 。
```
iqunload –au –c
"UID=DBA;PWD=;DBF=asiqdemo.db" –ms_filename "/dev/rdsk/c4t0d0s3"
```
```
iqunload –au –c 
"UID=DBA;PWD=;DBF=asiqdemo.db" -ms_filename \\\\.\\PhysicalDrive2
```
用法

iqunload 具有两种工作模式：模式卸载和迁移。

模式卸载模式：

iqunload 需要具备 -n 参数才能以模式卸载模式进行启动。模式卸载模式可卸载 12.7 ESD #5 的数据库模式，并生成可在当前版本软件中重新创建数据库模式的脚本 (reload.sql)。连接参数需要 -c 参数：
```
iqunload -n -c "UID=DBA;PWD=;ENG=my_engine;DBN=my_dbname"
```
模式卸载模式可重新创建模式，但并不会迁移数据。要迁移数据，请提取旧数据并装载新的数据库。

迁移模式：

iqunload 需要具备 -au 参数才能以迁移模式进行启动。 iqunload 迁移模式与 12.7 支持引擎 ( iqunlspt ) 和当前数据库服务器 ( iqsrv16 ) 相连接：

启动旧数据库并生成模式

启动当前 SAP IQ 服务器

创建新数据库并应用旧模式

常规用法

高速缓存内存不足将导致迁移错误。iqunload 使用各种高速缓存（目录高速缓存、主缓冲区高速缓存、临时高速缓存）大小的缺省值。如果旧数据库需要更高的高速缓存值，请将 –ch 和 -cl 选项用作 START 连接参数的一部分以增加高速缓存大小。

数据库迁移期间，服务器会在重装所生成的模式时创建一个消息文件 (*.iqmsg.R)。通常会在成功迁移的清理操作中删除此文件。如果重装阶段中迁移失败，则不进行清除，*.iqmsg.R 将保留在 unload 目录中。*.iqmsg.R 可能包含有助于解决迁移问题的信息。

iqunload 将一些临时文件写入 $IQTMP16（对于 UNIX）或％IQTMP16％（对于 Windows）目录，该目录必须是有效目录名称。

具有宽表（大量的列值/空值）的用户不应为了进行数据库迁移而减小目录存储页大小。

如果旧数据库中包含无效的视图，则 SAP IQ 会完成迁移，但会发出警告。例如，如果视图中所涉及的表已被删除，则可能会发出警告。

如果旧数据库已加密，请使用 DBKEY 连接参数来提供加密密钥。迁移的数据库使用相同的加密密钥。

权限

DBA 权限

iqunload 实用程序

语法

参数

示例

用法

权限