Click here to view and discuss this page in DocCommentXchange. In the future, you will be sent there automatically.

SQL Anywhere 11.0.1 (中文) » UltraLite - 数据库管理和参考 » UltraLite 数据库参考 » UltraLite 实用程序

 

UltraLite 装载 XML 到数据库实用程序 (ulload)

将 XML 文件的数据装载到一个新的或现有的数据库中。

语法
ulload  -c "connection-string" [ options ] xml-file
选项 说明
-a

将数据和模式定义添加到现有数据库中。

如果要将数据添加到预先存在的、基于记录的 Palm OS 数据库(带 .pdb 扩展名的数据库)中,则不要使用 -p 选项。

-c "connection-string" 必需。连接到 DBF 或 connection-string 的 file_name 参数所标识的数据库。如果未指定用户 ID 和口令,则会假定缺省 UID 为 DBA 且 PWD 为 sql
-d 只装载数据,忽略 XML 文件输入中的任何模式元数据。
-f directory 设置包含文件的目录,该文件带有要装载的附加数据。请参见 ulunload 中的 -f 选项 (UltraLite 卸载旧数据库实用程序 (ulunload))。
-g ID

将初始数据库 ID 设置为所指派的 INTEGER 值。数据库将此值用于所有具有全局自动增量列的新行。数据库将此基值用于与每个附加行和/或列相关联的自动增量 ID。

在部署应用程序时,必须为每个数据库指派不同的标识号,目的是为了与 MobiLink 服务器同步。

-I 在下一次上载同步中包含已插入的行。缺省情况下,此实用程序插入的行不会在同步过程中上载。
-n 只装载模式元数据,忽略 XML 输入文件中的任何数据。

-o [ extended-options ]

指定 UltraLite 数据库创建参数的以分号分隔的列表。请参见为 UltraLite 选择数据库创建参数
-oa 如果过程标识数据库由 UltraLite 的前一版本创建(将导致数据库升级),则将该过程取消。
-ol 列出可用的数据库创建参数,然后退出。请参见为 UltraLite 选择数据库创建参数
-onerror behavior

控制在从 XML 文件中读取数据期间遇到错误时所采取的操作。指定以下受支持的 behavior 值之一:

  • continue   ulload 忽略错误并继续装载 XML。

  • prompt   ulload 会提示您输入信息,以了解是否要继续。

  • quit   ulload 停止装载 XML 并以一个错误终止运行。如果没有指定行为,则此项是缺省行为。

  • exit   ulload 退出。

-or

以只读模式打开数据库。UltraLite 会创建原始文件的副本,然后使用此副本测试脚本而不会变更数据库。完成后会放弃对复制文件的更改。

如果直接从桌面操作系统连接到已部署到 Windows Mobile 设备的数据库,则不支持此选项。

-ou 如果数据库由较旧版本的 UltraLite 创建,则升级数据库。

-p creator-ID

将数据库安装到记录存储库时 Palm OS 所需要的选项。使用 UltraLite 客户端应用程序的指定四字符 creator-ID 创建数据库。如果您正在将数据库部署到 VFS 存储库,则无需使用此选项。

如果要将数据添加到预先存在的、基于记录的 Palm OS 数据库(带有 .pdb 扩展名的数据库),则不要将此选项与 -a 选项一起使用。

-q 将实用程序设置为在安静模式下运行。取消信息性标题、版本号和状态消息。但是,仍然会显示错误消息。
-s file 记录用于将数据库装载到指定的 file 的 SQL 语句。
-t file 指定包含受信任的根证书的文件。服务器验证需要此证书。
-v 打印详细消息。
-y 覆盖数据库文件,无须确认。这只适用于使用 ulload 创建新数据库的情况。
xml-file 指定从其装载数据的 XML 文件的名称。
注释

ulload 实用程序使输入 XML 文件由 ulunload、ulunloadold 或 ulxml 生成(在 UltraLite 版本 8 和版本 9 中)。当与 ulunload 一起使用时,此实用程序可以提供重建数据库的功能。另一种重建数据库的方法是使用 ulunload 生成 SQL 语句,然后使用 DBISQL 将这些语句读入新数据库中。

XML 文件可以包含模式的元数据和/或数据库数据的元数据。-d 忽略模式元数据,只将数据添加到 .udb 文件。-n 忽略数据和元数据,只将模式添加到 .udb 文件。

在命令行中设置选项或指定证书将替换 ulload 处理的 xml-file 的所有设置。

读取 XML 时,ulload 实用程序恢复数据库的所有同步配置文件。

此实用程序会返回错误代码。除 0 之外的任何值均意味着操作失败。

写入桌面操作系统的 Palm 数据库必须以 .pdb 扩展名标识。但是,一旦将数据库部署到设备,扩展名将被删除。有关文件名格式的详细信息,请参见Palm OS

如果目标是 VFS 卷,则不能使用 Palm 安装工具部署 UltraLite 数据库。而是,需要使用读卡器或某些其它工具将数据库直接复制到介质上。

另请参见
示例

创建新的 UltraLite 数据库文件 sample.udb,并用 sample.xml 中的数据装载它:

ulload -c DBF=sample.udb sample.xml

将数据从 sample.xml 装载到现有数据库 sample.udb,如果发生错误,提示进行操作:

ulload -d -c DBF=sample.udb -onerror prompt sample.xml

将 XML 从名为 test_data.xml 的文件装载到 UltraLite 创建的、名为 sample.udb 的数据库的副本中。完成后放弃这些更改。此文件允许您检查 XML 数据中的错误,并更正它们。如果数据成功装载,可以运行不带 -or 选项的命令,以保持 XML 的更新:

ulload -or -c DBF=sample.udb -a test_data.xml