UltraLite Java 版数据库装载实用程序 (uljload)

提供从 XML 源文件装载 UltraLite Java 版本数据库的功能。XML 文件通常由 uljunload 实用程序产生，并且可以自定义。

注释

数据库配置参数不能在命令行中进行设置。在创建新的数据库时，uljload 实用程序将使用缺省配置。要使用不同的配置参数（如不同的页大小）来创建数据库，必须先使用 Java 创建此数据库，然后使用 uljload -a 将 XML 内容装载到所创建的数据库中。

语法

uljload -c filename -p password [ options ] inputfile

选项	说明
-a	将来自 XML 文件的信息添加到现有数据库。如果未指定此选项，则创建新数据库。
-c filename	必填。指定数据库文件的名称。
-d	仅装载数据；忽略模式信息。
-ek key	指定用于访问加密 UltraLite Java 版数据库所需的加密密钥。
-f directory	指定用于检索列数据的目录，其中列数据大于 uljunload 操作的 -b 选项所指定的最大 BLOB 大小。
-i	插入用于上载同步的行。
-n	仅装载模式信息；忽略行数据。
-p password	可选。指定口令。缺省口令为 sql。
-q	以安静模式运行实用程序—不显示消息。
-v	显示详细消息。
-y	如果输出文件存在（且未指定 -a 选项），则将其覆盖。
-z pagesize	指定用于创建数据库的页面大小（以字节为单位）。
-?	显示命令行用法信息。
inputfile	指定包含 XML 语句的输入文件。

装载 blobfile 类型的示例

此示例假设您已将以下 SQL 语句用于 UltraLite Java 版数据库，并使用 UltraLite Java 版数据库卸载实用程序卸载了该文件。

CREATE TABLE blobfile_example
    file_name CHAR(size) DEFAULT AUTOFILENAME( prefix, extension ),
    file_contents LONG BINARY STORE AS FILE( file_name ) CASCADE DELETE

在遇到 uljunload 实用程序导出的文件时，ulload 实用程序会将 file_name 列视为 CHAR 列，将 file_contents 列视为 LONG BINARY 列。

在遇到相同 XML 文件时，uljload 实用程序会重新构建 blobfile 类型。file_name 列存储字符串 <base_dir>/<reference_to_external_file>，其中，<base_dir> 就是 -f 选项中的字符串，而 <reference_to_external_file> 就是位于 XML 文件的 file_contents 列中的字符串。新构建的数据库即会包含对外部文件的有效引用。

如果生成的文件名过长，装载将失败，并显示错误消息，提示用户增加 file_name 列的大小。

另请参见

示例

-? 选项将显示命令行信息。

uljload -?

uljload 实用程序命令行包括 -? 选项时，会显示以下用法信息：

SQL Anywhere UltraLiteJ 数据库装载实用程序
用法:uljload [options] <XML file>
从 <XML file> 创建数据，并装载到新 UltraLiteJ 数据库中。

选项：
-a      添加至现有数据库。
-c <file> 数据库文件。
-d      仅数据 -- 忽略模式。
-ek <key> 加密密钥。
-f <directory>
用于装载 .File 路径的目录。
-i      插入用于上载同步的行。
-n      仅模式 -- 忽略数据。
-p      连接到数据库的口令。
-q      安静模式：不输出消息。
-v      详细消息。
-y      如果文件已存在，则将其覆盖。
-z <page size>
创建数据库时使用的页面大小。

使用DocCommentXchange讨论此页。