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

 

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

SQLJ 存储过程 ‌ ‌

使用 Java-SQL 功能，可在数据库中安装 Java 类，然后从客户端或 SQL 系统内部调用这些方法。也可以使用另一种方式调用 Java 静态（类）方 法，即，以 SQLJ 存储过程的形式。‌

SQLJ 存储过程：

• 可将结果集和/或输出参数返回到客户端

• 它在执行时的行为与 Transact-SQL 存储过程完全一样

• 可以使用 ODBC、 isql 或 JDBC 从客户端调用

• 可从服务器内的其它存储过程或本机 Adaptive Server JDBC 调用

最终用户不必知道被调用的过程是 SQLJ 存储过程还是 Transact-SQL 存 储过程。它们的调用方式均相同。

create procedure 的 SQLJ 语法为：

create procedure [owner.]sql_procedure_name ([[ in | out | inout ] sql_parameter_name

sql_datatype [( length) | (precision[, scale])]

[, [ in | out | inout ] sql_parameter_name sql_datatype [( length) |

(precision[, scale]) ]]

...])

[modifies sql data]

[dynamic result sets integer] [deterministic | not deterministic] language java

parameter style java

external name 'java_method_name [([java_datatype[, java_datatype

...]])]'

注释 为了符合 ANSI 标准，SQLJ create procedure 命令语法不同于创建

Sybase Transact-SQL 存储过程时使用的语法。

有关此命令中各关键字和选项的详细说明，请参见《参考手册：命令》。 创建 SQLJ 存储过程时：

• SQL 过程签名是每个过程参数的 SQL 数据类型 sql_datatype。

• 创建 SQLJ 存储过程时，参数名前不要包括符号 @。这样做是为了 符合 ANSI 标准。

Sybase 会在内部添加 @ 符号以支持参数名绑定。使用 sp_help 输出 有关 SQLJ 存储过程的信息时您将看到 @ 符号。

• 在创建 SQLJ 存储过程时，必须包括将 sql_parameter_name 和

sql_datatype 信息括起来的小括号 （即使不包含这些信息）。

例如：

create procedure sqlj_sproc () language java

parameter style java

external name "SQLJExamples.method1" ‌

• 您可以包括 modifies sql data 关键字以表示该方法将调用 SQL 操作并 读取和修改 SQL 数据。该值为缺省值。

• 如果要将结果集返回到调用环境，必须包括 dynamic result sets 的

integer 选项。使用 integer 变量可指定期望结果集的最大数量。 ‌

• 可包括关键字 deterministic 或 not deterministic，以符合 SQLJ 标准。但

Adaptive Server 不使用此选项。 ‌

• 必须包括 language java parameter 和 style java 关键字，它们可告诉 Adaptive Server 外部例程是用 Java 编写的，传递到外部例程的参数 运行时约定是 Java 约定。

• external name 子句表示外部例程是用 Java 编写的，并标识 Java 方法、 类和包名称 （如果有的话）。

• Java 方法签名指定每个方法参数的 Java 数据类型 java_datatype。Java 方法签名是可选的。如果未指定， Adaptive Server 将从 SQL 过程签 名中推断一个。

Sybase 建议包括方法签名（像本练习处理所有数据类型转换一样）。 有关详细信息，请参见 第 106 页的 “映射 Java 和 SQL 数据类型 ” 。

• 使用 create procedure 可为同一 Java 方法定义不同的 SQL 名称，然后 以同样的方法使用它们。

修改 SQL 数据

可使用 SQLJ 存储过程修改数据库中的信息。 SQLJ 过程引用的方法必须 为下列之一：‌

• 一个无类型方法，或

• 具有 int 返回类型的方法 （包括 int 返回类型是 SQLJ 标准的 Sybase

扩展）。

编写 Java 方法 SQLJExamples.correctStates() 方法执行 SQL update 语句以更正州代码拼 写。输入参数指定了新旧拼写。 correctStates() 是无类型方法；不向调用 者返回值。

