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

 

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

Java 外部环境 ‌

数据库服务器支持 Java 存储过程和函数。Java 存储过程或函数与 SQL 存储过程或函 数的行为基本相同，只是过程或函数的代码用 Java 编写并且在数据库服务器外（即在 Java VM 环境内）执行。

应该注意的是，每个数据库对应于一个 Java VM 实例，而不是每个连接对应于一个 实例。Java 存储过程可以返回结果集。

在数据库支持中使用 Java 有几个前提条件：

1. 数据库服务器计算机中必须装有一个 Java 运行时环境副本。

2. 数据库服务器必须能够找到 Java 可执行文件 (Java VM)。

要在数据库中使用 Java，请确保数据库服务器能够找到并启动 Java 可执行文件。通 过执行以下语句可验证这一点：

START EXTERNAL ENVIRONMENT JAVA;

如果数据库服务器未能启动 Java，问题的原因可能是数据库服务器不能找到 Java 可 执行文件。这种情况下应执行 ALTER EXTERNAL ENVIRONMENT 语句，以特意设置 Java 可执行文件的位置。务必要包含可执行文件名。

ALTER EXTERNAL ENVIRONMENT JAVA

LOCATION 'java-path';

例如：

ALTER EXTERNAL ENVIRONMENT JAVA

LOCATION 'c:\\jdk1.6.0\\jre\\bin\\java.exe';

通过执行以下 SQL 查询，可查询将要用于数据库服务器的 Java VM 的位置：

SELECT db_property('JAVAVM');

请注意，除非用于验证数据库服务器能否启动 Java VM，否则不必使用 START EXTERNAL ENVIRONMENT JAVA 语句。一般而言，调用 Java 存储过程或函数会自动 启动 Java VM。

同样，停止 Java 实例也不必使用 STOP EXTERNAL ENVIRONMENT JAVA 语句，因为数 据库的所有连接终止时 Java 实例会自动消失。但是，如果要彻底停用 Java 并且想要 释放一些资源，则 STOP EXTERNAL ENVIRONMENT JAVA 语句可以减少 Java VM 的使 用次数。

验证了数据库服务器可以启动 Java VM 可执行文件后，接下来要做的事就是在数据 库中安装所需的 Java 类代码。可用 INSTALL JAVA 语句执行这种操作。例如，可以执 行以下语句来将 Java 类从文件安装到数据库中。

INSTALL JAVA NEW

FROM FILE 'java-class-file';

也可以将 Java JAR 文件安装到数据库中。

INSTALL JAVA NEW

JAR 'jar-name'

FROM FILE 'jar-file';

可以从变量安装 Java 类，如下所示：

CREATE VARIABLE JavaClass LONG VARCHAR;

SET JavaClass = xp_read_file('java-class-file') INSTALL JAVA

NEW

FROM JavaClass;

要从数据库中删除 Java 类，请使用 REMOVE JAVA 语句，如下所示：

REMOVE JAVA CLASS java-class

要从数据库中删除 Java JAR，请使用 REMOVE JAVA 语句，如下所示：

REMOVE JAVA JAR 'jar-name'

要修改现有 Java 类，可以使用 INSTALL JAVA 语句的 UPDATE 子句，如下所示：

INSTALL JAVA UPDATE

FROM FILE 'java-class-file'

也可以在数据库中更新现有 Java JAR 文件。

INSTALL JAVA UPDATE

JAR 'jar-name'

FROM FILE 'jar-file';

可以从变量更新 Java 类，如下所示：

CREATE VARIABLE JavaClass LONG VARCHAR;

SET JavaClass = xp_read_file('java-class-file') INSTALL JAVA

UPDATE

FROM JavaClass;

Java 类安装在数据库中后，接下来可以创建存储过程和函数，以与 Java 方法连接。 EXTERNAL NAME 字符串含有调用 Java 方法以及返回 OUT 参数和返回值所需的信息。 必须在 EXTERNAL NAME 子句的 LANGUAGE 属性中指定 JAVA。EXTERNAL NAME 子

句的格式为：

EXTERNAL NAME 'java-call' LANGUAGE JAVA

java-call：

[package-name.]class-name.method-name method-signature

method-signature：

( [ field-descriptor, ... ] ) return-descriptor

field-descriptor 和 return-descriptor：

• Z

• | B

• | S

• | I

• | J

• | F

• | D

• | C

• | V

