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. 实用程序指南
    

 

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

实现示例表 UDF udf_rg_1 ‌

名为 udf_rg_1 的示例表 UDF 描述了 v4 表 UDF 是如何生成 n 行数据的。表 UDF 的 实现在 udf_rg_1.cxx 中的示例目录之中。

1. 确定表 UDF 的输入和输出。

此示例根据输入参数的值生成 n 行数据。输入为单个整数参数，输出为由 integer

类型的单列所组成的多个行。

定义此过程所需的 CREATE PROCEDURE 语句为：

CREATE OR REPLACE PROCEDURE udf_rg_1( IN num INT ) RESULT( c1 INT )

EXTERNAL NAME ‘udf_rg_1@libv4apiex’

2. 声明库为 v4 库。

在此示例中，udf_rg_1.cxx 包括头文件 extfnapiv4.h ：

#include “extfnapiv4.h”

函数导出定义于 udf_main.cxx，以通知服务器此库包含有 v4 表 UDF：

a_sql_uint32 SQL_CALLBACK extfn_use_new_api( void )

/*************************************************/

{

return EXTFN_V4_API;

}

3. 定义 a_v4_extfn_proc 描述符。

在 udf_rg_1.cxx 中声明了必要的描述符：

static a_v4_extfn_proc udf_rg_descriptor =

{

NULL, // _start_extfn

NULL, // _finish_extfn udf_rg_evaluate, // _evaluate_extfn udf_rg_describe, // _describe_extfn NULL, // _leave_state_extfn

NULL, // _enter_state_extfn

NULL, // Reserved: must be NULL

NULL // Reserved: must be NULL

};

4. 定义库入口点函数。

此回调函数声明了主要的入口点函数。它只是将指针返回于

a_v4_proc_descriptor 的变量 udf_rg_descriptor。

extern "C"

a_v4_extfn_proc * SQL_CALLBACK udf_rg_1_proc()

/******************************************/

{

return &udf_rg_descriptor;

}

5. 定义服务器从表 UDF 中获取行信息的方法。

对 a_v4_extfn_table_func 描述符作了声明，该描述符用于告知服务器从表

UDF 中检索行数据的方法。

static a_v4_extfn_table_func udf_rg_table_funcs =

{

udf_rg_open, // _open_extfn udf_rg_fetch_into, // _fetch_into_extfn NULL, // _fetch_block_extfn

NULL, // _rewind_extfn udf_rg_close, // _close_extfn

NULL, // Reserved: must be NULL

NULL // Reserved: must be NULL

};

在此示例中，_fetch_into_extfn 函数将行数据传至服务器。这是一种最容易 理解和实现的数据传输方法。本文档将数据传输方法引用为行块数据交换。有以 下两种行块数据交换函数：_fetch_into_extfn 和 _fetch_block_extfn。

运行期间，当调用 _evaluate_extfn 函数时，UDF 将通过设置结果集参数来 发布表函数描述符。若要实现于此，UDF 必须为 a_v4_extfn_table 创建实 例：

static a_v4_extfn_table udf_rg_table = {

&udf_rg_table_funcs, // Table function descriptor

1 // number_of_columns

};

此结构包含一个指向 udf_rg_table_funcs 结构的指针，以及结果集中的列的 数量。此表 UDF 在其结果集中生成一个单列。

6. 实现具有 a_v4_extfn_proc 结构的函数。

在此示例中，所需的函数 _describe_extfn 不执行任何操作。其他示例描述了表

UDF 使用 describe 函数的方法：

static void UDF_CALLBACK udf_rg_describe( a_v4_extfn_proc_context *ctx )

/

*****************************************************************

/

{

// This required function is not needed in this simple example.

}

_evaluate_extfn 方法将获取 UDF 结果集的相关信息发送至服务器。通过调 用具有 a_v4_extfn_proc_context 结构（参数 0）的 set_value 方法来完 成此操作。参数 0 代表返回值，对于表 UDF 而言，该返回值为 DT_EXTFN_TABLE 类型的数据。此方法构建了 an_extfn_value 结构，将数据类型设置为 DT_EXTFN_TABLE，并将其值指针指向第 5 步中所创建的 a_v4_extfn_table 对象。对于表 UDF，该类型必须始终为 DT_EXTFN_TABLE。

static void UDF_CALLBACK udf_rg_evaluate( a_v4_extfn_proc_context *ctx,

void *args_handle )

/***********************************/

{

an_extfn_value result_table = { &udf_rg_table,

sizeof( udf_rg_table ), sizeof( udf_rg_table ), DT_EXTFN_TABLE };

// Tell the server what functions table functions are being

// implemented and how many columns are in our result set. ctx->set_value( args_handle, 0, &result_table );

}

7. 实现具有 a_v4_extfn_table_func 结构的函数。

在此示例中，表 UDF 需要读取传入的参数（其中包含生成行的数量），并对随后 将要使用的信息进行缓存。因为对于参数具有的每个新值都将调用 _open_extfn 方法，所以这是一个获取该信息的合适位置。

