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

 

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

为 ESP 创建函数‌ ‌

对实现 ESP 的函数内容没有限制。唯一的要求是要以过程化编程语 言编写，该语言应能够：

• 调用 C 语言函数

• 处理 C 语言数据类型

• 与 Open Server API 相链接

但是，ESP 函数不应在 Windows 上调用 C 运行时信号例程。这会导 致 XP Server 失败，因为 Open Server 不支持 Windows 上的信号处理。

通过使用 Open Client API， ESP 函数可向 Adaptive Server （可以是 最初调用该函数的 Adaptive Server，也可以是其它 Adaptive Server） 发送请求。

用于 ESP 开发的文件

若要使用 Open Server 库进行开发，必须首先购买一个 Open Server 许可证。 ESP 开发所需的头文件在 $SYBASE/$SYBASE_OCS/include 中。为了能在源文件中找到这些文件，应在源代码中包含以下内容：

• ospublic.h

• oserror.h

Open Server 库在 $SYBASE/$SYBASE_OCS/lib 中。示例程序的源代 码 （如 第 536 页的 “ ESP 函数示例”所示）在

$SYBASE/$SYBASE_ASE/sample/esp 中。

Open Server 数据结构

以下数据结构可能对编写 ESP 函数非常有用：

• SRV_PROC — 所有 ESP 函数都被编码为能够接受单个参数，即 指向 SRV_PROC 结构的指针。SRV_PROC 结构在函数及其调用 进程之间传递信息。 ESP 开发人员无法直接处理此结构。

ESP 函数将 SRV_PROC 指针传递到 Open Server 例程，该例程 获得参数类型和数据，并返回输出参数、状态代码和结果集。

• CS_SERVERMSG — 通过 srv_sendinfo 例程， Open Server 使用 CS_SERVERMSG 结构向客户端发送错误消息。有关 CS_SERVERMSG 的信息，请参见 《Open Server-Library/C 参考 手册》。

• CS_DATAFMT — Open Server 使用 CS_DATAFMT 结构来描述 数据值和程序变量。

Open Server 返回代码

Open Server 函数返回 CS_RETCODE 类型的代码。 ESP 函数最常见 的 CS_RETCODE 值有：

• CS_SUCCEED

• CS_FAIL

简单 ESP 函数概述

考虑到与 Open Server API 的相互作用，一个 ESP 函数应有以下基本 结构：

1 获得参数个数。

2 获得输入 / 输出参数值并将其绑定到局部变量。

3 使用输入参数值执行处理，并将结果存储到局部变量中。

4 用相应的值初始化所有输出参数，将其与局部变量绑定并传送 到客户端。

5 使用 srv_sendinfo 将返回行发送到客户端。

6 使用 srv_sendstatus 将状态发送到客户端。

7 使用 srv_senddone 通知客户端处理已完成。

8 如果有错误情况，可使用 srv_sendinfo 将错误消息发送到客户端。

有关 Open Server 例程的文档，请参见《Open Server Server-Library/C

参考手册》。

ESP 函数示例 ‌

/*

** xp_echo.c

**

** Description:

xp_echo.c 包括一个 ESP，它接收用户提供的输入参数并将其回应给 ESP 客户端，它调用 ESP。该示例包括 xp_message 函数 （该函数 发送消息和状态）和 xp_echo 函数 （该函数处理输入参数并执行回 应）。可以使用该示例作为建立自己的 ESP 函数的模板。源代码在

$SYBASE/$SYBASE_ASE/sample/esp 中。

** The following sample program is generic in

** nature.It echoes an input string which is

** passed as the first parameter to the xp_echo

** ESP. This string is retrieved into a buffer

** and then sent back (echoed) to the ESP client.

*/

#include <string.h>

#include <stdlib.h>

#include <malloc.h>

/* Required Open Server include files.*/

#include <ospublic.h>

#include <oserror.h>

/*

** Constant defining the length of the buffer that receives the

** input string.All of the Adaptive Server parameters related

** to ESP may not exceed 255 char long.

*/

#define ECHO_BUF_LEN 255

