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

ulload  -c "connection-string" [ options ] xml-file

选项	说明
@data	此选项用于从指定的环境变量或配置文件中读入选项。如果存在具有相同名称的环境变量和配置文件，则使用环境变量。请参见配置文件。
-a 或 --append	将数据和模式定义添加到现有数据库中。
-c "connection-string" 或者 --connect="connection-string"	提供数据库连接参数。
-d 或 --dataonly	只装载数据，忽略 XML 文件输入中的任何模式元数据。仅当指定了 -a 时才可以使用 -d 或 --dataonly 开关（因为它仅装载数据，而用于装载数据的 UDB 必须与支持其所装载数据的模式同时存在）。
-e value 或 --fips=value	指定 on 或 off，1 或 0 等等。此选项通过使用 Certicom 认证的加密算法，控制 AES FIPS 认证的加密。请参见数据库安全和UltraLite fips 创建参数。
-E behavior 或 --onerror=behavior	控制在从 XML 文件中读取数据期间遇到错误时所采取的操作。指定以下受支持的 behavior 值之一： continue ulload 忽略错误并继续装载 XML。 prompt ulload 将提示您继续。 quit ulload 停止装载 XML 并以一个错误终止运行。如果没有指定行为，则此项是缺省行为。 exit ulload 退出。
-f directory 或 --filedir=directory	设置包含文件的目录，该文件带有要装载的附加数据。请参见UltraLite 数据库卸载实用程序 (ulunload)。
-g ID 或 --databaseid=ID	将初始数据库 ID 设置为所指派的 INTEGER 值。此初始值与具有全局自动增量列的新行的分区大小一起使用。在部署应用程序时，必须为每个数据库指派不同的标识号范围，目的是为了与 MobiLink 服务器同步。请参见UltraLite global_database_id 选项。
-i 或 --insertforsync	在下一次上载同步中包含已插入的行。缺省情况下，此实用程序插入的行不会在同步过程中上载。
--identity-file=file	指定包含客户端 TLS 标识的文件。请参见identity。
--identity-password = password	为客户端 TLS 标识指定口令。请参见identity_password。
-l filename 或 --log=filename	将操作记录到指定文件中。
-n 或 --schemaonly	只装载模式元数据，忽略 XML 输入文件中的任何数据。
-o value 或 --obfuscate=value	On 或 off，1 或 0 等等。控制是否对数据库中的数据进行模糊处理。模糊处理是一种简单的加密方式. 请参见数据库安全和UltraLite obfuscate 创建参数。
-p page-size 或 --page_size=page-size	定义数据库页面大小。请参见UltraLite page_size 创建参数。
-q 或 --quiet	将实用程序设置为在安静模式下运行。取消信息性标题、版本号和状态消息。但是，仍然会显示错误消息。
-s file 或 --sql=file	记录用于将数据库装载到指定的 file 的 SQL 语句。
-t file 或 --rootcert=file	指定包含受信任的根证书的文件。服务器验证需要此证书。
--utf8_encoding=value	On 或 off，1 或 0 等等。使用 UTF-8 格式（Unicode 的 8 位多字节编码）对数据进行编码。请参见UltraLite 字符集和UltraLite utf8_encoding 创建参数。
-v 或 --verbose	打印详细消息。
-y 或 --overwrite	覆盖数据库文件，无须确认。这只适用于使用 ulload 创建新数据库的情况。
-? 或 --help	显示实用程序用法并退出。

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

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

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

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

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

创建新的 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

创建存储在 sample.udb 数据库的 test_data.xml 中的模式和数据。由于指定了 -a 开关，在运行此命令之前 sample.udb 必须存在。此外，如果任何模式或数据与 sample.udb 中的现有内容相冲突，则意味着 ULLOAD 命令将失败。

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

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

语法

注释

另请参见

示例