public static void correctStates(String oldSpelling, String newSpelling) throws SQLException {

Connection conn = null; PreparedStatement pstmt = null; try {

Class.forName("sybase.asejdbc.ASEDriver"); conn = DriverManager.getConnection

("jdbc:default:connection");

}

catch (Exception e) { System.err.println(e.getMessage() +

“:error in connection”);

}

try {

pstmt = conn.prepareStatement ("UPDATE sales_emps SET state = ? WHERE state = ?");

pstmt.set.String(1, newSpelling); pstmt.set.String(2, oldSpelling); pstmt.executeUpdate();

}

catch (SQLException e) { System.err.println(“SQLException: "+ e.getErrorCode() + e.getMessage());

}

return;

}

创建存储过程 在使用 SQL 名称调用 Java 方法之前，必须使用 SQLJ create procedure 命 令为其创建 SQL 名称。 modifies sql data 子句是可选的。

create procedure correct_states(old char(20), not_old char(20))

modifies sql data

language java parameter style java external name

'SQLJExamples.correctStates (java.lang.String, java.lang.String)'

correct_states 过程的 SQL 过程签名为 char(20)、 char(20)。 Java 方法签名 为 java.lang.String , java.lang.String。

调用存储过程 执行 SQLJ 过程与执行 Transact-SQL 过程完全相同。在此示例中将从 isql

执行过程：

execute correct_states 'GEO', 'GA'

使用输入和输出参数

Java 方法不支持输出参数。但在 SQL 中包装 Java 方法时，可利用 Sybase SQLJ 功能，它允许对 SQLJ 存储过程使用输入、输出以及输入/输 出参数。

创建 SQLJ 过程时，将每个参数的模式分别标识为 in、 out 或 inout。

• 对于输入参数，请使用 in 关键字限定参数。 in 为缺省值；如果未输 入参数模式， Adaptive Server 将使用输入参数。

• 对于输出参数，使用 out 关键字。

• 对于可将值从引用的 Java 方法中传入和传出的参数，使用 inout 关 键字。

注释 仅使用 in 和 out 关键字创建 Transact-SQL 存储过程。out 关键字与 SQLJ inout 关键字相对应。有关详细信息，请参见 《参考手册：命令》 中的 create procedure 参考页。

若要创建定义输出参数的 SQLJ 存储过程，必须：

• 在创建 SQLJ 存储过程时，使用 out 或 inout 选项定义输出参数。

• 在 Java 方法中将这些参数声明为 Java 数组。 SQLJ 将数组作为方法 的输出参数值的容器。

例如，如果希望 Integer 参数向调用者返回值，则必须在方法中将参 数类型指定为 Integer[ ] （Integer 数组）。

out 或 inout 参数的数组对象是由系统隐式创建的。它具有单个元素。 在调用 Java 方法之前，输入值 （如果有的话）放在数组的第一个元 素 （仅有的）中。当 Java 方法返回时，第一个元素被删除并分配给 输出变量。通常，此元素将由调用方法分配新值。

以下示例使用 Java 方法 bestTwoEmps() 和引用该方法的存储过程 best2 说 明输出参数的使用。

编写 Java 方法 SQLJExamples.bestTwoEmps() 方法返回具有最高销售业绩记录的两名职员 的姓名、 ID 、所在区域和销售额。前八个参数是需要包含数组的输出参 数。第九个参数是输入参数，不需要数组。

public static void bestTwoEmps(String[] n1, String[] id1, int[] r1,

BigDecimal[] s1, String[] n2,

String[] id2, int[] r2, BigDecimal[] s2, int regionParm) throws SQLException {

n1[0] = "****";

id1[0] = ""; r1[0] = 0;

s1[0] = new BigDecimal(0): n2[0] = "****",

id2[0] = ""; r2[0] = 0;

s2[0] = new BigDecimal(0);

try {

Connection conn = DriverManager.getConnection ("jdbc:default:connection");

java.sql.PreparedStatement stmt = conn.prepareStatement("SELECT name, id,"

+ "region_of(state) as region, sales FROM"

+ "sales_emps WHERE"

+ "region_of(state)>? AND"

+ "sales IS NOT NULL ORDER BY sales DESC");

stmt.setInteger(1, regionParm); ResultSet r = stmt.executeQuery();

if(r.next()) {

n1[0] = r.getString("name");

id1[0] = r.getString("id");

r1[0] = r.getInt("region");

s1[0] = r.getBigDecimaL("sales");

}

else return;

if(r.next()) {

n2[0] = r.getString("name");

id2[0] = r.getString("id");

r2[0] = r.getInt("region");

s2[0] = r.getBigDecimal("sales");

}

else return;

}

catch (SQLException e) { System.err.println("SQLException: "+

e.getErrorCode() + e.getMessage());

}

}

创建 SQLJ 过程 为 bestTwoEmps 方法创建 SQL 名称。前八个参数是输出参数；第九个是 输入参数。

create procedure best2

(out n1 varchar(50), out id1 varchar(5), out s1 decimal(6,2), out r1 integer, out n2 varchar(50), out id2 varchar(50), out r2 integer, out s2 decimal(6,2),

in region integer) language java parameter style java external name

'SQLJExamples.bestTwoEmps (java.lang.String, java.lang.String, int, java.math.BigDecimal, java.lang.String, java.lang.String, int, java.math.BigDecimal, int)'

best2 的 SQL 过程签名为：varchar(20)、varchar(5)、decimal (6,2) 等。Java

方法签名为 String、 int、 BigDecimal 等等。

调用过程 在数据库中安装该方法且创建了引用该方法的 SQLJ 过程后，即可调用

SQLJ 过程。

在运行时， SQL 系统：

1 在调用 SQLJ 过程时，为 out 和 inout 参数创建必需的数组。

2 从 SQLJ 过程中返回时，将参数数组的内容复制到 out 和 inout 目标 变量中。

以下示例从 isql 调用 best2 过程。 region 输入参数的值指定区域编号。

declare @n1 varchar(50), @id1 varchar(5),

@s1 decimal (6,2), @r1 integer, @n2 varchar(50),

@id2 varchar(50), @r2 integer, @s2 decimal(6,2),

@region integer select @region = 3

execute best2 @n1 out, @id1 out, @s1 out, @r1 out,

@n2 out, @id2 out, @r2 out, @s2 out, @region

注释 Adaptive Server 调用 SQLJ 存储过程与其调用 Transact-SQL 存储 过程完全相同。因此，使用 isql 或任何其它非 Java 客户端时，必须在参 数名前加 @ 符号。

返回结果集

SQL 结果集是传递给调用环境的一系列 SQL 行。

Transact-SQL 存储过程返回一个或多个结果集时，这些结果集是过程调 用的隐式输出。即，它们不声明为显式参数或返回值。

Java 方法可以返回 Java 结果集对象，但它们作为显式声明的方法值执行 此操作。

若要从 Java 方法返回 SQL 风格的结果集，必须先将 Java 方法包装到 SQLJ 存储过程中。作为 SQLJ 存储过程调用方法时，结果集 （由 Java 方法作 为 Java 结果集对象返回）将由服务器转换为 SQL 结果集。

当编写作为 SQLJ 过程来调用并返回 SQL 风格的结果集的 Java 方法时， 必须为方法可返回的每个结果集的方法指定一个额外的参数。每个此类 参数都是 Java ResultSet 类的单个元素数组。

本节将介绍编写方法、创建 SQLJ 存储过程和调用方法的基本过程。有 关返回结果集的详细信息，请参见 第 107 页的“显式或隐式指定 Java 方 法签名 ”。

编写 Java 方法 以下方法 SQLJExamples.orderedEmps 可调用 SQL、包括 ResultSet 参数以 及使用 JDBC 调用以确保安全连接和打开语句。

public static void orderedEmps

(int regionParm, ResultSet[] rs) throws SQLException {

Connection conn = null; PreparedStatement pstmt = null;

try {

Class.forName ("sybase.asejdbc.ASEDriver");

Connection conn = DriverManager.getConnection ("jdbc:default:connection");

}

catch (Exception e) { System.err.println(e.getMessage()

+ ":error in connection");

}

try { java.sql.PreparedStatement

stmt = conn.prepareStatement ("SELECT name, region_of(state)" "as region, sales FROM sales_emps" "WHERE region_of(state) > ? AND" "sales IS NOT NULL"

"ORDER BY sales DESC");

stmt.setInt(1, regionParm); rs[0] = stmt.executeQuery(); return;

}

catch (SQLException e) System.err.println("SQLException:"

+ e.getErrorCode() + e.getMessage());

}

return;

}

