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:

以下官方手册为ASE 15.7 ESD#2中文版：

1. 新增功能公告 适用于 Windows、Linux 和 UNIX 的 Open Server 15.7 和 SDK 15.7
   
2. 新增功能摘要
   
3. 新增功能指南
   
4. ASE 15.7 发行公告
   
5. 配置指南（windows）
   
6. 安装指南（windows）
   
7. 参考手册：构件块
   
8. 参考手册：命令
   
9. 参考手册：过程
   
10. 参考手册：表
    
11. Transact-SQL® 用户指南
    
12. 系统管理指南，卷 1
    
13. 系统管理指南，卷 2
    
14. 性能和调优系列：基础知识
    
15. 性能和调优系列：锁定和并发控制
    
16. 性能和调优系列：监控表
    
17. 性能和调优系列：物理数据库调优
    
18. 性能和调优系列：查询处理和抽象计划
    
19. 性能和调优系列：使用 sp_sysmon 监控 Adaptive Server
    
20. 性能和调优系列：利用统计分析改进性能
    
21. 程序员参考 jConnect for JDBC 7.0.7
    
22. Adaptive Server Enterprise 中的 Java
    
23. 组件集成服务用户指南
    
24. Ribo 用户指南
    
25. 内存数据库用户指南
    
26. Sybase Control Center for Adaptive Server® Enterprise
    
27. 安全性管理指南
    
28. 实用程序指南
    

 

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

作为存储过程参数的大对象 ‌

Open Client 和 Open Server 15.7 支持将 text、 unitext 和 image 作为存储过 程的输入参数以及动态 SQL 语句的参数。

为了便于针对此功能的使用开展登录协商，已经新增了两种连接功能：

• CS_RPCPARAM_LOB – 客户端应用程序向服务器发送此请求功 能，从而确定大对象 (LOB) 数据类型能否作为存储过程的输入参 数。如果服务器无法支持此功能，则会在初次登录协商中清除此功 能位。如果您尝试向这种服务器发送 LOB 参数，则会发生错误。

• CS_RPCPARAM_NOLOB – 客户端应用程序发送此响应功能，以 请求服务器拒绝将 LOB 数据作为参数发送。此功能在缺省情况下 处于打开状态。

将少量 LOB 数据作为参数发送

将少量 LOB 数据作为存储过程的输入参数或预准备 SQL 语句的参数发 送与发送非 LOB 参数相同。

要发送少量 LOB 数据，请使用 ct_param() 或 ct_setparam() 为命令和数据 分配内存并将它们直接发送到服务器。

当使用 text、 unitext 或 image 参数时，必须设置 CS_DATAFMT 结构的 maxlength 字段。maxlength 值指示是一次将所有 LOB 数据发送到服务器 还是通过数据流将其传输到服务器。如果 maxlength 大于零，将会在一 个块中发送所有 LOB 数据。如果 maxlength 设置为 CS_UNUSED，则会 按数据流发送 LOB 数据，即使用一组 ct_send_data() 调用成块发送数 据。块大小为零表示数据流结束。

示例 1 将少量 LOB 数据作为存储过程的输入参数发送：

CS_TEXT textvar[50]; CS_DATAFMT paramfmt; CS_INT datalen; CS_SMALLINT ind;

...

ct_command(cmd, CS_RPC_CMD, ...)

/*

** Clear and setup the CS_DATAFMT structure, then pass

** each of the parameters for the RPC.

*/

memset(&paramfmt, 0, sizeof(paramfmt));

/*

** First parameter, an integer.

*/

strcpy(paramfmt.name, "@intparam"); paramfmt.namelen = CS_NULLTERM; paramfmt.datatype = CS_INT_TYPE; paramfmt.maxlength = CS_UNUSED; paramfmt.status = CS_INPUTVALUE; paramfmt.locale = NULL;

