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

示例表 UDF udf_rg_2 基于 udf_rg_1.cxx 中的示例而构建，且具有相同的行为。 该过程名为 udf_rg_2，它的实现在 udf_rg_2.cxx 中的示例目录中。

表 UDF udf_rg_2 在 a_v4_extfn_proc 描述符中提供了 _describe_extfn 的替 代实现方法。

static void UDF_CALLBACK udf_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 table udf.

// 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 we support a single input

// parameter. num_parms = 1;

desc_rc = ctx->describe_udf_set ( ctx,

EXTFNAPIV4_DESCRIBE_UDF_NUM_PARMS,

&num_parms,

sizeof( num_parms ) );

// Checks the return code and sets an error if the

// describe was unsuccessful for any reason. UDF_CHECK_DESCRIBE( ctx, desc_rc );

// Inform the server that the type of parameter 1 is int. type = DT_INT;

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 number of columns in our

// result set is 1. num_cols = 1;

desc_rc = ctx->describe_parameter_set ( ctx,

0, EXTFNAPIV4_DESCRIBE_PARM_TABLE_NUM_COLUMNS,

&num_cols,

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

// Inform the server that the type of column 1 in our

// result set is int. type = DT_INT;

desc_rc = ctx->describe_column_set ( ctx,

0,

1, EXTFNAPIV4_DESCRIBE_COL_TYPE,

&type,

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

}

// The following describes will inform the server of various

// optimizer related characteristics.

if( ctx->current_state == EXTFNAPIV4_STATE_OPTIMIZATION ) {

an_extfn_value p1_value; a_v4_extfn_estimate num_rows;

// If the value of parameter 1 was constant, then we can

// inform the server how many distinct values will be. desc_rc = ctx->describe_parameter_get

( ctx, 1,

EXTFNAPIV4_DESCRIBE_PARM_CONSTANT_VALUE,

&p1_value,

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

if( desc_rc != EXTFNAPIV4_DESCRIBE_NOT_AVAILABLE ) {

// Inform the server that this UDF will produce n rows. num_rows.value = *(a_sql_int32 *)p1_value.data; num_rows.confidence = 1;

desc_rc = ctx->describe_parameter_set ( ctx,

0, EXTFNAPIV4_DESCRIBE_PARM_TABLE_NUM_ROWS,

&num_rows,

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

// Inform the server that this UDF will produce n distinct

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

( ctx, 0,

1, EXTFNAPIV4_DESCRIBE_COL_DISTINCT_VALUES,

&num_rows,

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

}

}

}

该 describe 方法有两种主要功能：

• 通知服务器其所支持的模式。

• 通知服务器某些已知的优化属性。

在若干状态中将调用 describe 函数。然而，并非在每个状态中 describe 属性皆 可用。describe 方法确定了某种状态，在此状态中，通过检查 a_v4_extfn_proc 结构中的 current_state 变量对该方法予以执行。

当处于标注状态时，表 UDF udf_rg_2 将通知服务器，它具有一个 INTEGER 类型的 参数，并且其结果集包含一个 INTEGER 类型的单列。通过设置如下属性予以实现：

• EXTFNAPIV4_DESCRIBE_UDF_NUM_PARMS

• EXTFNAPIV4_DESCRIBE_PARM_TYPE

• EXTFNAPIV4_DESCRIBE_PARM_TABLE_NUM_COLUMNS

• EXTFNAPIV4_DESCRIBE_COL_TYPE

如果 describe 方法中所设置的信息同 CREATE PROCEDURE 语句的过程定义不匹 配，则 describe_parameter_set 和 describe_column_set 方法将返回 EXTFNAPIV4_DESCRIBE_INVALID_ATTRIBUTE_VALUE。然后，describe 方法将 设置一个错误参数以表明此处的客户端不匹配。

此示例使用定义于 udf_utils.h 中的 UDF_CHECK_DESCRIBE 宏以检查 describe

的返回值，并当执行失败时，设置一个错误参数。

在优化期间，表 UDF udf_rg_2 将通知服务器其所返回的行的数量与参数 1 中所指示 的行数相同。因为生成的行在递增，所以该值也是唯一的。在优化期间，只能使用具 有常量值的参数。使用 describe 属性 EXTFNAPIV4_DESCRIBE_PARM_CONSTANT_VALUE 以获取常量参数的值。当表 UDF 确定了属性值可用时，udf_rg_2 将会把 EXTFNAPIV4_DESCRIBE_PARM_TABLE_NUM_ROWS 和 EXTFNAPIV4_DESCRIBE_COL_DISTINCT_VALUES 设置为获取的值。

另请参见

• udf_rg_3 （第 107 页）

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

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