随着Sybase被完全整合到SAP下,Sybase原来的支持网站被SAP Support Portal取代。
只有购买了SAP服务的用户才能使用账号登录SAP Support Portal进行介质下载、补丁升级、报Incident等。
目前,原Sybase所有产品(包括:Adaptive Server Enterprise、Sybase IQ、Replication Server、PowerDesigner等)的官方手册仍然可以从http://infocenter.sybase.com/help/index.jsp进行浏览或下载。暂不清楚该网站http://infocenter.sybase.com/help/index.jsp何时会被完全迁移到SAP Support上!
Sybase官方手册英文版有html和pdf两种格式,而中文版手册只有pdf一种格式。为了国内Sybase用户更方便、快捷地搜索Sybase常见产品的官方手册内容,特将中文版Sybase官方手册转为html格式!
Sybase产品官方手册中文版的html格式所有内容的版权归SAP公司所有!本博客站长是Sybase数据库的铁杆粉丝!
如有Sybase数据库技术问题需要咨询,请联系我!
以下官方手册为SAP IQ 16.0 SP03中文版:
在数据库中创建新的用户定义 SQL 过程。
要创建外部过程接口,请参见 CREATE PROCEDURE 语句(外部过程)。
快速链接:
转至参数 (第 176 页) 转至示例 (第 179 页) 转至用法 (第 180 页) 转至标准 (第 180 页) 转至权限 (第 180 页)
语法
CREATE [ OR REPLACE | TEMPORARY ] PROCEDURE [ owner.]procedure-name
( [ parameter, …] ) {
[ SQL SECURITY { INVOKER | DEFINER } ]
[ RESULT ( result-column, …) | NO RESULT SET ]
[ ON EXCEPTION RESUME ] compound statement | AT location-string
parameter_mode parameter-name data-type [ DEFAULT expression ] |
SQLCODE | SQLSTATE
parameter_mode - (back to parameter)
IN | OUT | INOUT
result-column - (back to Syntax)
参数
(返回顶部) (第 175 页)
• parameter-name – 参数名必须符合其它数据库标识符(如列名)的规则,而且必 须是有效的 SQL 数据类型。这些关键字具有以下含义:
参数可以使用关键字 IN、OUT 或 INOUT 作为前缀。如果未指定关键字,参数在 缺省情况下使用 INOUT。这些关键字具有以下含义:
• IN – 参数是一个为过程提供值的表达式。
• OUT – 参数是一个可由过程赋值的变量。
• INOUT – 参数是一个为过程提供值的变量,并且可由过程赋值。
• SQLSTATE 和 SQLCODE – 在过程结束时输出 SQLSTATE 或 SQLCODE 值的特 殊参数(它们是 OUT 参数)。无论是否指定 SQLSTATE 和 SQLCODE 参数,总 是可以在过程调用后立即检查 SQLSTATE 和 SQLCODE 特殊值以测试过程的返回 状态。
SQLSTATE 和 SQLCODE 特殊值会由下一个 SQL 语句修改。如果将 SQLSTATE 或 SQLCODE 作为过程参数提供,则会允许返回代码存储在变量中。
• CREATE – 创建新过程。
• OR REPLACE – 替换现有的同名过程。此子句将更改过程的定义,但保留现有 权限。
不能将 OR REPLACE 子句与临时过程一起使用。另外,如果正在替换的过程已经 使用,则会返回错误。
• TEMPORARY – 该存储过程仅对创建它的连接可见,并在删除该连接时随之自 动删除。您也可以显式删除临时存储过程。您无法在临时存储过程上执行 ALTER、 GRANT 或 REVOKE,而且与其它存储过程不同,临时存储过程不会在目录或事务 日志中予以记录。
临时过程使用其创建者(当前用户)或指定所有者的权限执行。可以在以下情况 下为临时过程指定所有者:
• 临时过程是在永久存储过程内创建的
• 临时和永久过程的所有者相同 要删除临时过程的所有者,应先删除该临时过程。
当连接到只读数据库时,可以创建和删除临时存储过程;它们不能是外部过程。
例如,以下临时过程会删除名为 CustRank 的表(如果此表存在)。对于此示 例,该过程假定表名是唯一的,且可由过程创建者引用而不必指定表所有者:
CREATE TEMPORARY PROCEDURE drop_table( IN @TableName char(128) ) BEGIN
IF EXISTS ( SELECT 1 FROM SYS.SYSTAB WHERE
table_name = @TableName ) THEN EXECUTE IMMEDIATE
'DROP TABLE "' || @TableName || '"'; MESSAGE 'Table "' || @TableName || '" dropped' to client;
END IF;
END;
CALL drop_table( 'CustRank' )
• RESULT – 声明结果集中的列的数量和类型。RESULT 关键字后面括在括号内的 列表定义结果的列名和类型。描述 CALL 语句时,嵌入式 SQL DESCRIBE 或 ODBC SQLDescribeCol 会返回此信息。所允许的数据类型在参考:构件块、表和过程
>“SQL 数据类型”中列出。
因执行方式不同,有些过程可产生多个结果集。例如,以下过程有时返回两列, 有时返回一列。
CREATE PROCEDURE names( IN formal char(1)) BEGIN
IF formal = 'n' THEN SELECT GivenName FROM Employees
ELSE
SELECT Surname,GivenName FROM Employees
END IF END
包含可变结果集的过程必须用不带 RESULT 子句的语句编写,或者用 Transact-SQL
编写。它们的使用受以下限制制约:
• 嵌入式 SQL – 必须在打开用于结果集的游标之后、返回任何行之前对过程调 用执行 DESCRIBE,才能获取正确形式的结果集。这需要使用 DESCRIBE 语句的 CURSOR cursor-name 子句。
• ODBC、OLE DB、ADO.NET – ODBC 应用程序可以使用可变结果集过程。 结果集的正确描述由驱动程序或提供程序完成。
• Open Client 应用程序 – Open Client 应用程序可以使用可变结果集过程。
如果过程仅返回一个结果集,则应使用 RESULT 子句。该子句可防止 ODBC 和 Open Client 应用程序在游标打开后再次描述结果集。
要处理多个结果集,ODBC 必须描述当前正在执行的游标,而不是过程的已定义 结果集。因此,ODBC 不会始终按过程定义的 RESULT 子句中的定义来描述列 名。为避免这种问题,应在生成结果集的 SELECT 语句中使用列的别名。
• NO RESULT SET – 声明此过程不返回结果集。当外部环境需要知道某个过程不 返回结果集时,这将非常有用。
• SQL SECURITY – 定义该过程是作为 INVOKER(调用过程的用户)执行还是作为 DEFINER(拥有过程的用户)执行。缺省值为 DEFINER。
指定 SQL SECURITY INVOKER 后,必须对每个调用该过程的用户加以标注,因 此会使用更多内存。此外,还将以调用者身份执行名称解析。因此,需确保用适 合的所有者限定所有对象名称(表、过程等)。例如,假定 user1 创建以下过 程:
CREATE PROCEDURE user1.myProcedure() RESULT( columnA INT )
SQL SECURITY INVOKER BEGIN
SELECT columnA FROM table1;
END;
如果 user2 尝试运行此过程,而表 user2.table1 不存在,则系统会产生表查 询错误。此外,如果 user2.table1 确实存在,则系统会使用该表,而不使用 预定的 user1.table1。为防止出现这种情况,请在语句中限定表引用
(user1.table1,而不是仅 table1)。
• ON EXCEPTION RESUME – 过程会根据 ON_TSQL_ERROR 选项的设置来执行操 作。如果将 ON_TSQL_ERROR 选项设置为 CONDITIONAL(缺省值),当下一条 语句处理错误时,将继续执行该语句;否则将退出。
错误处理语句包括:
• IF
• SELECT @variable =
• CASE
• LOOP
• LEAVE
• CONTINUE
• CALL
• EXECUTE
• SIGNAL
• RESIGNAL
• DECLARE
• SET VARIABLE
在 ON EXCEPTION RESUME 子句中不要使用显式错误处理代码。 请参见 ON_TSQL_ERROR 选项 [TSQL]。
• AT location-string – 在当前数据库中为 location-string 指定的远程过程创建代理存 储过程。AT 子句支持在 location-string 中将分号 (;) 用作字段分隔符。如果没有分
号,则使用句号作为字段分隔符。这样一来,便可在数据库和所有者字段中使用 文件名和扩展名。
(返回顶部) (第 175 页)
• 示例 1 – 使用 case 语句对查询结果归类:
CREATE PROCEDURE ProductType (IN product_id INT, OUT type CHAR(10))
BEGIN
DECLARE prod_name CHAR(20) ;
SELECT name INTO prod_name FROM "GROUPO"."Products" WHERE ID = product_id;
CASE prod_name
WHEN 'Tee Shirt' THEN SET type = 'Shirt'
WHEN 'Sweatshirt' THEN SET type = 'Shirt'
WHEN 'Baseball Cap' THEN SET type = 'Hat'
WHEN 'Visor' THEN
SET type = 'Hat' WHEN 'Shorts' THEN
SET type = 'Shorts' ELSE
SET type = 'UNKNOWN' END CASE ;
END
• 示例 2 – 使用游标并遍历游标各行,返回单值:
CREATE PROCEDURE TopCustomer (OUT TopCompany CHAR(35), OUT TopValue INT)
BEGIN
DECLARE err_notfound EXCEPTION FOR SQLSTATE '02000' ;
DECLARE curThisCust CURSOR FOR
SELECT CompanyName, CAST( sum(SalesOrderItems.Quantity * Products.UnitPrice) AS INTEGER) VALUE
FROM Customers
LEFT OUTER JOIN SalesOrders
LEFT OUTER JOIN SalesorderItems LEFT OUTER JOIN Products
GROUP BY CompanyName ;
DECLARE ThisValue INT ;
DECLARE ThisCompany CHAR(35) ; SET TopValue = 0 ;
OPEN curThisCust ; CustomerLoop:
LOOP
FETCH NEXT curThisCust
INTO ThisCompany, ThisValue ;
IF SQLSTATE = err_notfound THEN LEAVE CustomerLoop ;
END IF ;
IF ThisValue > TopValue THEN SET TopValue = ThisValue ;
SET TopCompany = ThisCompany ; END IF ;
END LOOP CustomerLoop ; CLOSE curThisCust ;
用法
(返回顶部) (第 175 页)
CREATE PROCEDURE 在数据库中创建过程。过程可用 CALL 语句调用。可以创建永 久或临时 (TEMPORARY) 存储过程。可使用 PROC 作为 PROCEDURE 的同义词。
注意: 创建存储过程有两种方式:ISO/ANSI SQL 和 T-SQL。例如,当使用 CREATE PROCEDURE 语法时,BEGIN TRANSACTION 特定于 T-SQL。不要在创建存储过程时 混合使用语法。请参见 CREATE PROCEDURE 语句 [T-SQL]。
使用 CALL 执行过程时,不需要指定所有的参数。如果在 CREATE PROCEDURE 语句 中提供了缺省值,则系统会为缺少的参数指派缺省值。如果 CALL 语句中既未提供参 数也未设置缺省值,则会给出错误。
远程过程在输出变量中最多只能返回 254 个字符。 如果远程过程可以返回结果集,即使并不是始终都返回,本地过程定义也必须包含
RESULT 子句。
有关远程服务器的信息,请参见 CREATE SERVER 语句。 副作用
• 自动提交
(返回顶部) (第 175 页)
• SQL - 符合 ISO/ANSI SQL 标准。
• SAP Sybase 数据库产品 - Transact-SQL CREATE PROCEDURE 语句不同。
• SQLJ - 建议的 SQLJ1 标准中指定了 Java 结果集的语法扩展。
(返回顶部) (第 175 页)
创建属于自己的由自身拥有的 Watcom SQL 或 Transact SQL 过程 - 需要 CREATE PROCEDURE 系统特权。
创建其他用户拥有的 Watcom SQL 或 Transact SQL 过程 - 需要以下特权之一:
• CREATE ANY PROCEDURE 系统特权。
• CREATE ANY OBJECT 系统特权。 由自身拥有的远程过程 - 需要以下所有特权:
• CREATE EXTERNAL REFERENCE 系统特权。
• CREATE PROCEDURE 系统特权。
由任何用户拥有的远程过程 - 需要 CREATE EXTERNAL REFERENCE 系统特权。还 需要具备以下特权之一:
• CREATE ANY PROCEDURE 系统特权。
• CREATE ANY OBJECT 系统特权。
另请参见
• 在过程中引用临时表 (第 181 页)
• CALL 语句 (第 96 页)
• CREATE PROCEDURE 语句 [T-SQL] (第 182 页)
• CREATE PROCEDURE 语句(外部过程) (第 184 页)
• CREATE SERVER 语句 (第 201 页)
• DROP 语句 (第 266 页)
• EXECUTE IMMEDIATE 语句 [ESQL] [SP] (第 296 页)
• GRANT EXECUTE 语句 (第 330 页)
• RAISERROR 语句 [T-SQL] (第 402 页)
• ON_TSQL_ERROR 选项 [TSQL] (第 620 页)
之前就已经研发成功了能够从Sybase SQL Anywhere的DB文件中恢复数据的工具:ReadASADB。
此工具支持ASA v5.0,v6.0,v7.0,v8.0,v9.0,v10.0,v11.0,v12.0等版本。
恢复Sybase SQL Anywhere的工具在国内应该算首创。
ReadASADB功能
能够从损坏的SQL Anywhere数据文件(.db)和UltraLite数据文件(.udb)上提取数据的非常规恢复工具
- 适用于所有的SQL Anywhere版本 包括:5.x,6.x,7.x,8.x,9.x,10.x,11.x,12.x
- 适用于所有的UltraLite版本
- 能够恢复出来表结构和数据
- 能够恢复自定义数据类型
- 能够恢复存储过程等对象的语法
- 能够导出到目标数据库
- 能够导出到SQL文件并生成导入脚本
- 支持多种字符集 包括:cp850、cp936、gb18030、utf8等
- 能够恢复未加密或者简单加密类型的数据
- 简单易用
- 限制:不支持AES加密的数据文件
SQL Anywhere数据库非常规恢复工具ReadASADB使用介绍
ReadASADB适用场景
各种误操作:
- 误截断表(truncate table)
- 误删除表(drop table)
- 错误的where条件误删数据
- 误删除db或log文件
- 误删除表中的字段
本工具的应用场景:
1.因为物理磁盘故障、操作系统、系统软件方面或者掉电等等原因导致的Sybase SQL Anywhere数据库无法打开的情况;
2.误操作,包括truncate table,drop table,不正确的where条件导致的误删除等;
Sybase SQL Anywhere无法打开时,比较常见的错误是:Assertion failed。
如:
1、Internal database error *** ERROR *** Assertion failed:201819 (8.0.1.2600) Checkpoint log: invalid bitmap page -- transaction rolled back
2、Internal database error *** ERROR *** Assertion failed:201819 (8.0.1.2600) Page number on page does not match page requested -- transaction rolled back
3、Internal database error *** ERROR *** Assertion failed:200502 (9.0.2.2451) Checksum failure on page 23 -- transaction rolled back
4、File is shorter than expected
5、Internal database error *** ERROR *** Assertion failed: 201116 Invalid free list index page found while processing checkpoint log -- transaction rolled back
6、*** ERROR *** Assertion failed: 51901 Page for requested record not a table page or record not present on page等等。
+-------------------------------------华丽的分割线-------------------------------------------------------------------------