db2sampl - 创建样本数据库命令

创建名为 SAMPLE 的样本数据库。

注:Db2® Workgroup Server Edition上, SAMPLE 数据库包含具体化查询表 (MQT) 和导致许可证违例的多维集群表 (MDC)。 只能通过升级到 Db2 Enterprise Server Edition来除去此违例。

首次创建此数据库时,不会自动配置此数据库。 用户可以稍后对 SAMPLE 数据库发出 AUTOCONFIGURE 命令。

权限

需要下列其中一个权限:
  • SYSADM
  • SYSCTRL

必需的连接

命令语法

Read syntax diagramSkip visual syntax diagramdb2sampl-dbpathpath-name-namedatabase-name-encrypt-encroptsoptions-force-verbose-quiet-sql-xml-v8-??help

命令参数

-dbpath path-name
指定要在其上创建数据库的路径。 在 Windows 操作系统上,指定要在其上创建数据库的驱动器的字母。 path-name 的最大长度为 175 个字符。 缺省情况下, path-name 是数据库管理器配置文件 (dftdbpath 参数) 中指定的缺省路径。
-name database-name
指定样本数据库的名称。 数据库名称必须遵循数据库的命名约定。 缺省情况下, database-nameSAMPLE
-encrypt
使用缺省加密选项创建样本数据库。
-encroptsoptions
定制用于加密样本数据库的加密选项。 options 字符串的格式为 Cipher=cipher-name:Mode=mode-name:Key Length=key-length: Master Key Label=label-name,其中:
  • 密码 是可选的。 有效值为 AES。
  • 方式 是可选的。 缺省值为 CBC。
  • 键长度 是可选的。 AES 的有效值为 128,192 和 256 (缺省值为 256)。
  • 主密钥标签 唯一地标识密钥库中由 keystore_location 数据库管理器配置参数的值标识的主密钥。 标签名的最大长度为 255 个字节。 如果未指定主密钥标签,那么数据库管理器会自动生成主密钥标签,然后生成主密钥并将其插入密钥库中。
-force
强制删除和重新创建实例中具有为样本数据库指定的相同名称的任何现有数据库。
-verbose
将状态消息输出到标准输出。
-quiet
禁止将状态消息打印到标准输出。
-sql
创建表,触发器,函数,过程,并使用数据填充表。
-xml
使用数据类型为 XML 的列创建表,对 XML 列创建索引,注册 XML 模式,并使用包括 XML 文档值在内的数据填充这些表。

仅当 XML 受支持时,才支持此选项。 如果不支持 XML ,那么将忽略此选项。

-v8
创建 Db2 Version 8 样本数据库,数据库对象和数据。 版本 8 样本数据库是在数据库管理器配置文件 (dftdbpath 参数) 中指定的缺省路径中创建的名为 SAMPLE 的非 Unicode 数据库。
-? | ? | help
返回 db2sampl 命令语法帮助。
db2sampl 的缺省行为

发出不带任何可选参数的 db2sampl 命令时,根据环境是否已分区,其行为不同:

在非分区数据库环境中:

  • 使用缺省数据库路径中的 Unicode (UTF-8) 代码集创建名为 SAMPLE 的数据库。
  • 创建关系数据库对象,包括表,索引,约束,触发器,函数,过程,多维集群表和具体化查询表。
  • 使用数据填充关系表。
  • 创建具有 XML 数据类型列的表。
  • 创建基于 XML 数据的索引。
  • 创建包含 XML 模式文档的 XML 模式存储库。

在分区数据库环境中:

  • 使用缺省数据库路径中的 Unicode (UTF-8) 代码集创建名为 SAMPLE 的数据库。
  • 创建关系数据库对象,包括表,索引,约束,触发器,函数,过程,多维集群表和具体化查询表。
  • 使用数据填充表。

使用说明

  • 只能在安装了 Db2 数据库服务器的计算机上发出 db2sampl 命令。 无法从远程 IBM® Data Server Client发出此消息。
  • 样本数据库是使用数据库管理器配置参数 authentication指定的实例认证类型创建的。
  • 必须先配置 Db2 本机加密,然后才能创建加密样本数据库。 有关更多信息,请参阅 Db2 本机加密

示例

  • 要创建具有缺省特征的样本数据库,请发出:
    db2sampl
  • 在 Windows 操作系统上,要在仅包含缺省模式中的 SQL 数据库对象的 E: 驱动器上创建名为 mysample 的样本数据库并查看状态消息,请发出:
    db2sampl -dbpath E -name mysample -sql -force -verbose
  • 要创建 Db2 V 8 样本数据库,请发出:
    db2sampl -v8