orderedEmps 返回单个结果集。也可编写返回多个结果集的方法。对于每 个返回的结果集，必须：

• 在方法签名中包括单独的 ResultSet 数组参数。

• 创建每个结果集的 Statement 对象。

• 将所有结果集都分配到其 ResultSet 数组的第一个元素。

Adaptive Server 始终返回每个 Statement 对象的当前打开的 ResultSet 对 象。创建返回结果集的 Java 方法时：

• 创建要返回到客户端的每个结果集的 Statement 对象。

• 不要显式关闭 ResultSet 和 Statement 对象。 Adaptive Server 会自动将 其关闭。

注释 Adaptive Server 将确保受到影响的结果集已被处理并返回到客 户端后， ResultSet 和 Statement 才被碎片收集关闭。

• 如果结果集的某些行是通过调用 Java next() 方法读取的，则仅有剩余 的结果集行返回给客户端。

创建 SQLJ 存储过程 创建返回结果集的 SQLJ 存储过程时，必须指定最多可返回的结果集数。 在本示例中， ranked_emps 过程返回单个结果集。

create procedure ranked_emps(region integer) dynamic result sets 1

language java parameter style java

external name 'SQLJExamples.orderedEmps(int, ResultSet[]'

如果 ranked_emps 产生的结果集比 create procedure 指定的多，将显示警 告消息并且该过程只返回指定数量的结果集。按照规定， ranked_emps SQLJ 存储过程仅与一个 Java 方法匹配。