ct_param(cmd, &paramfmt, (CS_VOID *)&intvar, sizeof(CS_INT), ind))

/*

** Second parameter, a (small) text parameter.

*/

strcpy((CS_CHAR *)textvar, "The Open Client and Open

Server products both include Bulk-Library and CS-Library.°±);

datalen = sizeof(textvar); strcpy(paramfmt.name, "@textparam"); paramfmt.namelen = CS_NULLTERM; paramfmt.datatype = CS_TEXT_TYPE; paramfmt.maxlength = EX_MYMAXTEXTLEN; paramfmt.status = CS_INPUTVALUE; paramfmt.locale = NULL;

ct_setparam(cmd, &paramfmt, (CS_VOID *)&textvar,

&datalen, &ind);

ct_send(cmd); ct_results(cmd, &res_type);

...

示例 2 使用预准备语句发送少量 LOB 数据：

/*

** Prepare the sql statement.

*/

sprintf(statement, "select title_id from mybooks where title like (?) ");

/*

** Send the prepared statement to the server

*/

ct_dynamic(cmd, CS_PREPARE, "my_dyn_stmt", CS_NULLTERM, statement, CS_NULLTERM);

ct_send(cmd); handle_results(cmd);

/*

** Prompt user to provide a value for title

*/

printf("Enter title id value - enter an X if you wish to stop:\n");

while (toupper(title[0]) != 'X')

{

printf("Retrieve detail record for title:?"); fgets(mytexttitle, 50, stdin);

/*

** Execute the dynamic statement.

*/

ct_dynamic(cmd, CS_EXECUTE, "my_dyn_stmt", CS_NULLTERM, NULL, CS_UNUSED);

/*

** Define the input parameter

*/

memset(&data_format, 0, sizeof(data_format)); data_format.status = CS_INPUTVALUE; data_format.namelen = CS_NULLTERM ; data_format.datatype = CS_TEXT_TYPE; data_format.format = CS_FMT_NULLTERM; data_format.maxlength = EX_MYMAXTEXTLEN; ct_setparam(cmd, &data_format,

(CS_VOID *)mytexttitle, &datalen, &ind);

ct_send(cmd); handle_results(cmd);

...

}

将大量 LOB 数据作为参数发送

大量 LOB 数据是通过数据流发送到服务器的，以便更好地管理资源。 在循环中使用 ct_send_data() 可将数据成块发送到服务器。

若要成块发送 LOB 数据参数，请使用以下设置定义该参数：

• 将 CS_DATAFMT 结构的 datatype 字段设置为 CS_TEXT_TYPE、 CS_UNITEXT_TYPE 或 CS_IMAGE_TYPE。

• 将 CS_DATAFMT 结构的 maxlength 字段设置为 CS_UNUSED。

• 将 ct_param() 函数的 *data 指针参数设置为 NULL。

• 将 ct_param() 函数的 datalen 参数设置为 0。

示例 1 成块发送大 LOB 数据参数：

#define BUFSIZE 2048

int fp;

char sendbuf[BUFSIZE]

/*

** Clear and setup the CS_DATAFMT structure, then pass

** each of the parameters for the RPC.

*/

memset(&paramfmt, 0, sizeof(paramfmt)); strcpy(paramfmt.name, "@intparam"); paramfmt.namelen = CS_NULLTERM; paramfmt.datatype = CS_INT_TYPE; paramfmt.maxlength = CS_UNUSED; paramfmt.status = CS_INPUTVALUE; paramfmt.locale = NULL;

ct_param(cmd, &paramfmt, (CS_VOID *)&intvar, sizeof(CS_INT), 0))

/*

** Text parameter, sent as a BLOB.

*/

strcpy(paramfmt.name, "@textparam"); paramfmt.namelen = CS_NULLTERM; paramfmt.datatype = CS_TEXT_TYPE; paramfmt.maxlength = CS_UNUSED; paramfmt.status = CS_INPUTVALUE; paramfmt.locale = NULL;