/*

** Function:

** xp_message

** Purpose:Sends information, status and completion of the

** command to the server.

** Input:

** SRV_PROC *

** char * a message string.

** Output:

** void

*/

void xp_message (

SRV_PROC *srvproc, /* Pointer to Open Server thread

control structure */

char *message_string /* Input message string */

)

{

/*

** Declare a variable that will contain information

** about the message being sent to the SQL client.

*/

CS_SERVERMSG *errmsgp;

/*

** A SRV_DONE_MORE instead of a SRV_DONE_FINAL must

** complete the result set of an Extended Stored

** Procedure.

*/

srv_senddone(srvproc, SRV_DONE_MORE, 0, 0); free(errmsgp);

}

/*

** Function:xp_echo

** Purpose:

** Given an input string, this string is echoed as an output

** string to the corresponding SQL (ESP) client.

** Input:

** SRV_PROC *

** Output

** SUCCESS or FAILURE

*/

CS_RETCODE xp_echo (

SRV_PROC *srvproc

)

{

CS_INT paramnum; /* number of parameters */ CS_CHAR echo_str_buf[ECHO_BUF_LEN + 1];

/* buffer to hold input string */ CS_RETCODE result = CS_SUCCEED;

CS_DATAFMT paramfmt; /* input/output param format */ CS_INT len; /* Length of input param */ CS_SMALLINT outlen;

/*

** Get number of input parameters.*/

*/

srv_numparams(srvproc, &paramnum);

/*

** Only one parameter is expected.*/

*/

if (paramnum != 1)

{

}

else

{

/*

** Send a usage error message.*/

*/

xp_message(srvproc, "Invalid number of parameters");

result = CS_FAIL;

/*

** Perform initializations.

*/

outlen = CS_GOODDATA; memset(&paramfmt, (CS_INT)0,

(CS_INT)sizeof(CS_DATAFMT));

/*

** We are receiving data through an ESP as the

** first parameter.So describe this expected

** parameter.

*/

if ((result == CS_SUCCEED) && srv_descfmt(srvproc, CS_GET

SRV_RPCDATA, 1, &paramfmt) != CS_SUCCEED)

{

result = CS_FAIL;

}

/*

** Describe and bind the buffer to receive the

** parameter.

*/

if ((result == CS_SUCCEED) && (srv_bind(srvproc, CS_GET, SRV_RPCDATA,

1, &paramfmt,(CS_BYTE *) echo_str_buf,

&len, &outlen) != CS_SUCCEED))

{

result = CS_FAIL;

}

/* Receive the expected data.*/ if ((result == CS_SUCCEED) &&

srv_xferdata(srvproc,CS_GET,SRV_RPCDATA)

!= CS_SUCCEED)

{

result = CS_FAIL;

} /*

** Now we have the input info and are ready to

** send the output info.

*/

if (result == CS_SUCCEED)

{

/*

** Perform initialization.

*/

if (len == 0)

outlen = CS_NULLDATA;

else

outlen = CS_GOODDATA;

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

strcpy(paramfmt.name, "xp_echo"); paramfmt.namelen = CS_NULLTERM; paramfmt.datatype = CS_CHAR_TYPE; paramfmt.format = CS_FMT_NULLTERM; paramfmt.maxlength = ECHO_BUF_LEN; paramfmt.locale = (CS_LOCALE *) NULL; paramfmt.status |= CS_CANBENULL;

/*

** Describe the data being sent.

*/

if ((result == CS_SUCCEED) && srv_descfmt(srvproc, CS_SET,

SRV_ROWDATA, 1, &paramfmt)

!= CS_SUCCEED)

{

result = CS_FAIL;

}

/*

** Describe and bind the buffer that

** contains the data to be sent.

*/

if ((result == CS_SUCCEED) && (srv_bind(srvproc, CS_SET, SRV_ROWDATA, 1,

&paramfmt, (CS_BYTE *) echo_str_buf, &len, &outlen)

!= CS_SUCCEED))

{

result = CS_FAIL;

}

/*

** Send the actual data.

*/

if ((result == CS_SUCCEED) && srv_xferdata(srvproc, CS_SET, SRV_ROWDATA)!= CS_SUCCEED)

{

result = CS_FAIL;

}

}

/*

** Indicate to the ESP client how the

** transaction was performed.

*/

if (result == CS_FAIL)

srv_sendstatus(srvproc, 1);

else

/*

srv_sendstatus(srvproc, 0);

** Send a count of the number of rows sent to

** the client.

*/ srv_senddone(srvproc,(SRV_DONE_COUNT |

SRV_DONE_MORE), 0, 1);

}

return result;

}

