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_rg_3 ‌

示例表 UDF udf_rg_3 基于 udf_rg_2 而构建，并且具有类似的行为。该过程名为 udf_rg_3，它的实现在 udf_rg_3.cxx 中的 samples 目录中。

表 UDF udf_rg_3 和 udf_rg_2 之间的行为差异在于 udf_rg_3 只能生成从 0 到 99 的 100

个唯一值，而后根据需要重复此序列。此表 UDF 提供了 _start_extfn 和

_finish_extfn 方法，并且包含 _describe_extfn 的修订版本以解释函数中的 不同语义。

请使用 fetch_block 而非 fetch_into 方法，以使表 UDF 拥有行块结构并使用 自己的数据布局。为描述此问题，在数组中对生成的数字作预分配。当执行读取操作 时，表 UDF 将行块数据指针直接指向包含数据的内存地址，而不是将数据复制到服 务器所提供的行块中，因而避免了额外的复制操作。

如下的辅助结构可以存储数字数组。此结构也可保存一个指向所分配行块的指针，以 供释放行块之用。

#define MAX_ROWS 100 struct RowData {

a_sql_int32 numbers[MAX_ROWS];

a_sql_uint32 piece_len; a_v4_extfn_row_block * rows;

void Init()

{

rows = NULL;

piece_len = sizeof( a_sql_int32 ); for( int i = 0; i < MAX_ROWS; i++ ) {

numbers[i] = i;

}

}

};

当表 UDF 开始执行（执行完毕）时，将使用 a_v4_extfn_proc_context 中的

_start_extfn（ _finish_extfn ）方法分配此结构（释放此结构）。

static void UDF_CALLBACK udf_rg_start( a_v4_extfn_proc_context *ctx )

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

{

// The start_extfn method is a good place to allocate our row

// data. This method is called only once at the beginning of

// execution.

RowData *row_data = (RowData *)

ctx->alloc( ctx, sizeof( RowData ) ); row_data->Init();

ctx->_user_data = row_data;

}

finish 方法执行两个功能：

• 释放 RowData 结构。

• 如果表 UDF 在执行读取操作时遇到错误且无法销毁行块，则销毁该行块。

static void UDF_CALLBACK udf_rg_finish( a_v4_extfn_proc_context *ctx )

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

{

if( ctx->_user_data != NULL ) {

RowData *row_data = (RowData *)ctx->_user_data;

// If rows is non-null here, it means an error occurred and

// fetch_block did not complete. if( row_data->rows != NULL ) {

DestroyRowBlock( ctx, row_data->rows, 0, false );

}

ctx->free( ctx, ctx->_user_data ); ctx->_user_data = NULL;

}

}

fetch_block 方法是：

static short UDF_CALLBACK udf_rg_fetch_block( a_v4_extfn_table_context *tctx, a_v4_extfn_row_block **rows )

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

{

// First call, we need to build the row block if( *rows == NULL ) {

// This function will build a row block structure that holds

// MAX_ROWS rows of data. See udf_utils.cxx for details.

*rows = BuildRowBlock( tctx->proc_context, 0, MAX_ROWS, false );

// This pointer gets saved here because in some circumstances

// when an error occurs, its possible we may have allocated

// the rowblock structure but then never called back into

// fetch_block to deallocate it. In this case, when the finish

// method is called, we will end up deallocating it there. row_data->rows = *rows;

}

(*rows)->num_rows = 0;

// The row block we allocated contains a max_rows member that was

// set to the macro MAX_ROWS (100 in this case). 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( (*rows)->num_rows < (*rows)->max_rows && state->next_row < state->max_row ) {

a_v4_extfn_row &row = (*rows)->row_data[ (*rows)->num_rows ]; a_v4_extfn_column_data &col0 = row.column_data[ 0 ];

// Row generation here is a matter of pointing the data

// pointer in the rowblock to our pre-allocated array of

// integers that was stored in the proc_context.

col0.data = &row_data->numbers[(*rows)->num_rows % MAX_ROWS]; col0.max_piece_len = sizeof( a_sql_int32 );

col0.piece_len = &row_data->piece_len; state->next_row++;

(*rows)->num_rows++;

}

if( (*rows)->num_rows > 0 ) { return 1;

} else {

// When we are finished generating data, we can destroy the

// row block structure.

DestroyRowBlock( tctx->proc_context, *rows, 0, false ); row_data->rows = NULL;

return 0;

}

}

首次调用此方法时，将使用 udf_utils.cxx 中的帮助函数 BuildRowBlock 分配一 个行块。将指向该行块的指针保存于 RowData 结构中，以备后用。

通过将列数据的数据指针设置为序列（此前分配的数字数组）中下一个数字的地址， 从而完成行的生成。列数据的 piece_len 指针也必须进行初始化，将其设置为 piece_len（RowData 的成员）的地址。因为行具有固定的数据长度，所以对于所 有行此数字相同。

当最后一次调用读取操作、且不再生成新的数据时，将使用 udf_utils.cxx 中的 帮助函数 DestroyRowBlock 销毁行块结构。

为了容纳此表 UDF（仅生成 100 个唯一值），请将 EXTFNAPIV4_DESCRIBE_COL_DISTINCT_VALUES 设置为 100。源自 describe 方 法的下述代码片段对此作了描述：

static void UDF_CALLBACK udf_rg_describe( a_v4_extfn_proc_context *ctx )

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

{

...

...

...

a_v4_extfn_estimate distinct = { MAX_ROWS, 1.0

};

// Inform the server that this UDF will produce MAX_ROWS

// distinct values for column 1 of its result set. desc_rc = ctx->describe_column_set

( ctx, 0,

1, EXTFNAPIV4_DESCRIBE_COL_DISTINCT_VALUES,

&distinct,

sizeof( distinct ) );

...

...

...

}

UDF_CHECK_DESCRIBE( ctx, desc_rc );

另请参见

• udf_rg_2 （第 103 页）

• 实现示例表 UDF udf_rg_1 （第 98 页）

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