升级实用程序 (dbupgrad)

注意

无法使用升级实用程序 (dbupgrad) 将 SQL Anywhere 9.0.2 和较早版本的数据库升级到 SQL Anywhere 16。要将 SQL Anywhere 9.0.2 和较早版本的数据库升级到 SQL Anywhere 16，必须通过执行卸载和重装来重建数据库。请参见SQL Anywhere 服务器升级。

更新系统表和视图、添加新的数据库选项、重新创建所有系统存储过程、安装 jConnect 支持、更改数据库中的 Java 支持、归档事务日志、创建新的事务日志。此实用程序还可停止数据库，然后将其重新启动。

语法

dbupgrad [ options ]

选项

说明

@data

读取来自指定的环境变量或配置文件的选项。

要保护口令或配置文件中的其它信息，可以使用文件隐藏实用程序对配置文件的内容进行模糊处理。

-c "keyword=value; ..."

指定连接参数。

例如，以下命令会升级称为 sample16 的数据库但不安装 jConnect 支持，它以用户 DBA 和口令 sql 进行连接：

dbupgrad -c "UID=DBA;PWD=sql;DBF=c:\sa16\sample16.db" -i

-i

排除 jConnect 元数据支持。要使用 jConnect JDBC 驱动程序访问系统目录信息，不要使用此选项。指定此选项后，只要不访问系统目录信息，您就仍然可以使用 jConnect。以后，可以使用 Sybase Central 或 ALTER DATABASE UPGRADE 语句添加 jConnect 元数据支持。

-nrs

升级后停止但不重新启动数据库。如果未指定此选项，则除非 AutoStop 连接参数设置为 Yes，数据库将在升级后重新启动。

-o filename

将输出消息写入指定文件中。

-pd [ Y | N ]

指定用于执行特许操作的 16.0 之前版本的系统过程将以定义者（所有者）特权还是调用者特权来执行。有关这些过程的列表，请参见以调用者或定义者身份运行 16.0 之前版本的系统过程。

如果指定 -pd N，则系统过程将以调用者（执行系统过程的用户）特权执行。

如果指定 -pd Y，则系统过程将以定义者（拥有系统过程的用户或角色）特权执行。

如果未指定任何内容，则保留正在升级的数据库的当前设置。升级 16.0 之前版本的数据库时，这便意味着以定义者特权执行这些系统过程。

此设置不影响版本 16 或更高版本中的新增系统过程，也不影响用户定义过程的缺省行为（即仍具有定义者特权）。

-q

以安静模式运行—不显示消息和窗口。

特权

注释

小心

升级前备份数据库文件。

dbupgrad 实用程序可以升级使用早期版本软件创建的数据库，以便充分利用新版本的各项功能。其可以升级的最新版本是 SQL Anywhere 10.0.0。尽管较新版本的数据库服务器可以针对早期版本所创建的数据库运行，但如果不将数据库升级，在其创建后软件中所引入的某些功能就无法使用。

如果使用升级实用程序升级一个当前正在镜像的数据库，将会返回一条错误消息。

注意

升级数据库后刷新数据库中的实例化视图。

注意

dbupgrad 并不能使需要对数据库文件进行物理重组的功能在升级后变得可用。这些功能包括索引增强和数据存储方面的改进。要想利用这些功能增强带来的好处，您必须卸载并重装数据库。

当针对 SQL Anywhere 的新版本和软件更新发布时，您可以通过升级实用程序来享用这些新的功能。

升级数据库不需要卸载再重装这些数据库。

升级期间将事务日志归档。升级后，在启动数据库时将创建新的事务日志。

退出代码是零（成功）或非零（失败）。

另请参见

使用DocCommentXchange讨论此页。