Click here to view and discuss this page in DocCommentXchange. In the future, you will be sent there automatically.

SQL Anywhere 11.0.1 (中文) » SQL Anywhere 服务器 - 编程 » SQL Anywhere 数据库工具接口 » 数据库工具接口 » DBTools 结构

 

an_unload_db 结构

保存有关使用 DBTools 库卸载数据库或者为 SQL Remote 抽取远程数据库所需的信息。指示由 dbxtract SQL Remote 抽取实用程序使用的字段。

语法
typedef struct an_unload_db {
    unsigned short      version;
    const char *        connectparms;
    const char *        temp_dir;
    const char *        reload_filename;
    char *              reload_connectparms;
    char *              reload_db_filename;
    MSG_CALLBACK        errorrtn;
    MSG_CALLBACK        msgrtn;
    MSG_CALLBACK        statusrtn;
    MSG_CALLBACK        confirmrtn;
    char                unload_type;
    char                verbose;
    char                escape_char;
    char                unload_interrupted;
    a_bit_field         unordered               : 1;
    a_bit_field         no_confirm              : 1;
    a_bit_field         use_internal_unload     : 1;
    a_bit_field         refresh_mat_view        : 1;
    a_bit_field         table_list_provided     : 1;
    a_bit_field         exclude_tables          : 1;
    a_bit_field         preserve_ids            : 1;
    a_bit_field         replace_db              : 1;
    a_bit_short         escape_char_present     : 1;
    a_bit_short         use_internal_reload     : 1;
    a_bit_field         recompute               : 1;
    a_bit_field         make_auxiliary          : 1;
    a_bit_field         encrypted_tables        : 1;
    a_bit_field         remove_encrypted_tables : 1;
    a_bit_field         extract                 : 1;
    a_bit_field         start_subscriptions     : 1;
    a_bit_field         exclude_foreign_keys    : 1;
    a_bit_field         exclude_procedures      : 1;
    a_bit_field         exclude_triggers        : 1;
    a_bit_field         exclude_views           : 1;
    a_bit_field         isolation_set           : 1;
    a_bit_field         include_where_subscribe : 1;
    a_bit_field         exclude_hooks           : 1;
    a_bit_field         startline_name          : 1;
    a_bit_field         debug                   : 1;
    a_bit_field         compress_output         : 1;
    a_bit_field         schema_reload           : 1;
    a_bit_field         genscript               : 1;
    a_bit_field         runscript               : 1;
    a_bit_field         display_create          : 1;
    a_bit_field         display_create_dbinit   : 1;
    a_bit_field         preserve_identity_values: 1;
    const char *        ms_filename;
    int                 ms_reserve;
    int                 ms_size;
    long                notemp_size;
    p_name              table_list;
    a_sysinfo           sysinfo;
    const char *        remote_dir;
    const char *        subscriber_username;
    unsigned short      isolation_level;
    const char *        site_name;
    const char *        template_name;
    char *              reload_db_logname;
    const char *        encryption_key;
    const char *        encryption_algorithm;
    unsigned short      reload_page_size;
    const char *        locale;
    const char *        startline;
    const char *        startline_old;
} an_unload_db;
成员
成员 说明
version DBTools 版本号。
connectparms

连接到数据库所需的参数。它们采用如下所示的连接字符串形式:

"UID=DBA;PWD=sql;DBF=samples-dir\demo.db"

数据库服务器将由连接字符串的 START 参数启动。例如:

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

一个包括 START 参数的完整连接字符串示例:

"UID=DBA;PWD=sql;DBF=samples-dir\demo.db;START=d:\sqlany11\bin32\dbeng11.exe"

有关连接参数的列表,请参见连接参数

temp_dir 用于卸载数据文件的目录。
reload_filename dbunload -r 选项,与 reload.sql 类似。
reload_connectparms 用于重装数据库的用户 ID、口令、数据库。
reload_db_filename 要创建的重装数据库的文件名。
errorrtn 用于处理错误消息的回调例程。
msgrtn 用于处理信息消息的回调例程。
statusrtn 用于处理状态消息的回调例程。
confirmrtn 用于确认操作的回调例程。
unload_type 请参见dbunload 类型枚举
verbose 请参见详细枚举
escape_char 当 escape_char_present 为 TRUE 时使用。
unload_interrupted 在卸载被中断的情况下设置。
unordered dbunload -u 设置为 TRUE。
no_confirm dbunload -y 设置为 TRUE。
use_internal_unload dbunload -ii/-ix 设置为 TRUE。dbunload -xi/-xx 设置为 FALSE。
refresh_mat_view dbunload -g 设置为 TRUE。
table_list_provided dbunload -e list 或 -i 设置为 TRUE。
exclude_tables

dbunload -e 设置为 TRUE。dbunload -i(未提供文档)设置为 FALSE。

preserve_ids dbunload 设置为 TRUE/-m 设置为 FALSE。
replace_db dbunload -ar 设置为 TRUE。
escape_char_present dbunload -p 设置为 TRUE。注意必须设置 escape_char。
use_internal_reload 通常设置为 TRUE;-ix/-xx 设置为 FALSE;-ii/-xi 设置为 TRUE。
recompute dbunload -dc 设置为 TRUE。重新计算所有计算列。
make_auxiliary dbunload -k 设置为 TRUE。创建辅助目录(与诊断跟踪一起使用)。
encrypted_tables dbunload -et 设置为 TRUE。在新数据库中启用加密表(与 -an 或 -ar 一起使用)。
remove_encrypted_tables dbunload -er 设置为 TRUE。从加密表中删除密钥。
extract 如果是 dbxtract,则为 TRUE,否则为 FALSE。
start_subscriptions 缺省情况下,dbxtract 为 TRUE,-b 则设置为 FALSE。
exclude_foreign_keys dbxtract -xf 设置为 TRUE。
exclude_procedures dbxtract -xp 设置为 TRUE。
exclude_triggers dbxtract -xt 设置为 TRUE。
exclude_views dbxtract -xv 设置为 TRUE。
isolation_set dbxtract -l 设置为 TRUE。
include_where_subscribe dbxtract -f 设置为 TRUE。
exclude_hooks dbxtract -hx 设置为 TRUE。
startline_name (内部使用)
debug (内部使用)
compress_output dbunload -cp 设置为 TRUE。
schema_reload (内部使用)
genscript (内部使用)
runscript (内部使用)
display_create -cm 设置为 TRUE
display_create_dbinit -cm dbinit 设置为 TRUE
preserve_identity_values dbunload -l 设置为 TRUE
ms_filename (内部使用)
ms_reserve (内部使用)
ms_size (内部使用)
notemp_size (内部使用)
table_list 选择性表列表。
sysinfo (内部使用)
remote_dir (类似 temp_dir),但用于在服务器端内部卸载。
subscriber_username dbxtract 的参数。
isolation_level dbxtract -l 设置为值。
site_name 对于 dbxtract:指定一个站点名称。
template_name 对于 dbxtract:指定一个模板名称。
reload_db_logname 该重装数据库的日志文件名。
encryption_key -ek 设置为字符串。
encryption_algorithm -ea 设置为 "AES"、"AES256"、"AES_FIPS" 或 "AES256_FIPS" 之一。
reload_page_size dbunload -ap 设置为值。设置重建数据库的页面大小。
locale (内部使用)区域设置(语言和字符集)。
startline (内部使用)
startline_old (内部使用)

这些成员与可从 dbunload 和 dbxtract 实用程序访问的功能相对应。

有关更多说明,请参见 dbtools.h 头文件。

另请参见