• | [descriptor

• | Lclass-name;

Java 方法签名是参数类型和返回值类型的压缩字符表示形式。如果参数数量少于显示 在方法签名中的数量，则差值必须等于 DYNAMIC RESULT SETS 中指定的数量，并且 方法签名中超出过程参数列表中参数的每个参数的方法签名必须是 [Ljava/SQL/ ResultSet;。

对于 Java UDF，无需设置 DYNAMIC RESULT SETS；暗示 DYNAMIC RESULT SETS 等于

1。

field-descriptor 和 return-descriptor 的含义如下：

例如，

double some_method( boolean a,

int b, java.math.BigDecimal c, byte [][] d,

java.sql.ResultSet[] rs ) {

}

可以有以下签名：

'(ZILjava/math/BigDecimal;[[B[Ljava/SQL/ResultSet;)D'

以下过程创建 Java 方法的接口。Java 方法不返回任何值 (V)。

CREATE PROCEDURE insertfix()

EXTERNAL NAME 'JDBCExample.InsertFixed()V' LANGUAGE JAVA;

以下过程创建具有字符串 ([Ljava/lang/String;) 输入参数的 Java 方法的接口。Java 方法 不返回任何值 (V)。

CREATE PROCEDURE InvoiceMain( IN arg1 CHAR(50) )

EXTERNAL NAME 'Invoice.main([Ljava/lang/String;)V' LANGUAGE JAVA;

以下过程创建 Java 方法 Invoice.init （可接收一个字符串参数 (Ljava/lang/ String;)、一个双精度参数 (D)、另一个字符串参数 (Ljava/lang/String;) 和另一个双精度 参数 (D)）的接口，并且不返回任何值 (V)。

CREATE PROCEDURE init( IN arg1 CHAR(50),

IN arg2 DOUBLE,

IN arg3 CHAR(50), IN arg4 DOUBLE)

EXTERNAL NAME 'Invoice.init(Ljava/lang/String;DLjava/lang/ String;D)V'

LANGUAGE JAVA

下面的示例 Java 含有函数 main，该函数可以接收一个字符串参数并将其写入数据库 服务器消息窗口。其中还含有函数 whare，该函数可返回 Java 字符串。

import java.io.*;

public class Hello

{

public static void main( String[] args )

{

System.out.print( "Hello" );

for ( int i = 0; i < args.length; i++ ) System.out.print( " " + args[i] );

System.out.println();

}

public static String whare()

{

return( "I am SQL Anywhere." );

}

}

以上 Java 代码位于 Hello.java 文件中，并使用 Java 编译器进行编译。所生成的类 文件将装载到数据库中，如下所示。

INSTALL JAVA NEW

FROM FILE 'Hello.class';

通过 Interactive SQL，用于在 Hello 类中连接方法 main 的存储过程将按如下方式创 建：

CREATE PROCEDURE HelloDemo( IN name LONG VARCHAR )

EXTERNAL NAME 'Hello.main([Ljava/lang/String;)V' LANGUAGE JAVA;

请注意，main 的参数描述为 java.lang.String 数组。用 Interactive SQL 通过执 行以下 SQL 语句来测试该接口。

CALL HelloDemo('SQL Anywhere');

如果检查数据库服务器消息窗口，将会找到此处写入的消息。所有到 System.out

的输出将重定向到服务器消息窗口。

通过 Interactive SQL，用于在 Hello 类中连接方法 whare 的函数将按如下方式创 建：

CREATE FUNCTION Whare() RETURNS LONG VARCHAR

EXTERNAL NAME 'Hello.whoAreYou(V)Ljava/lang/String;' LANGUAGE JAVA;

请注意，函数 whare 以返回 java.lang.String 的形式进行描述。用 Interactive SQL 通过执行以下 SQL 语句来测试该接口。

SELECT Whare();

应该会在“Interactive SQL 结果”窗口中看到响应。

尝试排除 Java 外部环境未启动的故障时，也就是调用 Java 时应用程序遇到“主线程 未找到”错误时，DBA 应该执行以下检查：

• 如果 Java VM 与数据库服务器的位数不相同，则确保数据库服务器计算机中装有 位数与 VM 相同的客户端库。

• 确保共享对象 sajdbc.jar 和 dbjdbc12/libdbjdbc12 来自同一软件内部版 本。

• 如果数据库服务器计算机中有多个 sajdbc.jar ，则确保其都已与同一软件版本 同步。

• 如果数据库服务器计算机很忙，则可能会因为超时而报错。

另请参见

• INSTALL JAVA 语句 （第 335 页）

• CREATE PROCEDURE 语句 (Java UDF) （第 337 页）

• CREATE FUNCTION 语句 (Java UDF) （第 339 页）

• REMOVE 语句 （第 342 页）

• START JAVA 语句 （第 343 页）

• STOP JAVA 语句 （第 344 页）

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