/*

** Although the actual data will not be sent here, we

** must invoke ct_setparam() for this parameter to send

** the parameter format (paramfmt) information to the

** server, prior to sending all parameter data.

** Set *data to NULL and datalen = 0, to indicate that

** the length of text data is unknown and we want to

** send it in chunks to the server with ct_send_data().

*/

ct_setparam(cmd, &paramfmt, NULL, 0, 0);

/*

** Another LOB parameter (image), sent in chunks with

** ct_send_data()

*/

strcpy(paramfmt.name, "@textparam"); paramfmt.namelen = CS_NULLTERM; paramfmt.datatype = CS_IMAGE_TYPE; paramfmt.maxlength = CS_UNUSED; paramfmt.status = CS_INPUTVALUE; paramfmt.locale = NULL;

/*

** Just like the previous parameter, invoke

** ct_setparam() for this parameter to send the

** parameter format.

*/

ct_setparam(cmd, &paramfmt, NULL, 0, 0);

/*

** Repeat this sequence of filling paramfmt and calling

** ct_param() for any subsequent parameter that needs

** to be sent before finally sending the data chunks for

** the LOB type parameters.

*/

strcpy(paramfmt.name, "@any_otherparam"); paramfmt.namelen = CS_NULLTERM; paramfmt.datatype = CS_MONEY_TYPE;

...

/*

** Send the first LOB (text) parameter in chunks of

** 'BUFSIZE' to the server.We must end with a 0 bytes

** write to indicate the end of the current parameter.

*/

fp = open("huge_text_file", O_RDWR, 0666);

do

{

num_read = read(fp, sendbuf, BUFSIZE); ct_send_data(cmd, (CS_VOID *)sendbuf, num_read);

} while (num_read != 0);

/*

** Repeat the ct_send_data() loop for the next LOB

** parameter.

** Send the image parameter in chunks of 'BUFSIZE'

** to the server as well and end with a 0 bytes write

** to indicate the end of the current parameter.

*/

fp = open("large_image_file", O_RDWR, 0666); do

{

num_read = read(fp, sendbuf, BUFSIZE); ct_send_data(cmd, (CS_VOID *)sendbuf, num_read);

} while (num_read != 0);

/*

** Ensure that all the data is flushed to the server

*/ ct_send(cmd);

示例 2 使用预准备 SQL 语句发送 LOB 数据：

/*

** Prepare the sql statement.

*/

sprintf(statement, "select title_id from mybooks where title like (?) ");

/*

** Send the prepared statement to the server

*/

ct_dynamic(cmd, CS_PREPARE, "mydyn_stmt", CS_NULLTERM, statement, CS_NULLTERM);

ct_send(cmd); handle_results();

/*

** Promt user to provide a value for title

*/

printf("Enter title id value - enter an X if you wish to stop:\n");

while (toupper(myblobtitle[0]) != 'X')

{

printf("Retrieve detail record for title:?"); fgets(myblobtitle, 50, stdin);

/*

** Execute the dynamic statement.

*/

ct_dynamic(cmd, CS_PREPARE, "my_dyn_stmt", CS_NULLTERM, statement, CS_NULLTERM);

/*

** Define the input parameter, a TEXT type that we want to send in chunks to the server.

*/

memset(&data_format, 0, sizeof(data_format)) ; data_format.namelen = CS_NULLTERM ; data_format.datatype = CS_TEXT_TYPE; data_format.maxlength = CS_UNUSED; data_format.status = CS_INPUTVALUE; ct_setparam(cmd, &data_format, NULL, 0, 0);

/*

** Send the 'myblobtitle' data in chunks of

** 'CHUNKSIZE' to the server with ct_send_data() and

** end with 0 bytes to indicate the end of data for

** this parameter.This is just an example to show

** how chunks can be sent.(myblobtitle[] is used as

** a simple example.This could also be replaced by

** large file which would be read in chunks from disk

** for example).

*/

bytesleft = strlen(myblobtitle); bufp = myblobtitle;

do

{

sendbytes = min(bytesleft, CHUNKSIZE); ct_send_data(cmd, (CS_VOID *)bufp, sendbytes); bufp += bufp + sendbytes;

bytesleft -= sendbytes;

} while (bytesleft > 0)

/*

** End with 0 bytes to indicate the end of current data.

*/

ct_send_data(cmd, (CS_VOID *)bufp, 0);

/*

** Insure that all the data is sent to the server.

*/ ct_send(cmd);

handle_results(cmd)

...

}

