DM达梦数据库dminit使用手册

功能简介（dminit是什么？）

dminit 是 DM 数据库初始化工具。在安装 DM 的过程中，用户可以选择是否创建初始数据库。如果当时没有创建，那么在安装完成之后，可以利用创建数据库工具 dminit 来创建。

使用 dminit

dminit工具需要从命令行启动。找到 dminit 所在安装目录 /bin，输入 ./dminit 和参数后回车。参数在后面内容详细介绍。

语法如右：./dminit KEYWORD=value { KEYWORD=value }

KEYWORD：dminit 参数关键字。多个参数之间排列顺序无影响，参数之间使用空格间隔。

value：参数取值。

注意

dminit如果没有带参数，系统会引导用户进行设置。

参数、等号和值之间不能有空格，例如PAGE_SIZE=16。

HELP参数的后面不用添加“=”号。

例如，初始化一个数据库，放在 /home/test/dmdbms 目录下，数据页 PAGE_SIZE 大小为 16 K。

./dminit PATH=/home/test/dmdbms PAGE_SIZE=16

如果创建成功，则屏幕显示如下：

initdb V8

db version: 0x7000a

create dm database success. 2020-07-08 13:28:23
 

此时在 /home/test/dmdbms 目录下会出现一个 DAMENG 文件夹，内容包含初始数据库 DAMENG 的相关文件和 DM 数据库启动所必须的配置文件 dm.ini。

查看 dminit 参数

dminit 使用较为灵活，参数较多，下面会一一介绍，用户也可使用“dminit HELP”在自己的系统上快速查看各参数。

1 INI_FILE

初始化文件 dm.ini 存放的路径，指定一个已经存在的 dm.ini 文件所在的绝对路径。作用是将现有 INI 文件，拷贝到新库，作为新库的 INI 文件直接使用。文件路径长度最大为 256 个字符。可选参数。

如果不指定该参数，那么 dminit 工具会直接生成一个新的dm.ini文件。如果指定了该参数但指定的INI文件不存在，那么 dminit 工具会报错无效的 INI 文件，同时生成一个新的 dm.ini 文件。

2 PATH

初始数据库存放的路径。默认路径为 dminit.exe 当前所在的工作目录。文件路径长度最大为 256 个字符。可选参数。

3 CTL_PATH

初始数据库控制文件的路径，默认值Windows下为PATH\DB_NAME\dm.ctl，Linux下为/PATH/DM_NAME/dm.ctl（PATH和DB_NAME表示各自设置的值）。文件路径长度最大为256个字符。可选参数。

4 LOG_PATH

初始数据库日志文件的路径。默认值 Windows 下为 PATH\DB_NAME\DB_NAME01.log 和 PATH\DB_NAME\DB_NAME02.log，Linux 下为 PATH/DB_NAME/DB_NAME01.log 和 PATH/DB_NAME/DB_NAME02.log（PATH 和 DB_NAME 表示各自设置的值）。文件路径长度最大为 256 个字符。日志文件路径个数不能超过 10 个。可选参数。

修改日志文件大小可以使用 LOG_SIZE 参数。

5 EXTENT_SIZE

数据文件使用的簇大小，即每次分配新的段空间时连续的页数。取值：16、32、64。单位：页数。缺省值 16。可选参数。

6 PAGE_SIZE

数据文件使用的页大小。取值：4、8、16、32，单位：K。默认值为 8。可选参数。

选择的页大小越大，则DM支持的元组长度也越大，但同时空间利用率可能下降。

7 LOG_SIZE

重做日志文件大小。取值：64~2048 之间的整数，单位 M。默认值为 256。可选参数。

每个DM数据库实例至少有两个重做日志文件，循环使用，LOG_SIZE 设置每个重做日志文件的大小。

修改日志文件路径可以使用 LOG_PATH 参数。

8 CASE_SENSITIVE

标识符大小写敏感。当大小写敏感时，小写的标识符应用””括起，否则被系统自动转换为大写；当大小写不敏感时，系统不会转换标识符的大小写，在标识符比较时也不能区分大小写。取值：Y、y、1表示敏感；N、n、0表示不敏感。默认值为Y。可选参数。

9 CHARSET/UNICODE_FLAG

字符集选项。取值：0 代表 GB18030，1 代表 UTF-8，2 代表韩文字符集 EUC-KR。默认为 0。可选参数。

与此同时，CASE_SENSITIVE 为 N/n/0 和 CHARSET/UNICODE_FLAG 为 0 不能同时出现。