注释 当推断某一包括结果集的方法签名时，某些限制适用于方法重载。 有关详细信息，请参见 第 106 页的 “映射 Java 和 SQL 数据类型 ” 。

调用过程 在数据库中安装方法的类并创建引用该方法的 SQLJ 存储过程后，即可 调用该过程。可使用处理 SQL 结果集的任何机制编写调用。

例如，若要使用 JDBC 调用 ranked_emps 过程，请输入以下内容：

java.sql.CallableStatement stmt = conn.prepareCall("{call ranked_emps(?)}");

stmt.setInt(1,3);

ResultSet rs = stmt.executeQuery(); while (rs.next()) {

String name = rs.getString(1); int.region = rs.getInt(2);

BigDecimal sales = rs.get.BigDecimal(3); System.out.print("Name = " + name); System.out.print("Region = "+ region); System.out.print("Sales = "+ sales); System.out.printIn():

}

ranked_emps 过程仅提供在 create procedure 语句中声明的参数。 SQL 系 统提供 ResultSet 参数的空数组并调用 Java 方法，该方法将输出结果集分 配给数组参数。Java 方法完成后，SQL 系统将输出数组元素中的结果集 作为 SQL 结果集返回。

注释 仅当使用外部 JDBC 驱动程序 （如 jConnect）时，才可从临时表 中返回结果集。对于此任务，不能使用 Adaptive Server 本机 JDBC 驱动 程序。

删除 SQLJ 存储过程名

使用 drop procedure 命令可删除 Java 方法的 SQLJ 存储过程名。例如， 输入：

drop procedure correct_states

这会删除 correct_states 过程名及其对 SQLJExamples.correctStates 方法的 引用。 drop procedure 不会影响该过程引用的 Java 类和方法。

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