Sybase数据库技术,数据库恢复

 

随着Sybase被完全整合到SAP下，Sybase原来的支持网站被SAP Support Portal取代。
只有购买了SAP服务的用户才能使用账号登录SAP Support Portal进行介质下载、补丁升级、报Incident等。
目前，原Sybase所有产品（包括：Adaptive Server Enterprise、Sybase IQ、Replication Server、PowerDesigner等）的官方手册仍然可以从https://infocenter.sybase.com/help/index.jsp进行浏览或下载。暂不清楚该网站https://infocenter.sybase.com/help/index.jsp何时会被完全迁移到SAP Support上！
Sybase官方手册英文版有html和pdf两种格式，而中文版手册只有pdf一种格式。为了国内Sybase用户更方便、快捷地搜索Sybase常见产品的官方手册内容，特将中文版Sybase官方手册转为html格式！
Sybase产品官方手册中文版的html格式所有内容的版权归SAP公司所有！本博客站长是Sybase数据库的铁杆粉丝！

如有Sybase数据库技术问题需要咨询，请联系我！

  QQ :289965371
  Email:

以下官方手册为SAP IQ 16.0 SP03中文版：

1. SAP Sybase IQ 简介
   
2. 新功能摘要
   
3. IQ 发行公告(linux)
   
4. IQ 快速入门(unix)
   
5. 安装和配置指南(linux)
   
6. 管理：备份、恢复和数据恢复
   
7. 管理：数据库
   
8. SAP Sybase IQ 错误消息
   
9. 管理：全球化
   
10. IQ 许可选项指南
    
11. 管理：装载管理
    
12. IQ 迁移
    
13. 管理：Multiplex
    
14. 性能和调优指南
    
15. IQ 编程
    
16. 参考：构件块、表和过程
    
17. 参考：语句和选项
    
18. 管理：内存行级版本控制
    
19. 管理：空间数据
    
20. IQ 非结构化数据分析
    
21. 用户定义的函数
    
22. 管理：用户管理和安全
    
23. 实用程序指南
    

 

< 上一个 | 内容 | 下一步 >

db_register_a_callback 函数 ‌

此函数注册回调函数。

语法

void db_register_a_callback( SQLCA * sqlca , a_db_callback_index index ,

( SQL_CALLBACK_PARM ) callback );

参数

• sqlca – 指向 SQLCA 结构的指针。

• index – 标识下述回调类型的索引值。

• 回调 – 用户定义的回调函数的地址。

注释

如果您不注册 DB_CALLBACK_WAIT 回调，则缺省操作是不执行任何操作。您的应 用程序块，等待数据库响应。必须为 MESSAGE TO CLIENT 语句注册一个回调。

要删除回调，请传递一个空指针作为 callback 函数。 对于 index 参数，允许使用以下值：

• DB_CALLBACK_DEBUG_MESSAGE – 对每条调试信息都要调用一次提供的函 数，而且会有一个包含该调试信息文本的以空值终止的字符串传递给该函数。调 试消息是记录到 LogFile 文件的消息。为了将调试消息传递给此回调函数，必须使用 LogFile 连接参数。该字符串通常在紧邻终止的空字符之前有一个换行符 (\n)。回 调函数的原型如下：

void SQL_CALLBACK debug_message_callback (

SQLCA * sqlca,

char * message_string );

• DB_CALLBACK_START – 原型如下：

void SQL_CALLBACK start_callback ( SQLCA * sqlca );

此函数在数据库请求发送到服务器之前进行调用。DB_CALLBACK_START 只在

Windows 上使用。

• DB_CALLBACK_FINISH – 原型如下：

void SQL_CALLBACK finish_callback ( SQLCA * sqlca );

此函数在 DBLIB 接口 DLL 收到对数据库请求的响应之后进行调用。 DB_CALLBACK_FINISH 仅在 Windows 操作系统上使用。

• DB_CALLBACK_CONN_DROPPED – 原型如下：

void SQL_CALLBACK conn_dropped_callback (

SQLCA * sqlca ,

char * conn_name );

此函数在数据库服务器要通过 DROP CONNECTION 语句删除连接（因活动超时 或因该数据库服务器正在关闭）时进行调用。会为此函数传递连接名称 conn_name，以便使您能够区分连接。如果没有命名连接，则它的值为 NULL。

• DB_CALLBACK_WAIT – 原型如下：