10 SEC_PRIV_MODE

权限管理模式。取值 0、1 和 2。0：TRADITION，表示传统模式；1：BMJ，表示专用机模式；2：EVAL，表示 EVAL 测评模式。默认为 0。可选参数。

11 LENGTH_IN_CHAR

VARCHAR 类型对象的长度是否以字符为单位。取值：1、Y 表示是，0、N 表示否。默认值为 0。可选参数。

1 或 Y：是，所有 VARCHAR 类型对象的长度以字符为单位。这种情况下，定义长度并非真正按照字符长度调整，而是将存储长度值按照理论字符长度进行放大。所以会出现实际可插入字符数超过定义长度的情况，这种情况也是允许的。同时，存储的字节长度 8188 上限仍然不变，也就是说，即使定义列长度为 8188 字符，其实际能插入的字符串占用总字节长度仍然不能超过8188；

0 或 N：否，所有 VARCHAR 类型对象的长度以字节为单位。

12 SYSDBA_PWD

初始化时设置 SYSDBA 的密码，默认为 SYSDBA。密码长度为 9~48 个字符。可选参数。

13 SYSAUDITOR_PWD

初始化时设置 SYSAUDITOR 的密码，默认为 SYSAUDITOR。密码长度为 9~48 个字符。可选参数。

14 DB_NAME

初始化数据库名称，默认为 DAMENG。名称为字符串，长度不能超过 128 个字符。可选参数。WINDOWS 下文件名不能包含字符/ \ * : ? < > “ | ，LINUX下文件名不能包含字符/\ : < > “ |。

15 INSTANCE_NAME

初始化数据库实例名称，默认为 DMSERVER。名称为字符串，长度不能超过 128 个字符。可选参数。

16 PORT_NUM

初始化时设置 dm.ini 中的监听端口号，默认 5236。服务器配置此参数，有效值范围（102465534），发起连接端的端口在 102465535 之间随机分配。可选参数。

17 BUFFER

系统缓存大小，以M为单位。推荐值：系统缓冲区大小为可用物理内存的60%～80%。有效值范围（8~1048576），缺省值为100。可选参数。

18 TIME_ZONE

初始化时区，默认为东八区(+08:00)。格式为[正负号]小时[：分钟]，其中，正负号和分钟为可选项。时区设置范围为：-12:59~+14:00。可选参数。

19 PAGE_CHECK

是否启用页面内容校验模式。取值为：0：不启用；1：简单校验；2：严格校验(使用 CRC16 算法生成校验码)。默认0。可选参数。

PAGE_CHECK 主要用来和数据库镜像一起使用。当 PAGE_CHECK 为 1 或 2 时，表示开启镜像系统，默认值 0 不开启。开启镜像后，用户还需要对指定的数据文件或回滚文件创建对应的镜像文件，涉及到的建库参数有 system_mirror_path、main_mirror_path和roll_mirror_path，下文会详细介绍。

镜像系统的运行流程：当系统需要把数据写入数据文件（或回滚文件）时，在写入以后如果数据文件（或回滚文件）创建了镜像文件，则需要把数据内容同时写入到镜像文件中。当系统需要从数据文件（或回滚文件）中读取数据时，如果数据文件（或回滚文件）中的校验信息与通过页内容生成的校验信息不一致则认为数据页已经损坏，那么系统会自动读取镜像文件中的数据继续提供服务。

20 EXTERNAL_CIPHER_NAME、EXTERNAL_HASH_NAME、EXTERNAL_CRYPTO_NAME

第三方加密时使用。缺省情况下，使用 DM 内部默认算法。

EXTERNAL_CIPHER_NAME：设置默认加密算法。备份、还原、建表等凡是用到加密算法，但是加密算法缺省的情况下，如果用户指定了第三方加密，则用此算法。密码为字符串，不能超过 32 个字符。可选参数。

EXTERNAL_HASH_NAME：设置默认 HASH 算法。用来生成加密数据的校验码。算法为字符串，不能超过 64 个字符。可选参数。

EXTERNAL_CRYPTO_NAME：设置服务器根密钥加密引擎。加密引擎提供 EXTERNAL_CIPHER_NAME 和 EXTERNAL_HASH_NAME 算法的动态库。加密引擎的使用，详细请参考《DM8 安全管理》一书加密引擎章节。密钥为字符串，不能超过 256 个字符。可选参数。

21 USBKEY_PIN