除了生成行的总数以外，表 UDF 还必须记住要生成的下一行。当服务器开始从表 UDF 提取行的时候，可能需要重复调用 _fetch_into_extfn 方法。这意味着表 UDF 必须记住已生成的最后一行。

以下结构创建于 udf_rg_1.cxx，以包含调用之间的状态信息：

struct udf_rg_state {

a_sql_int32 next_row; // The next row to produce a_sql_int32 max_row; // The number of rows to generate.

};

打开方法首先使用具有 a_v4_proc_context 结构的 get_value 方法来读取参 数 1 的值。使用具有 a_v4_proc_context 结构的 alloc 函数来配置 udf_rg_state 实例。表 UDF 应该使用内存管理函数（alloc 和 free）对具有 a_v4_proc_context 结构的数据进行管理，以便尽可能地管理其内存空间。然 后将状态对象保存至 a_v4_proc_context 结构的 user_data 字段。执行完毕后， 该字段中存储的内容可供表 UDF 使用。

static short UDF_CALLBACK udf_rg_open( a_v4_extfn_table_context * tctx )

/***************************************/

{

an_extfn_value value; udf_rg_state * state = NULL;

// Read in the value of the input parameter and store it away in a

// state object. Save the state object in the context. if( !tctx->proc_context->get_value( tctx->args_handle,

1,

&value ) ) {

// Send an error to the client if we could not get the value. tctx->proc_context->set_error(

tctx->proc_context, 17001,

"Error: Could not get the value of parameter 1" );

return 0;

}

// Allocate memory for the state using the a_v4_extfn_proc_context

// function alloc.

state = (udf_rg_state *)

tctx->proc_context->alloc( tctx->proc_context,

sizeof( udf_rg_state ) );

// Start generating at row zero. state->next_row = 0;

// Save the value of parameter 1

state->max_row = *(a_sql_int32 *)value.data;

// Save the state on the context tctx->user_data = state;

return 1;

}

_fetch_info_extfn 方法返回行数据至服务器。该方法将被重复调用，直至其 返回 false。对于此示例，表 UDF 从 a_v4_extfn_proc_context 对象的 user_data 字段中检索状态信息，以确定要生成的下一行以及要生成的总行数。该 方法可生成的行数至多不超过所传入的行块结构中指定的最大行数。

对于此示例，表 UDF 生成 INT 类型的单列。它将状态信息中所存储的 next_row 数据复制到第一列的数据指针中。每次循环时，表 UDF 把一个新值复制到数据指 针中，当生成的行数达到最大值、或者行块已满时，则退出循环。

static short UDF_CALLBACK udf_rg_fetch_into( a_v4_extfn_table_context *tctx, a_v4_extfn_row_block *rb)

/*******************************************/

{

udf_rg_state *state = (udf_rg_state *)tctx->user_data;

// Because we are implementing fetch_into, the server has provided

// us with a row block. We need to inform the server how many rows

// this call to _fetch_into has produced. rb->num_rows = 0;

// The server provided row block structure contains a max_rows

// field. This field is the maximum number of rows that this row

// block can handle. We can not exceed this number. We will also

// stop producing rows when we have produced the number of rows

// required as per the max_row in the state.

while( rb->num_rows < rb->max_rows && state->next_row < state->max_row ) {

// Get the current row from the row block data. a_v4_extfn_row &row = rb->row_data[ rb->num_rows ];

// Get the column data for the current row. a_v4_extfn_column_data &col0 = row.column_data[ 0 ];

// Copy the integer value for the next row to generate

// into the column data for the current row.

memcpy( col0.data, &state->next_row, col0.max_piece_len );

state->next_row++; rb->num_rows++;

}

// If we produced any rows, return true. return( rb->num_rows > 0 );

}

当所有行提取完毕后，表 UDF 为参数的每个新值调用一次 _close_extfn 方 法。也就是说，每次调用 _open_extfn 之后，都将调用 _close_extfn。在此 示例中，当调用 _open_extfn 时，表·UDF 必须释放内存，通过从 a_v4_extfn_proc_context 对象的 user_data 字段中检索状态信息，而后调用 free 方法予以实现。

static short UDF_CALLBACK udf_rg_close( a_v4_extfn_table_context *tctx)

/*************************************/

{

udf_rg_state * state = NULL;

// Retrieve the state that was saved in user_data state = (udf_rg_state *)tctx->user_data;

// Free the memory for the state using the a_v4_extfn_proc_context

// function free.

tctx->proc_context->free( tctx->proc_context, state ); tctx->user_data = NULL;

return 1;

}

另请参见

• udf_rg_2 （第 103 页）

• udf_rg_3 （第 107 页）

• 行块数据交换 （第 120 页）

• 描述 API （第 193 页）

• _evaluate_extfn （第 271 页）

• fetch_into （第 292 页）

• 表 (a_v4_extfn_table) （第 289 页）

• 外部过程上下文 (a_v4_extfn_proc_context) （第 273 页）

• _open_extfn （第 299 页）

• _close_extfn （第 302 页）

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