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 描述符结构由多个部分组成。

• typedef struct a_v3_extfn_aggregate – 库提供的集合 UDF 函数的元数据描述符。

• _start_extfn – 初始化函数的必需指针，其唯一参数是指向 a_v3_extfn_aggregate_context 的指针。通常用于分配某些结构并将其地址存储在 a_v3_extfn_aggregate_context 内的 _user_data 字段中。每 a_v3_extfn_aggregate_context 只能调用一次 _start_extfn。

void (*_start_extfn)(a_v3_extfn_aggregate_context *);

• _finish_extfn – 关闭函数的必需指针，其唯一参数是指向 a_v3_extfn_aggregate_context 的指针。通常用于释放地址存储在 a_v3_extfn_aggregate_context 中的 _user_data 字段内的某些结构。每 a_v3_extfn_aggregate_context 只能调用一次 _finish_extfn。

void (*_finish_extfn)(a_v3_extfn_aggregate_context *);

• _reset_extfn –“启动新组”函数的必需指针，其唯一参数是指向 a_v3_extfn_aggregate_context 的指针。通常用于重置其地址存放在 a_v3_extfn_aggregate_context 中的 _user_data 字段内的结构中的某些值。

_reset_extfn 可重复调用。

void (*_reset_extfn)(a_v3_extfn_aggregate_context *);

• _next_value_extfn – 针对每组新输入参数值调用的必需函数指针。该函数不设置 集合结果。可通过 get_value 回调函数访问输入参数值，如有必要，可重复调用 get_piece 回调函数，但仅当 piece_len 小于 total_len 时才需执行该操作。

void (*_next_value_extfn)(a_v3_extfn_aggregate_context *cntxt, void *args_handle);

注意： get_piece 回调在第 3 版和第 4 版标量和集合 UDF 中都有效。对于第 4 版表 UDF 和 TPF，请改用 Blob (a_v4_extfn_blob) 和 Blob 输入流 (a_v4_extfn_blob_istream) 结构。

• _evaluate_extfn – 必需函数指针，调用它可返回生成的集合结果值。_evaluate_extfn

将通过 set_value 回调函数发送至服务器。

void (*_evaluate_extfn)(a_v3_extfn_aggregate_context *cntxt, void

*args_handle);

• _drop_value_extfn – 针对超出移动窗口构架的每个输入参数值集调用的可选函数 指针。不要使用此函数设置集合结果。可通过 get_value 回调函数访问输入参数 值，如有必要，可重复调用 get_piece 回调函数，但仅当 piece_len 小于 total_len 时 才需访问输入参数值。在下列情况下，请将 _drop_value_extfn 设置为空指针：

• 集合不能与窗口构架一起使用。

• 集合在某种程度上不可逆。

• 用户对最佳性能没有兴趣。

注意： get_piece 回调在第 3 版和第 4 版标量和集合 UDF 中都有效。对于第 4 版表 UDF 和 TPF，请改用 Blob (a_v4_extfn_blob) 和 Blob 输入流 (a_v4_extfn_blob_istream) 结构。

如果未提供该函数，且用户已经指定移动窗口，则可在每次窗口构架移动时调用 重置函数，并通过调用 next_value 函数包含该窗口内的现有各行。最后调用求值 函数。 但是，如果已提供该函数，则每次窗口构架移动时，均将针对超出窗口架构的各 行调用 drop_value 函数，然后针对刚刚添加到窗口构架中的各行调用 next_value 函数。最后，调用求值函数以生成集合结果。

void (*_drop_value_extfn)(a_v3_extfn_aggregate_context *cntxt, void *args_handle);

• _evaluate_cumulative_extfn – 针对每组新输入参数值调用的可选函数指针。如果 已提供该函数，且在跨越从 UNBOUNDED PRECEDING 到 CURRENT ROW 的行 式窗口构架内使用，则可调用此函数，而无需调用 next_value 函数以及紧邻其后 调用的求值函数。_evaluate_cumulative_extfn 必须通过 set_value 回调设置集合结 果。可通过 get_value 回调函数访问输入参数值，如有必要，可重复调用 get_piece 回调函数，但仅当 piece_len 小于 total_len 时才需执行该操作。

void (*_evaluate_cumulative_extfn)(a_v3_extfn_aggregate_context

*cntxt, void *args_handle);

注意： get_piece 回调在第 3 版和第 4 版标量和集合 UDF 中都有效。对于第 4 版表 UDF 和 TPF，请改用 Blob (a_v4_extfn_blob) 和 Blob 输入流 (a_v4_extfn_blob_istream) 结构。

• _next_subaggregate_extfn – 可选回调函数指针，通过

_evaluate_superaggregate_extfn 函数（在某些用法中还使用

_drop_subaggregate_extfn 函数），支持通过并行和部分结果集合来优化集合的某 些用法。

某些集合用作简单集合（换言之即带有 OVER 子句的非 OLAP 样式集合）时，可 以通过首先生成一组中间集合结果来分区，其中每个中间结果均为来自一个不连 接的输入行子集的计算结果。此类可分区集合的示例包括：