/*

** Deallocate the prepared statement and finish up.

*/

ct_dynamic(cmd, CS_DEALLOC, "my_dyn_stmt", CS_NULLTERM, NULL, CS_UNUSED);

ct_send(cmd); handle_results(cmd);

在 Open Server 中检索 LOB 参数

Open Server 可以使用 srv_xferdata 一次检索全部 LOB 参数数据，也可以 使用新的 srv_get_data 例程成块检索 LOB 参数数据。当参数长度设置为 CS_UNUSED 时，Open Server 成块检索 LOB 参数。请参见 第 60 页上的 “ srv_get_data ”。

示例 检索 LOB 参数的说明：

/*

** Retrieve the description of the parameters coming

** from client

*/

for (paramnum = 1; paramnum <= numparams; paramnum++)

{

/*

** Get a description of the parameter.

*/

ret= srv_descfmt(spp, CS_GET, SRV_RPCDATA, paramnum, &(paramfmtp[paramnum - 1]));

/*

** Allocate space for the parameters and bind the

** data.

*/

if (paramfmtp[paramnum-1].maxlength >= 0)

{

if (paramfmtp[paramnum-1].maxlength > 0)

{

data[paramnum-1] = calloc(1, paramfmtp[paramnum-1].maxlength);

}

else

{

ind[paramnum-1] = CS_NULLDATA;

}

}

else

{

/*

** Allocate a large size buffer for BLOB data

** (which length is unknown yet)

*/

blobbuf[blobnum] = malloc(BUFSIZE); blobnum++;

}

srv_bind(spp, CS_GET, SRV_RPCDATA, paramnum,

&(paramfmtp[paramnum-1]), data[paramnum-1],

&(len[paramnum-1]), &(ind[paramnum-1]))

/*

** For every LOB parameter, call srv_get_data() in

** a loop as long as it succeeds

/*

for (i = 0; i < blobnum ; i++)

{

bufp = blobbuf[i]; bloblen[i] = 0;

do

{

ret = srv_get_data(spp, bufp, BUFSIZE,

&outlen); bufp += outlen;

bloblen[i] += outlen;

} while (ret == CS_SUCCEED);

/*

** Check for the correct return code

*/

if (ret != CS_END_DATA)

{

return CS_FAIL;

}

}

/*

** And receive remaining client data srv_xferdata()

*/

ret = srv_xferdata(spp, CS_GET, SRV_RPCDATA);

}

srv_get_data

成块从客户端读取 text、 unitext 或 image 参数流。

语法 CS_RETCODE srv_get_data(spp, bp, buflen, outlenp)

SRV_PROC *spp; CS_BYTE *bp; CS_INT buflen; CS_INT *outlenp;

参数 • spp – 指向内部线程控制结构的指针。

• bp – 指向存储客户端数据的缓冲区的指针。

• buflen – *bp 指针的大小。它表示每块中传输的字节数。

• outlenp – 输出参数 outlenp 中包含读入 *bp 缓冲区的字节数。

返回值 • CS_SUCCEED – srv_get_data() 已成功运行，更多数据待处理。

• CS_FAIL – 例程失败。

• CS_END_DATA – srv_get_data() 已读取完整个 text、unitext 或 image

参数。

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