USBKEY PIN 是登录第三方设备 UKEY 的密码。供使用 UKEY 的用户使用。UKEY用于服务器端存储加密根密钥的证书，缺省使用磁盘物理文件 dm_service.prikey 存储根密钥密钥的密文。

在 DM 的加密机制中，增加移动 UKEY 的使用，更能确保 SVR_KEY 的安全性，数据安全性也得到进一步提升。

USBKEY PIN 为字符串，不能超过 48 个字节。可选参数。

22 PAGE_ENC_SLICE_SIZE

使用数据页按扇区大小进行分片加解密时，指定数据页加解密的分片大小。可配置大小为 0、512 或 4096，单位为 byte，默认值为 4096。其中，0 表示不按分片进行加解密。可选参数。

当使用数据页分片加密即 PAGE_ENC_SLICE_SIZE 非 0 时，需要注意指定的加密算法是否支持数据页分片加密。DM 支持的加密算法中，没有“NOPAD”后缀的 ECB/CBC 加密算法不支持数据页分片加密。

23 ENCRYPT_NAME

指定全库加密算法，加密密钥由 DM 自动生成。不指定时，不进行全库加密。

全库加密操作流程：第一步，在创建数据库的过程中，通过参数 ENCRYPT_NAME 的设置，使用DM内部支持的加密算法或是第三方的加密算法对数据库文件进行加解密。第二步，在服务器启动及运行的过程中，需要对处理的所有数据页通过指定的加密算法和 DM 自动生成的密钥进行加解密处理，即如果数据页读入缓存，需要进行解密后才能使用，在缓存中的数据页进行刷盘时，需要对数据页进行加密后存储到数据文件中。

ENCRYPT_NAME：全库加密使用的算法名。算法可以是DM内部支持的加密算法，或者是第三方的加密算法，其中DM支持的加密算法可通过查询动态视图 V$CIPHERS 得到，相关介绍可参见《DM8 安全管理》7.1.1 节。算法名为字符串，不能超过 128 个字节。可选参数。

24 RLOG_ENC_FLAG

设置联机日志文件和归档日志文件是否加密。取值 Y/N，y/n，1/0，默认N。可选参数。

如果使用第三方加密，则默认值算法为 external_cipher_name。否则使用 AES256_CFB。

25 BLANK_PAD_MODE

设置字符串比较时，结尾空格填充模式是否兼容 ORACLE。取值：1 兼容；0 不兼容。默认为 0。可选参数。

26 SYSTEM_MIRROR_PATH

指定 system.dbf 文件的镜像绝对路径。默认为空。可选参数。

当 PAGE_CHECK 为 1 或 2 时，才需要指定。

27 MAIN_MIRROR_PATH

指定 main.dbf 文件的镜像绝对路径。默认为空。可选参数。

当 PAGE_CHECK 为 1 或 2 时，才需要指定。

28 ROLL_MIRROR_PATH

指定 roll.dbf 文件的镜像绝对路径。默认为空。可选参数。

当 PAGE_CHECK 为 1 或 2 时，才需要指定。

29 MAL_FLAG

初始化时设置 dm.ini 中的 MAL_INI 值。取值 0 或 1。默认值为 0。可选参数。

1 表示 MAL_INI=1，启动 MAL 系统。同时，需要配置 dmmal.ini 文件。

0 表示 MAL_INI=0，不启用 MAL 系统。

30 ARCH_FLAG

初始化时设置 dm.ini 中的 ARCH_INI 值。取值 0 或 1。默认值为 0。可选参数。

1 表示 ARCH_INI=1，启用归档。同时，需要配置 dmarch.ini 文件。

0 表示 ARCH_INI=0，不启用归档。

31 MPP_FLAG

MPP 系统内的库初始化时设置 dm.ini 中的 MPP_INI。取值 0 或 1。默认值为 0。可选参数。

1 表示 MPP_INI=1，启用 MPP 系统。

0表示MPP_INI=0，不启用MPP系统。

32 CONTROL

指定初始化配置文件路径。可选参数。

CONTROL 参数只能单独使用，和其他参数一起使用会报错。

CONTROL 参数主要用于将数据文件创建在 ASM 或 DSC 环境中。CONTROL 参数和初始化配置文件，详细信息见下一章节。

33 AUTO_OVERWRITE

是否覆盖建库目录下所有同名文件。取值：0 不覆盖，表示建库目录下如果没有同名文件，直接创建。如果遇到同名文件时，屏幕提示是否需要覆盖，由用户手动输入是与否（y/n，1/0）；1 部分覆盖，表示覆盖建库目录下所有同名文件；2 完全覆盖，表示先清理掉建库目录下所有文件再重新创建。默认值为 0。可选参数。