• SUM，其中，可通过针对每个不连接的输入行子集执行 SUM，然后在 sub-SUM

上执行 SUM，由此计算得出最终 SUM；以及

• COUNT(*)，其中，可通过针对每个不连接的输入行子集执行 COUNT，然后 在每个分区的 COUNT 上执行 SUM，由此计算得出最终 COUNT。

当集合满足上述条件时，服务器可以选择并行执行该集合的计算。对于集合 UDF， 仅当已提供 _next_subaggregate_extfn 回调和 _evaluate_superaggregate_extfn 回调 时，才能应用该优化。此用法模式不需要使用 _drop_subaggregate_extfn。 同样，如果能一同使用集合和基于 RANGE 的 OVER 子句，则

_next_subaggregate_extfn、_drop_subaggregate_extfn 和

_evaluate_superaggregate_extfn) 函数均由集合 UDF 的实现提供时可以进行优化。

_next_subaggregate_extfn 不设置集合最终结果，而且按照定义，它将使用与集合 UDF 的返回值完全相同的数据类型的唯一输入参数值。可通过 get_value 回调函数 访问子集输入值，如有必要，可重复调用 get_piece 回调函数，但仅当 piece_len 小于 total_len 时才需执行该操作。

注意： get_piece 回调在第 3 版和第 4 版标量和集合 UDF 中都有效。对于第 4 版表 UDF 和 TPF，请改用 Blob (a_v4_extfn_blob) 和 Blob 输入流 (a_v4_extfn_blob_istream) 结构。

子集合与超级集合之间不可进行直接通信；所有此类通信将由服务器处理。子集 合和超级集合不共用上下文结构。而将各个子集合完全视为非分区集合。独立超 级集合将看到类似如下的调用模式：

_start_extfn

_reset_extfn

_next_subaggregate_extfn (repeated 0 to N times)

_evaluate_superaggregate_extfn

_finish_extfn

void (*_next_subaggregate_extfn)(a_v3_extfn_aggregate_context

*cntxt, void *args_handle);

• _drop_subaggregate_extfn – 可选回调函数指针，与 _next_subaggregate_extfn 和

_evaluate_superaggregate_extfn 一起使用，支持通过部分集合来优化使用基于 RANGE 的 OVER 子句时的某些用法。每当共享通用排序键值的一组行全部超出 移动窗口时即调用 _drop_subaggregate_extfn。仅当所有三个函数均由 UDF 提供时 才能应用此优化。

void (*_drop_subaggregate_extfn)(a_v3_extfn_aggregate_context

*cntxt, void *args_handle);

• _evaluate_superaggregate_extfn – 可选回调函数指针，与 _next_subaggregate_extfn

（有时也可与 _drop_subaggregate_extfn）一起使用时，支持通过并行运行来优化某 些用法。

将要返回分区集合结果时，可按如上所述调用 _evaluate_superaggregate_extfn。通 过使用 a_v3_extfn_aggregate_context 结构中的 set_value 回调函数将结果值发送至 服务器：

void (*_evaluate_superaggregate_extfn) (a_v3_extfn_aggregate_context *cntxt, void *args_handle);

• NULL fields – 将以下字段初始化为 NULL：

void * reserved1_must_be_null; void * reserved2_must_be_null; void * reserved3_must_be_null; void * reserved4_must_be_null; void * reserved5_must_be_null;

• Status indicator bit field – 包含允许引擎优化用于处理集合的算法的指示符的位字 段。

a_sql_uint32 indicators;

• _calculation_context_size – 服务器为每个 UDF 计算上下文分配的字节数。服务 器可以在查询处理过程中分配多个计算上下文。

a_v3_extfn_aggregate_context_user_calculation_context 中可使用当前活动组的上下 文。

short _calculation_context_size;

• _calculation_context_alignment – 指定用户计算上下文的对齐要求。有效值包括

1、2、4 或 8。

short _calculation_context_alignment;

• External memory requirments – 下列字段允许优化程序考虑外部分配的内存的开 销。有了这些值，优化程序就能考虑可以执行多个并发计算的程度。这些计数器 应当基于典型的行或组来估计，并且不应为最大值。如果没有 UDF 分配的内存， 则将这些字段设为零。

• external_bytes_per_group – 分配到每个集合开头的组的内存量。通常为所有在 reset() 调用期间分配的内存。

• external_bytes_per_row — UDF 为组中每一行分配的内存量。通常为 next_value()

期间所分配的内存量。

double external_bytes_per_group;

double external_bytes_per_row;

• Reserved fields for future use – 初始化下列字段：

a_sql_uint64 reserved6_must_be_null; a_sql_uint64 reserved7_must_be_null; a_sql_uint64 reserved8_must_be_null; a_sql_uint64 reserved9_must_be_null; a_sql_uint64 reserved10_must_be_null;

• Closing syntax — 用下列语法完成描述符：

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

} a_extfn_aggregate;

另请参见

• Blob (a_v4_extfn_blob) （第 185 页）

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

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