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 上下文结构 a_v3_extfn_aggregate_context 具有和标量 UDF 上下文结构完全 相同的回调函数指针集。

此外，与标量 UDF 上下文类似，它具有读/写 _user_data 指针，还具有一组描述当前 使用情况和位置的只读数据字段。一个语句中的每个 UDF 唯一实例都具有一个集合 UDF 上下文实例，它在调用时传递到集合 UDF 描述符结构中指定的每一个函数。集 合上下文结构定义为：

• typedef struct a_v3_extfn_aggregate_context — 为在查询中引用的外部函数的每一 个实例创建一个上下文。如果用在查询内并行的子树中，则并行子树会具有单独 的上下文。

• Callbacks available via the context — 回调例程的常见参数包括：

• arg_handle — 由服务器提供的函数实例和参数的句柄。

• arg_num — 参数数目。返回值为 0 到 N。

• data — 参数数据的指针。

上下文必须在 get_piece 之前调用 get_value，但仅在 piece_len 小于 total_len 时才 需要调用 get_piece。

short (SQL_CALLBACK *get_value)( void * arg_handle,

a_sql_uint32 arg_num, an_extfn_value *value

);

short (SQL_CALLBACK *get_piece)( void * arg_handle, a_sql_uint32 arg_num, an_extfn_value *value, a_sql_uint32 offset

);

• Determining whether an argument is a constant – UDF 可以询问给定的参数是否为 常量。这非常有用。例如，允许工作在第一次调用 _next_value 函数时执行一次， 而不是在每次调用 _next_value 函数时执行。

short (SQL_CALLBACK *get_value_is_constant)( void * arg_handle,

a_sql_uint32 arg_num, a_sql_uint32 * value_is_constant

);

• Returning a null value — 要返回空值，可将 an_extfn_value 中的“data”设为 NULL。调用 set_value 时会忽略 total_len 字段。如果 append 为 FALSE，则提供的 数据会变为参数的值；否则，该数据会附加到参数的当前值中。预期的情形为， 在使用 append=TRUE 为一个参数调用 set_value 前，先使用 append=FALSE 为该 参数进行调用。对于固定长度的数据类型（换句话说，所有数字数据类型），会 忽略 append 字段。

short (SQL_CALLBACK *set_value)( void * arg_handle,

an_extfn_value *value, short append

);

• Determining whether the statement was interrupted – 如果 UDF 入口点执行工作的 时间较长（许多秒），则可能的话，它应当每秒或每两秒调用一次 get_is_cancelled 回调，以查看用户是否中断了当前的语句。如果语句已被中断，则返回非零值， 并且 UDF 入口点应立即执行。最后，调用 _finish_extfn 函数执行任何必要的清 理，但随后不再调用任何其它的 UDF 入口点。

a_sql_uint32 (SQL_CALLBACK *get_is_cancelled) (a_v3_extfn_aggregate_context * cntxt);

• Sending error messages – 如果 UDF 入口点遇到某些错误，导致向用户发送回错 误消息和当前语句关闭，则应调用 set_error 回调例程。通过 set_error 可回退当前 语句；用户将看到外部 UDF 错误：<error_desc_string>，并且 SQLCODE 为 <error_number> 的取非形式。调用 set_error 之后，UDF 入口点会立即执行返 回。最后，将调用 _finish_extfn 以执行所有必要清除，但随后不会调用其它 UDF 入口点。

void (SQL_CALLBACK *set_error)( a_v3_extfn_aggregate_context * cntxt,

a_sql_uint32 error_number,

// use error_number values >17000 & <100000 const char * error_desc_string

);

• Writing messages to the message log — 长度超过 255 字节的消息会被截断。

void (SQL_CALLBACK *log_message)( const char *msg,

short msg_length

);

• Converting one data type to another – 对于输入：

• an_extfn_value.data – 输入数据指针。

• an_extfn_value.total_len – 输入数据的长度。

• an_extfn_value.type — 输入的 DT_ 数据类型。 对于输出：

• an_extfn_value.data — UDF 提供的输出数据指针。

• an_extfn_value.piece_len – 输出数据的最大长度。

• an_extfn_value.total_len – 服务器设置的转换输出长度。

• an_extfn_value.type — 所需输出的 DT_ 数据类型。

short (SQL_CALLBACK *convert_value)( an_extfn_value *input,

an_extfn_value *output

);

• Fields reserved for future use — 这些留待将来使用：

void * reserved1; void * reserved2; void * reserved3; void * reserved4; void * reserved5;

• Data available from the context — 此数据指针可通过任何用法使用外部例程所需的 任何上下文数据填充。UDF 会分配和释放此内存。每个语句都有处于活动状态的 单个 _user_data 实例。不要将此内存用于中间结果值。

void * _user_data;

• Currently active calculation context — UDF 应使用此内存位置存储计算集合的中间 值。此内存由服务器根据 a_v3_extfn_aggregate 中请求的大小进行分配。中间计算 必须存储在此内存中，因为引擎可能会对一个以上的组执行并发计算。在每个 UDF 入口点之前，服务器会确保正确的上下文数据处于活动状态。

void * _user_calculation_context;

• Other available aggregate information – 在包括 start_extfn 在内的所有外部函数入 口点上均可用。零表示未知或不适用的值。每个分区或每组中估计的平均行数。

• a_sql_uint64 _max_rows_in_frame; — 计算窗口构架中定义的最大行数。对于基 于范围的窗口，这表示唯一值。零表示未知或不适用的值。

• a_sql_uint64 _estimated_rows_per_partition; – 显示每个分区或每组中估计的平 均行数。0 表示未知或不适用的值。

• a_sql_uint32 _is_used_as_a_superaggregate; – 标识此实例为普通集合还是超 级集合。如果实例为普通集合，则返回的结果为 0。

• Determining window specifications — 查询上存在窗口时的窗口规范：

• a_sql_uint32 _is_window_used; — 确定语句是否为窗口化的。

• a_sql_uint32 _window_has_unbounded_preceding; – 返回值为 0，表示窗口没 有未绑定的之前行。

• a_sql_uint32 _window_contains_current_row; – 返回值为 0，表示窗口不包含 当前行。

• a_sql_uint32 _window_is_range_based; – 如果返回码为 1，则窗口基于范围。 如果返回码为 0，则窗口基于行。

• Available at reset_extfn() calls – 返回当前分区中的实际行数；或者，若为非窗口 集合，则返回 0。

a_sql_uint64 _num_rows_in_partition;

• Available only at evaluate_extfn() calls for windowed aggregates — 分区中当前求值 的行号（从 1 开始）。这在未受限制窗口的求值阶段很有用。

a_sql_uint64 _result_row_from_start_of_partition;

• Closing syntax — 用下列语法完成上下文：

//---------- For Server Internal Use Only ---------- void * _for_server_internal_use;

} a_v3_extfn_aggregate_context;

集合外部函数环境：a_v3_extfn_aggregate_context

另请参见

• Blob (a_v4_extfn_blob) （第 185 页）

• Blob 输入流 (a_v4_extfn_blob_istream) （第 188 页）

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