建立 DLL

可以在服务器平台上使用能生成所需 DLL 的任何编译器。 有关使用 Open Server API 编译和链接函数的一般信息，请参见

Open Client/Server Supplement （《Open Client/Server 补充说明》）。

DLL 的搜索顺序

Windows 按以下顺序搜索 DLL： 1 调用应用程序的目录

2 当前目录

3 系统目录 (SYSTEM32)

4 PATH 环境变量中所列目录

UNIX 按照在 LD_LIBRARY_PATH 环境变量 （在 Solaris 上）、 SHLIB_PATH （在 HP 上）或 LIBPATH （在 AIX 中）中所列的目录 顺序搜索库。

如果 XP Server 在搜索路径中未能找到 ESP 函数库，它将尝试从

Windows 的 $SYBASE/DLL 或其它平台的 $SYBASE/lib 中装载它。

不支持 DLL 的绝对路径名。

样本 makefile (UNIX)

#

下列 makefile，make.unix，用来为 UNIX 平台的 xp_echo 程序创建动 态链接共享库。它将生成一个文件，在 Solaris 上名为 examples.so， 在 HP 上名为 examples.sl。源代码在 $SYBASE/$SYBASE_ASE/sample/esp 中，您可对其进行修改以供自己使用。

若要使用此 makefile 建立示例库，请输入：

make -f make.unix

# This makefile creates a shared library.It needs the open

# server header

# files usually installed in $SYBASE/include directory.

# This make file can be used for generating the template ESPs.

# It references the following macros:

#

# PROGRAM is the name of the shared library you may want to create.PROGRAM

= example.so

BINARY = $(PROGRAM) EXAMPLEDLL = $(PROGRAM)

# Include path where ospublic.h etc reside.You may have them in

# the standard places like /usr/lib etc. INCLUDEPATH = $(SYBASE)/include

# Place where the shared library will be generated. DLLDIR = .

RM = /usr/bin/rm ECHO = echo

MODE = normal

# Directory where the source code is kept. SRCDIR = .

# Where the objects will be generated. OBJECTDIR = .

OBJS = xp_echo.o

CFLAGS = -I$(INCLUDEPATH)

LDFLAGS = $(GLDFLAGS) -Bdynamic

DLLLDFLAGS = -dy -G

#================================================================

$(EXAMPLEDLL) :$(OBJS)

-@$(RM) -f $(DLLDIR)/$(EXAMPLEDLL)

-@$(ECHO) "Loading $(EXAMPLEDLL)"

-@$(ECHO) " "

-@$(ECHO) " MODE: $(MODE)"

-@$(ECHO) " OBJS: $(OBJS)"

-@$(ECHO) " DEBUGOBJS: $(DEBUGOBJS)"

-@$(ECHO) " "

cd $(OBJECTDIR); \

ld -o $(DLLDIR)/$(EXAMPLEDLL) $(DEBUGOBJS) $(DLLLDFLAGS) $(OBJS)

-@$(ECHO) "$(EXAMPLEDLL) done"

exit 0

#================================================================

$(OBJS) :$(SRCDIR)/xp_echo.c cd $(SRCDIR); \

$(CC) $(CFLAGS) -o $(OBJECTDIR)/$(OBJS) -c xp_echo.c

样本定义文件

以下文件 xp_echo.def 必须与 xp_echo.mak 处于相同的目录下。它列 出了在 EXPORTS 部分中将被用作 ESP 函数的所有函数。

LIBRARY examples

CODE PRELOAD MOVEABLE DISCARDABLE DATA PRELOAD SINGLE

EXPORTS

xp_echo . 1

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