34 USE_NEW_HASH

是否使用改进的字符类型 HASH 算法。字符类型在计算 HASH 值时所采用的 HASH 算法类别。取值：0：原始 HASH 算法；1：改进的 HASH 算法。默认值为 1。可选参数。

如果备份文件和数据库文件中该参数值不一致，则还原时会报错。

35 SYSSSO_PWD

初始化时设置数据库安全员 SYSSSO 的密码，默认为 SYSSSO。密码为字符串，长度在 6 到 48 个字符之间。可选参数。

仅在安全版本下可见和可设置。

36 SYSDBO_PWD

初始化时设置数据库操作员 SYSDBO 的密码，默认为 SYSDBO。密码为字符串，长度在 6 到 48 个字符之间。可选参数。

仅在安全版本且 PRIV_FLAG=1 时，才有效。

37 PRIV_FLAG

是否是四权分立。取值：1 是，0 否。默认值为 0。可选参数。

为了保证数据库系统的安全性，DM数据库采用“三权分立”或“四权分立”的安全机制，“三权分立”时系统内置三种系统管理员，包括数据库管理员、数据库安全员和数据库审计员，“四权分立”时新增了一类用户，称为数据库对象操作员。它们各司其职，互相制约，有效地避免了将所有权限集中于一人的风险，保证了系统的安全性。默认情况下为“三权分立”。

仅在安全版本下可见和可设置。

38 ELOG_PATH

指定初始化过程中生成的日志文件所在路径。可选参数。

39 DFS_FLAG

DMTDD 专用参数。指定该库是否使用 DFS 存储，1 是，0 否。缺省值为 0。可选参数。

40 DFS_PATH

DMTDD 专用参数。指定数据文件在 DFS 中的默认路径，要在路径最前加上 $。缺省为 $/db_name，db_name 是初始化库指定的。可选参数。

41 DFS_HOST

DMTDD 专用参数。指定连接分布式系统 DFS 的服务器地址。缺省为 localhost。可选参数。

42 DFS_PORT

DMTDD 专用参数。指定连接分布式系统 DFS 的服务端口号，有效值 1024~65534。缺省值为 3332。

43 DFS_COPY_NUM

DMTDD 专用参数。指定分布式系统的副本数。缺省为 3。

44 DFS_DB_NAME

DMTDD 专用参数。指定该库在 DMTDD 中的名字，默认是与 DB_NAME 一致。不同库不允许重名。可选参数。

45 SHARE_FLAG

DMTDD 专用参数。指定分布式系统中该数据库的共享属性，该库是否可用于配置多个 DS。取值为 0 或 1，0 表示该库只能配置到一个 DS 上；1 表示可以配置到多个 DS 上，且只能由 DSC 环境启动，默认为 0。可选参数。

46 REGION_MODE

DMTDD 专用参数。指定分布式系统中该数据库的系统表空间数据文件的区块策略。0:微区策略，1:宏区策略。缺省为 0。

47 HUGE_WITH_DELTA

是否仅允许创建事务型HUGE表。取值：1 是，0 否。默认值为 1。可选参数。

设置为 1 时，仅允许创建事务型 HUGE 表，不允许创建非事务型 HUGE 表。

48 RLOG_GEN_FOR_HUGE

是否生成 HUGE 表 REDO 日志。取值：1 是，0 否。默认值为 0。可选参数。

此参数仅在 HUGE_WITH_DELTA 为 1 时才允许设置，也就是仅限于对事务型 HUGE 表设置是否生成 REDO 日志。

49 PSEG_MGR_FLAG

是否仅使用管理段记录事务信息。取值：1 是，0 否。默认值为 0。可选参数。

配置为 0 时，除了在管理段中记录事务信息外，还会在事务分配的首个回滚页中记录事务信息；配置为1时，仅在管理段中记录事务信息。

50 CHAR_TO_VARCHAR2

用于指定是否允许把定长字符类型（CHAR）转换为变长字符类型（VARCHAR2）进行存储。取值：Y/y/1 是， N/n/0 否。默认值是 Y，可选参数。

51 HELP

显示帮助信息。可选参数。

以上就是dminit各类参数的介绍。

建库完成后，在 DM 服务器运行期间，可以通过查询 V$DM_INI 动态视图查看建库参数的具体信息。

更多达梦资讯请上达梦社区了解 https://eco.dameng.com