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

 

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

CREATE FUNCTION 语句 ‌

在数据库中创建用户定义的函数。通过指定所有者名称，可以为其他用户创建函数。 根据权限，可通过与其它非集合函数完全相同的方法使用用户定义的函数。

快速链接：

转至参数 （第 218 页） 转至示例 （第 221 页） 转至用法 （第 222 页） 转至标准 （第 222 页） 转至权限 （第 222 页） 语法

语法 1

CREATE [ OR REPLACE ] [ TEMPORARY ] FUNCTION [ owner.]function-name

( [ parameter, … ] )

[ SQL SECURITY { INVOKER | DEFINER } ]

RETURNS data-type ON EXCEPTION RESUME

| [ NOT ] DETERMINISTIC

{ compound-statement | AS tsql-compound-statement

| EXTERNAL NAME library-call

| EXTERNAL NAME java-call LANGUAGE JAVA }

语法 2

CREATE FUNCTION [ owner.]function-name ( [ parameter, … ] )

RETURNS data-type

URL url-string

[ HEADER header-string ]

[ SOAPHEADER soap-header-string ]

[ TYPE { 'HTTP[:{ GET | POST } ] ' | 'SOAP[:{ RPC | DOC } ]' } ]

[ NAMESPACE namespace-string ]

[ CERTIFICATE certificate-string ] [ CLIENTPORT clientport-string ]

[ PROXY proxy-string ]

parameter - (back to Syntax 1) or (back to Syntax 2)

IN parameter-name data-type [ DEFAULT expression ]

tsql-compound-statement - (back to Syntax 1)

sql-statement sql-statement …

library-call - (back to Syntax 1)

'[ operating-system:]function-name@library; …'

operating-system - (back to library-call) UNIX

java-call - (back to Syntax 1)

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

method-signature - (back to java-call)

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

field-descriptor and return-descriptor - (back to method-signature)

Z | B | S | I | J | F | D | C | V | [ descriptor | L class-name;

url-string - (back to Syntax 2)

' { HTTP | HTTPS | HTTPS_FIPS }://[user:password@]hostname[:port][/

path ] '

参数

（返回顶部） （第 217 页）

• CREATE [ OR REPLACE ] – 参数名必须符合数据库标识符规则。它们必须具有 有效的 SQL 数据类型，而且必须以关键字 IN 作为前缀，以表明参数是为函数提 供值的表达式。

CREATE 子句将创建一个新函数，而 OR REPLACE 子句将替换同名的现有函数。 替换函数时会更改函数的定义，但保留现有权限。不能将 OR REPLACE 子句与临 时函数一起使用。

• TEMPORARY – 该函数仅对创建它的连接可见，并在删除该连接时随之自动删 除。也可以显式删除临时函数。无法对临时函数执行 ALTER、GRANT 或 REVOKE 操作，而且与其它函数不同，临时函数不会被记录在目录或事务日志中。

具有临时函数创建者（当前用户）权限才能执行临时函数，并且临时函数只能由 其创建者所有。因此，创建临时函数时无需指定所有者。临时函数可在连接到只 读数据库时加以创建和删除。

• SQL SECURITY – 定义是作为 INVOKER（调用函数的用户）还是作为 DEFINER

（拥有函数的用户）执行函数。缺省值为 DEFINER。

指定 INVOKER 后，必须对每个调用该过程的用户加以标注，因此会使用更多内 存。此外，还将以调用者身份执行名称解析。因此，需确保用适合的所有者限定 所有对象名称（表、过程等）。

• data-type – 不允许将 LONG BINARY 和 LONG VARCHAR 作为返回值数据类型。

• compound-statement – 一组用 BEGIN 和 END 括起来的 SQL 语句，中间用分号分 隔。请参见 BEGIN … END 语句。

• tsql-compound-statement – 一批 Transact-SQL 语句。

• external-name – 包含对外部库函数调用的包装，在 RETURNS 子句之后不含任 何其它子句。库名可包含文件扩展名，在 Windows 中通常为 .dll，在 UNIX 中 通常为 .so。在没有扩展名的情况下，该软件附加平台特定的缺省库文件扩展名。

临时函数不支持 external-name 子句。

• LANGUAGE JAVA – 关于 Java 方法的包装。有关调用 Java 过程的信息，请参见 CREATE PROCEDURE 语句。

• ON EXCEPTION RESUME – 使用类似于 Transact-SQL 的错误处理。请参见 CREATE PROCEDURE 语句。

• [NOT] DETERMINISTIC – 每次在查询中调用函数时都将重新求值。不是以这 种方式指定的函数结果可以存入高速缓存以便提高性能，并且每次在查询求值过 程中使用相同参数调用函数时，都会重新使用缓存的结果。

对于具有副作用（如修改基础数据）的函数，应将其声明为 NOT DETERMINISTIC。例如，应将生成主键值且用于 INSERT … SELECT 语句的函数 声明为 NOT DETERMINISTIC：

CREATE FUNCTION keygen( increment INTEGER ) RETURNS INTEGER

NOT DETERMINISTIC BEGIN

DECLARE keyval INTEGER;

UPDATE counter SET x = x + increment; SELECT counter.x INTO keyval FROM counter; RETURN keyval

END

INSERT INTO new_table SELECT keygen(1), ...

FROM old_table

如果函数对给定输入参数总是返回相同的值，则该函数可以声明为 DETERMINISTIC。除非所有用户定义的函数都声明为 NOT DETERMINISTIC， 否则它们将被视为确定型函数。确定型函数为相同的参数返回一致的结果，并且 没有副作用。即，数据库服务器假定对具有相同参数的同一函数连续进行两次调 用将返回相同的结果，并且不会对查询的语义产生任何不良的副作用。

