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

 

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

tpf_rg_1

TPF 示例 tpf_rg_1.cxx 类似于表 UDF 示例 udf_rg_2.cxx。它根据输入参数生 成数据行。

所生成行的数量为单个输入表中行值的总和。输出与 udf_rg_2.cxx 相同。 此示例的大多数代码同 udf_rg_2.cxx 相同。主要区别在于：

• 实现函数的名称具有 tpf_rg 前缀，而非 udf_rg。有关详细信息，请参见 tpf_rg_1.cxx。

• _describe_extfn 的实现对该示例的模式进行验证，但是不对生成行的数量进 行估计。

• _open_extfn 的实现从输入表中读取各行，以便确定生成行的数量。

_describe_extfn 方法可满足 udf_rg_2.cxx 和此示例间的模式差异。特别是， 参数 1 是一个表，该表有一个整数列。此代码片段对 _describe_extfn 作了描述：

static void UDF_CALLBACK tpf_rg_describe( a_v4_extfn_proc_context *ctx )

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

{

a_sql_int32 desc_rc;

// The following describes will ensure that the schema defined

// by the user matches the schema supported by this TPF

// This is achieved by telling the server what our schema is

// using describe_xxxx_set methods.

if( ctx->current_state == EXTFNAPIV4_STATE_ANNOTATION ) {

…

…

// Inform the server that the type of parameter 1 is a TABLE type = DT_EXTFN_TABLE;

desc_rc = ctx->describe_parameter_set ( ctx,

1, EXTFNAPIV4_DESCRIBE_PARM_TYPE,

&type,

sizeof( type ) ); UDF_CHECK_DESCRIBE( ctx, desc_rc );

// Inform the server that the input table should have a single

// column. num_cols = 1;

desc_rc = ctx->describe_parameter_set ( ctx,

1, EXTFNAPIV4_DESCRIBE_PARM_TABLE_NUM_COLUMNS,

&num_cols,

sizeof( num_cols ) );

UDF_CHECK_DESCRIBE( ctx, desc_rc );

// Inform the server that the input table column is an integer type = DT_INT;

desc_rc = ctx->describe_column_set ( ctx,

1,

1, EXTFNAPIV4_DESCRIBE_COL_TYPE,

&type,

sizeof( type ) ); UDF_CHECK_DESCRIBE( ctx, desc_rc );

…

…

}

}

在 udf_rg_2.cxx 中，UDF 所生成的行的数量如果为常量，则在描述阶段即可得到 该值。表参数不能为常量，所以直到处于执行状态时才可得到其值。因此，任何优化 程序都无法在描述阶段即对所生成的行的数量做出估计。

在此示例中，仅当处于标注状态时调用 describe 才可起到作用。当处于其他状态时， 类似调用将不执行任何操作。

_open_extfn 方法从输入表中读取行数据，并计算其和值。与在 udf_rg_2.cxx 示例中所采用的方法相同，使用 get_value 检索第一个输入参数的值。此处的不同 之处在于参数为 a_v4_extfn_table 指针类型。此代码片段对 _open_extfn 作 了描述：

static short UDF_CALLBACK tpf_rg_open( a_v4_extfn_table_context * tctx )

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

{

an_extfn_value value;

tpf_rg_state * state = NULL;

a_v4_extfn_table_context * rs = NULL; a_sql_uint32 num_to_generate = 0;

// 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;

}

// Open a result set for the input table.

if( !tctx->proc_context->open_result_set( tctx->proc_context,

( a_v4_extfn_table * )value.data,

&rs ) ) {

// Send an error to the client if we could not open the result

// set.

tctx->proc_context->set_error( tctx->proc_context,

17001,

"Error: Could not open result set on input table." );

return 0;

}

a_v4_extfn_row_block * rbfb = NULL;

a_v4_extfn_row * rfb = NULL;

a_v4_extfn_column_data * cdfb = NULL;

// When using fetch block to read rows from an input table, the

// server will manage the row block allocation. while( rs->fetch_block( rs, &rbfb ) ) {

// Each successful call to fetch will fill rows in the server

// allocated row block. The number of rows retrieved is

// indicated by the num_rows member.

for( unsigned int i = 0; i < rbfb->num_rows; i++ ) { rfb = &(rbfb->row_data[i]);

cdfb = &(rfb->column_data[0]);

>null_value ) {

// Only consider non-null values. To determine null we

// have to use the following logic.

if( (*cdfb->is_null & cdfb->null_mask) != cdfb-

num_to_generate += *(a_sql_int32 *)cdfb->data;

}

}

}

if( !tctx->proc_context->close_result_set( tctx->proc_context, rs ) )

{

// Send an error to the client if we could not close the

// result set.

tctx->proc_context->set_error( tctx->proc_context,

17001,

"Error: Could not close result set on input table." );

return 0;

}

// Allocate memory for the state using the a_v4_extfn_proc_context

// function alloc.

state = (tpf_rg_state *)

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

sizeof( tpf_rg_state ) );

// Start generating at row zero.

state->next_row = 0;

// Save the value of parameter 1 state->max_row = num_to_generate;

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

return 1;

}

当您使用 get_value 检索表对象时，请调用 open_result_set 以便从表中读取 数据行。

若要从输入表中读取各行，UDF 可以使用 fetch_into 或 fetch_block。当 UDF 从输入表中读取行时，它成为数据消耗程序。如果消耗程序（在本例中为 UDF）想 负责行块结构的管理，则其必须分配属于自己的行块结构，并使用 fetch_into 对 数据进行检索。或者，如果消耗程序希望生产者（在本例中为服务器）负责行块结构 的管理，则使用 fetch_block。tpf_rg_1 对后者作了描述。

使用打开的结果集时，tpf_rg_1 通过反复调用 fetch_block 以检索来自服务器 的数据行。每当成功调用 fetch_block 时，将使用至多为 num_rows 的行填充服 务器分配的行块结构。在 tpf_rg_1 中，对各行中第一列的值计算和值。与 udf_rg_2.cxx 示例相同，该和值被存储于 a_v4_extfn_proc_context 状态以 备后用。

另请参见

• 描述 API （第 193 页）

• _open_extfn （第 299 页）

• 表 (a_v4_extfn_table) （第 289 页）

• _fetch_block_extfn （第 300 页）

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