void SQL_CALLBACK wait_callback ( SQLCA * sqlca );

在数据库服务器或客户端库忙于处理您的数据库请求的同时，接口库反复调用此 函数。

您可以按如下所示注册此回调函数：

db_register_a_callback( &sqlca, DB_CALLBACK_WAIT,

(SQL_CALLBACK_PARM)&db_wait_request );

• DB_CALLBACK_MESSAGE – 使用此函数后，应用程序可以对处理请求期间从 服务器接收的消息进行处理。可使用 SQL MESSAGE 语句将消息从数据库服务器 发送到客户端应用程序。长时间运行的数据库服务器语句也可以生成消息。

回调原型如下：

void SQL_CALLBACK message_callback (

SQLCA * sqlca ,

unsigned char msg_type , an_sql_code code , unsigned short length , char * msg

);

msg_type 参数说明消息的重要程度。您可能希望不同的消息类型以不同的方式来 处理。msg_type 的以下可能值在 sqldef.h 中定义。

• MESSAGE_TYPE_INFO – 消息类型为 INFO。

• MESSAGE_TYPE_WARNING – 消息类型为 WARNING。

• MESSAGE_TYPE_ACTION – 消息类型为 ACTION。

• MESSAGE_TYPE_STATUS – 消息类型为 STATUS。

• MESSAGE_TYPE_PROGRESS – 消息类型为 PROGRESS。此类消息是由长 时间运行的数据库服务器语句生成的，如 BACKUP DATABASE 和 LOAD TABLE。

code 字段可提供与消息关联的 SQLCODE，否则该值为 0。length 字段指定消息的 长度。消息不以空值终止。SAP Sybase IQ DBLIB 和 ODBC 客户端可以使用 DB_CALLBACK_MESSAGE 参数来接收进度消息。

例如，Interactive SQL 回调在“消息”选项卡中显示 STATUS 和 INFO 消息，而在 窗口中显示类型为 ACTION 和 WARNING 的消息。如果应用程序不注册此回调，

会有一个缺省回调，它导致将所有消息写入服务器日志文件（如果正在调试并指 定了日志文件）。另外，MESSAGE_TYPE_WARNING 和 MESSAGE_TYPE_ACTION 类型的消息会以与操作系统相关的方式更为突出地显 示。

如果某消息回调未被应用程序注册，则在指定了 LogFile 连接参数后，发送至客 户端的消息将被保存到日志文件中。此外，发送至客户端的 ACTION 或 STATUS 消息在 Windows 操作系统下会出现窗口中，而在 Unix 操作系统下则被记录到 stderr。

• DB_CALLBACK_VALIDATE_FILE_TRANSFER – 用于注册文件传输校验回调 函数。在允许进行任何传输前，客户端库会调用校验回调函数（如果存在）。如 果在执行间接语句（从存储过程内部）期间，请求进行客户端数据传输，则除非 客户端应用程序注册了校验回调函数，否则客户端库将不允许进行传输。下面更 详尽地介绍了进行校验调用的条件。

回调原型如下：

int SQL_CALLBACK file_transfer_callback (

SQLCA * sqlca , char * file_name , int is_write

);

file_name 参数是要读取或写入的文件的名称。如果请求读取（从客户端传输到服 务器），则 is_write 参数为 0；如果请求写入，则该参数为非零值。如果不允许进 行文件传输，则回调函数应返回 0，否则返回非零值。

为确保数据安全，服务器会跟踪请求文件传输的语句的源。服务器会确定语句是 否是从客户端应用程序直接接收的。从客户端启动数据传输时，服务器会将语句 源的相关信息发送到客户端软件。对于嵌入式 SQL 客户端库而言，仅当是由于执 行客户端应用程序直接发送的语句而请求数据传输时，它才会允许无条件传输数 据。否则，应用程序必须注册上文所述的校验回调函数，如果未注册该函数，则 传输会被拒绝，而且语句失败并出现一个错误。如果客户端语句调用的某个存储 过程在数据库中已经存在，则对该存储过程本身的执行不被视为是客户端启动的 语句所完成的。但是，如果客户端应用程序显式地创建一个临时存储过程，则服 务器会将对该存储过程的执行视为是由客户端启动的。同样，如果客户端应用程 序执行一个批处理语句，则该批处理语句的执行被视为是直接由客户端应用程序 完成的。

< 上一个 | 内容 | 下一步 >