• URL – 仅在定义 HTTP 或 SOAP Web 服务客户端函数时使用。指定 Web 服务的 URL。其中的用户名和口令参数是可选的，它们提供了一种用于提供 HTTP 基本 验证所需的证书的方法。HTTP 基本验证对用户和口令信息进行基于 64 位的编 码，并将其传递到 HTTP 请求的“验证”标头中。

对于 Web 服务客户端函数来说，SOAP 和 HTTP 函数的返回类型必须为字符数据 类型之一，如 VARCHAR。返回值是 HTTP 响应的主体。其中不包括 HTTP 标头 信息。如果需要详细信息（例如状态信息），请使用过程而非函数。

参数值将作为请求的一部分进行传递。使用的语法取决于请求的类型。对于 HTTP:GET，参数将作为 URL 的一部分进行传递；对于 HTTP:POST 请求，则将 值放在请求主体中。SOAP 请求的参数总是被绑定在请求主体中。

• HEADER – 创建 HTTP Web 服务客户端函数时，此子句用于添加或修改 HTTP 请求标头条目。仅可为 HTTP 标头指定可打印 ASCII 字符，且这些字符不区分大 小写。有关如何使用此子句的详细信息，请参见 CREATE PROCEDURE 语句 的 HEADER 子句。

• SOAPHEADER – 当将 SOAP Web 服务声明为函数时，此子句用于指定一个或多个 SOAP 请求标头条目。SOAP 标头可声明为静态常量，也可使用参数替代机制动态 设置（为参数 hd1、hd2 等声明 IN、OUT 或 INOUT 参数）。Web 服务函数可定 义一个或多个 IN 模式替代参数，但无法定义 INOUT 或 OUT 替代参数。

• TYPE – 指定创建 Web 服务请求时使用的格式。如果指定 SOAP 或未包括类型子 句，则使用缺省类型 SOAP:RPC。HTTP 隐含 HTTP:POST。由于始终将 SOAP 请 求作为 XML 文档发送，所以 HTTP:POST 始终用于发送 SOAP 请求。

• NAMESPACE – 仅适用于 SOAP 客户端函数，并且标识 SOAP:RPC 和 SOAP:DOC 请求通常都需要的方法命名空间。处理请求的 SOAP 服务器使用此命名空间来解释 SOAP 请求消息主体中的实体名称。可以通过 Web 服务服务器，从 SOAP 服务的 WSDL 描述中获取命名空间。缺省值是过程的 URL，但是不包括可选的路径组 件。

• CERTIFICATE – 要创建安全 (HTTPS) 请求，客户端必须有权访问 HTTPS 服务 器所用的证书。必要的信息在一个用分号分隔的键/值对字符串中指定。证书可置 于文件中且文件的名称通过 file 键提供，或者整个证书可置于字符串中，但不能 同时出现这两种情况。可使用以下键：

只有定向到 HTTPS 服务器或可以从非安全服务器重定向至安全服务器的请求才需 要证书。

• CLIENTPORT – 标识 HTTP 客户端过程使用 TCP/IP 通信时所在的端口号。该子 句是为通过防火墙的连接提供的，并建议只用于此类连接，因为防火墙按照 TCP/ UDP 端口进行过滤。您可以指定单个端口号、端口号范围或是两者的组合；例如 CLIENTPORT '85,90-97'。

• PROXY – 指定代理服务器的 URI。在客户端必须通过代理访问网络时使用。指 示过程将要连接到代理服务器，并通过它将请求发送到 Web 服务。

示例

（返回顶部） （第 217 页）

• 示例 1 – 将 firstname 字符串与 lastname 字符串连接在一起：

CREATE FUNCTION fullname ( firstname CHAR(30), lastname CHAR(30) )

RETURNS CHAR(61) BEGIN

DECLARE name CHAR(61);

SET name = firstname || ' ' || lastname; RETURN (name);

END

此示例说明了 fullname 函数的用法。

• 根据提供的两个字符串返回全名：

SELECT fullname ('joe','smith')

fullname('joe', 'smith')

joe smith

• 列出所有雇员的姓名：

SELECT fullname (givenname, surname) FROM Employees

• 示例 2 – 使用 Transact-SQL 语法：

CREATE FUNCTION DoubleIt ( @Input INT ) RETURNS INT

AS

DECLARE @Result INT

SELECT @Result = @Input * 2 RETURN @Result

语句 SELECT DoubleIt( 5 ) 返回值 10。

• 示例 3 – 创建一个用 Java 编写的外部函数：

CREATE FUNCTION dba.encrypt( IN name char(254) ) RETURNS VARCHAR

EXTERNAL NAME

'Scramble.encrypt (Ljava/lang/String;)Ljava/lang/String;' LANGUAGE JAVA

用法

（返回顶部） （第 217 页）

要修改用户定义的函数或通过加扰函数定义来隐藏函数的内容，请使用 ALTER FUNCTION 语句。

执行函数时，不必指定所有参数。如果在 CREATE FUNCTION 语句中提供了缺省值， 则系统会为缺少的参数指派缺省值。如果调用程序既未提供参数又未设置缺省值，则 会给出错误。

副作用

• 自动提交

标准

（返回顶部） （第 217 页）

• SQL - 符合 ISO/ANSI SQL 标准。

• SAP Sybase 数据库产品 - 不受 Adaptive Server 支持。

权限

（返回顶部） （第 217 页）

如果希望函数归自己所有 – 需要 CREATE PROCEDURE 系统特权。 如果希望函数可由任何用户拥有 – 则需要以下特权之一：

• CREATE ANY PROCEDURE 系统特权。

• CREATE ANY OBJECT 系统特权。

要创建包含外部引用的函数，则无论用户是否为函数的所有者，另外都需要 CREATE EXTERNAL REFERENCE 系统特权。

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