a_create_db 结构

保存使用 DBTools 库创建数据库所需的信息。

语法

typedef struct a_create_db {
    unsigned short      version;
    const char          *dbname;
    const char          *logname;
    const char          *startline;
    unsigned short      page_size;
    const char          *default_collation;
    const char          *nchar_collation;
    const char          *encoding;
    MSG_CALLBACK        errorrtn;
    MSG_CALLBACK        msgrtn;

    a_bit_field         blank_pad               : 2;
    a_bit_field         respect_case            : 1;
    a_bit_field         encrypt                 : 1;
    a_bit_field         avoid_view_collisions   : 1;
    a_bit_field         jconnect                : 1;
    a_bit_field         checksum                : 1;
    a_bit_field         encrypted_tables        : 1;
    a_bit_field         case_sensitivity_use_default : 1;
    char                verbose;
    char                accent_sensitivity;
    const char          *mirrorname;
    const char          *data_store_type;
    const char          *encryption_key;
    const char          *encryption_algorithm;
    char                *dba_uid;
    char                *dba_pwd;
    unsigned int        db_size;
    int                 db_size_unit;

} a_create_db;

成员

说明

version

DBTools 版本号。

dbname

数据库文件名。

logname

新事务日志的名称。

startline

用于启动数据库服务器的命令行。例如：

"d:\sqlany11\bin32\dbeng11.exe"

如果此成员为 NULL，则使用缺省启动行

以下是缺省 START 参数：

"dbeng11 -gp page_size -c 10M"

page_size

数据库的页面大小。

default_collation

数据库的归类。

nchar_collation

如果不为 NULL，则用于生成带有指定字符串的 NCHAR COLLATION 子句。

errorrtn

用于处理错误消息的回调例程。

msgrtn

用于处理信息消息的回调例程。

blank_pad

必须是 NO_BLANK_PADDING 或 BLANK_PADDING 之一。比较字符串时，将空白视为有效，并保存索引信息以反映这种情况。请参见空白填充枚举。

respect_case

使字符串比较区分大小写，并保存索引信息以反映这种情况。

encrypt

设置后，将生成 ENCRYPTED ON，如果还设置了 encrypted_tables，将生成 ENCRYPTED TABLES ON 子句。

avoid_view_collisions

忽略 Watcom SQL 兼容视图 SYS.SYSCOLUMNS 和 SYS.SYSINDEXES 的生成。

jconnect

包括 jConnect 所需的系统过程。

checksum

设置为 1 表示 ON，设置为 0 表示 OFF。生成 CHECKSUM ON 或 CHECKSUM OFF 子句之一。

encrypted_tables

设置为 1 支持加密表。与 encrypt 一起使用，生成 ENCRYPTED TABLE ON 子句而不是 ENCRYPTED ON 子句。

case_sensitivity_use_default

如果设置该成员，则地区将使用缺省的区分大小写设置。这只会影响 UCA。设置该成员时，请不要向 CREATE DATABASE 语句中添加 CASE RESPECT 子句。

verbose

请参见详细枚举。

accent_sensitivity

y、n 或 f（是、否、法语）之一。生成 ACCENT RESPECT、ACCENT IGNORE 或 ACCENT FRENCH 子句之一。

mirrorname

事务日志镜像的名称。

data_store_type

保留。使用 NULL。

encryption_key

数据库文件的加密密钥。与 encrypt 一起使用，生成 KEY 子句。

encryption_algorithm

加密算法（AES、AES256、AES_FIPS 或 AES256_FIPS）。与 encrypt 和 encryption_key 一起使用，生成 ALGORITHM 子句。

dba_uid

如果不为 NULL，则生成 DBA USER xxx 子句。

dba_pwd

如果不为 NULL，则生成 DBA PASSWORD xxx 子句。

db_size

如果不为 0，则生成 DATABASE SIZE 子句。

db_size_unit

与 db_size 一起使用，必须为 DBSP_UNIT_NONE、DBSP_UNIT_PAGES、DBSP_UNIT_BYTES、DBSP_UNIT_KILOBYTES、DBSP_UNIT_MEGABYTES、DBSP_UNIT_GIGABYTES、DBSP_UNIT_TERABYTES 其中之一。如果不为 DBSP_UNIT_NONE，它会生成相应的关键字（例如，当 db_size 为 10 且 db_size_unit 为 DBSP_UNIT_MEGABYTES 时，将生成 DATABASE SIZE 10 MB）。请参见数据库大小单位枚举。

a_create_db 结构

语法

成员

另请参见