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

 

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

PHP 外部环境 ‌

PHP 存储过程或函数与 SQL 存储过程或函数的行为基本相同，只是过程或函数的代码用 PHP 编写，并且在数据库服务器外（即在 PHP 可执行文件实例内）执行。

对于使用 PHP 存储过程和函数的每个连接，会有一个单独的 PHP 可执行文件实例。 这一点与 Java 存储过程和函数有很大不同。对于 Java，每个数据库对应于一个 Java VM 实例，而不是每个连接对应于一个实例。PHP 和 Java 间的另一个主要差异是 PHP 存 储过程不返回结果集，而 Java 存储过程可以返回结果集。PHP 仅返回 LONG VARCHAR 类型的对象，它是 PHP 脚本的输出。

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

1. 数据库服务器计算机中必须装有 PHP 副本，而且数据库服务器必须能够找到 PHP

可执行文件。

2. 数据库服务器计算机中必须装有 PHP 扩展。

除了上述两个前提条件外，数据库管理员还必须安装 PHP External Environment 模块。 包括多个 PHP 版本的预建模块。要安装预建模块，可将相应的驱动程序模块复制到 PHP 扩展目录中（可以在 php.ini 中找到）。在 UNIX 中，还可以使用符号链接。

安装外部环境模块 (Windows)：

1. 找到 PHP 安装目录中的 php.ini 文件，并在文本编辑器中将其打开。找到指定 extension_dir 目录位置的行。如果未将 extension_dir 设置到任何特定目 录，则为获得更好的系统安全，最好将其设置为指向一个单独的目录。

2. 将所需外部环境 PHP 模块从安装目录复制到 PHP 扩展目录中。请更改 x.y 以反映 所选版本。

copy "%SQLANY12%\Bin32\php-5.x.y_sqlanywhere_extenv12.dll" php-dir\ext

3. 将以下行添加到 php.ini 文件的动态扩展部分，以自动装载外部环境 PHP 模块。 更改 x.y 以反映所选的版本。

extension=php-5.x.y_sqlanywhere_extenv12.dll

保存并关闭 php.ini。

4. 请确保您同时还将 PHP 驱动程序从安装目录安装到了 PHP 扩展目录。此文件名采用 php-5.x.y_sqlanywhere.dll 模式，其中 x 和 y 为版本号。它们应该与在步骤 2 中所复制的文件的版本号相匹配。

安装外部环境模块 (UNIX)：

1. 找到 PHP 安装目录中的 php.ini 文件，并在文本编辑器中将其打开。找到指定 extension_dir 目录位置的行。如果未将 extension_dir 设置到任何特定目 录，则为获得更好的系统安全，最好将其设置为指向一个单独的目录。

2. 将所需的外部环境 PHP 模块从安装目录复制到 PHP 安装目录中。请更改 x.y 以反 映所选版本。

cp $SQLANY12/bin32/php-5.x.y_sqlanywhere_extenv12.so php-dir/ext

3. 将以下行添加到 php.ini 文件的动态扩展部分，以自动装载外部环境 PHP 模 块。更改 x.y 以反映所选的版本。

extension=php-5.x.y_sqlanywhere_extenv12.so

保存并关闭 php.ini。

4. 请确保您同时还将 PHP 驱动程序从安装目录安装到了 PHP 扩展目录。此文件名采用 php-5.x.y_sqlanywhere.so 模式，其中 x 和 y 为版本号。它们应该与在步骤 2 中所复制的文件的版本号相匹配。

要在数据库中使用 PHP，数据库服务器必须能够找到并启动 PHP 可执行文件。通过 执行以下语句可以验证数据库服务器是否能够找到并启动 PHP 可执行文件：

START EXTERNAL ENVIRONMENT PHP;

如果显示一条消息，说明找不到“外部可执行文件”，则问题是数据库服务器不能找到 PHP 可执行文件。这种情况下应执行 ALTER EXTERNAL ENVIRONMENT 语句，以特意 设置 PHP 可执行文件的位置（包括可执行文件名），或者确保含有 PHP 可执行文件 的目录包含在 PATH 环境变量中。

ALTER EXTERNAL ENVIRONMENT PHP

LOCATION 'php-path';

例如：

ALTER EXTERNAL ENVIRONMENT PHP

LOCATION 'c:\\php\\php-5.2.6-win32\\php.exe';

要恢复缺省设置，请执行以下语句：

ALTER EXTERNAL ENVIRONMENT PHP LOCATION 'php';

除非用于验证数据库服务器能否启动 PHP，否则不必使用 START EXTERNAL ENVIRONMENT PHP 语句。通常，进行 PHP 存储过程或函数的调用会自动启动 PHP。

同样，停止 PHP 也不必使用 STOP EXTERNAL ENVIRONMENT PHP 语句，因为连接终 止时实例会自动消失。但是，如果要彻底停用 PHP 并且想要释放一些资源，则 STOP EXTERNAL ENVIRONMENT PHP 语句可以为您的连接释放该 PHP 实例。

验证数据库服务器可以启动 PHP 可执行文件后，要做的下一件事就是在数据库中安 装所需的 PHP 代码。可用 INSTALL 语句执行这种操作。例如，可以执行以下语句来 将特定 PHP 脚本安装到数据库。

INSTALL EXTERNAL OBJECT 'php-script' NEW

FROM FILE 'php-file' ENVIRONMENT PHP;

也可以从表达式构建和安装 PHP 代码，如下所示：

INSTALL EXTERNAL OBJECT 'php-script' NEW

FROM VALUE 'php-statements' ENVIRONMENT PHP;

还可以从变量构建和安装 PHP 代码，如下所示：

CREATE VARIABLE PHPVariable LONG VARCHAR;

SET PHPVariable = 'php-statements'; INSTALL EXTERNAL OBJECT 'php-script'

NEW

FROM VALUE PHPVariable ENVIRONMENT PHP;

要从数据库中删除 PHP 代码，请使用 REMOVE 语句，如下所示：

REMOVE EXTERNAL OBJECT 'php-script';

要修改现有 PHP 代码，可以使用 INSTALL 语句的 UPDATE 子句，如下所示：

INSTALL EXTERNAL OBJECT 'php-script' UPDATE

FROM FILE 'php-file' ENVIRONMENT PHP;

INSTALL EXTERNAL OBJECT 'php-script' UPDATE

FROM VALUE 'php-statements' ENVIRONMENT PHP;

SET PHPVariable = 'php-statements'; INSTALL EXTERNAL OBJECT 'php-script'

UPDATE

FROM VALUE PHPVariable ENVIRONMENT PHP;

PHP 代码安装在数据库中后，接下来可以继续创建所需的 PHP 存储过程和函数。创建 PHP 存储过程和函数时，LANGUAGE 始终是 PHP，EXTERNAL NAME 字符串包含 调用 PHP 子例程和返回 OUT 参数所需的信息。

参数通过 $argv 数组传递给 PHP 脚本，这与 PHP 从命令行获取参数的方式类似（即

$argv[1] 为第一个参数）。要设置输出参数，请将其赋值给相应的 $argv 元素。返回 值始终是脚本的输出（LONG VARCHAR 数据类型）。

对于输入或输出参数，可用任何一组数据类型创建 PHP 存储过程。但为了在 PHP 脚 本内部使用，这些参数会转换为（或者反向转换）布尔值、整数、双精度值或字符 串。返回值始终是 LONG VARCHAR 类型的对象。以下是一个简单的 PHP 示例：

INSTALL EXTERNAL OBJECT 'SimplePHPExample' NEW

FROM VALUE '<?php function SimplePHPFunction(

$arg1, $arg2, $arg3, $arg4 )

{ return ($arg1 * 1000) + ($arg2 * 100) +

($arg3 * 10) +

$arg4;

} ?>' ENVIRONMENT PHP;

CREATE FUNCTION SimplePHPDemo(

IN thousands INT, IN hundreds INT, IN tens INT,

IN ones INT) RETURNS LONG VARCHAR

EXTERNAL NAME '<file=SimplePHPExample> print SimplePHPFunction(

$argv[1], $argv[2], $argv[3], $argv[4]);' LANGUAGE PHP;

// The number 1234 should appear SELECT SimplePHPDemo(1,2,3,4);

对于 PHP，EXTERNAL NAME 字符串以 SQL 的单独一行指定。

要使用服务器端 PHP，PHP 代码可以使用缺省数据库连接。要获取数据库连接的句 柄，请以空字符串参数（'' 或 ""）调用 sasql_pconnect。空字符串参数会告知 PHP 驱 动程序返回当前外部环境连接，而不是打开一个新连接。下面的示例将创建一个表， 然后调用 PHP 存储过程来填充该表。

CREATE TABLE phpTab(c1 int, c2 char(128));

INSTALL EXTERNAL OBJECT 'ServerSidePHPExample' NEW

FROM VALUE '<?php function ServerSidePHPSub() {

$conn = sasql_pconnect( '''' ); sasql_query( $conn,

"INSERT INTO phpTab

SELECT table_id, table_name FROM SYS.SYSTAB" ); sasql_commit( $conn );

} ?>'

ENVIRONMENT PHP;

CREATE PROCEDURE PHPPopulateTable()

EXTERNAL NAME '<file=ServerSidePHPExample> ServerSidePHPSub()' LANGUAGE PHP;

CALL PHPPopulateTable();

// The following should return 2 identical rows SELECT count(*) FROM phpTab

UNION ALL

SELECT count(*) FROM SYS.SYSTAB;

对于 PHP，EXTERNAL NAME 字符串以 SQL 的单独一行指定。请注意，在上面的 示例中，由于引号在 SQL 中的分析方式，单引号都是双写的。如果 PHP 源代码是在 文件中，单引号则不用双写。

要将错误返回给数据库服务器，可抛出一个 PHP 异常。下面举例说明如何实现这一 目的。

CREATE TABLE phpTab(c1 int, c2 char(128));

INSTALL EXTERNAL OBJECT 'ServerSidePHPExample' NEW

FROM VALUE '<?php function ServerSidePHPSub() {

$conn = sasql_pconnect( '''' ); if( !sasql_query( $conn,

"INSERT INTO phpTabNoExist

SELECT table_id, table_name FROM SYS.SYSTAB" )

) throw new Exception( sasql_error( $conn ), sasql_errorcode( $conn )

);

sasql_commit( $conn );

} ?>'

ENVIRONMENT PHP;

CREATE PROCEDURE PHPPopulateTable() EXTERNAL NAME

'<file=ServerSidePHPExample> ServerSidePHPSub()' LANGUAGE PHP;

CALL PHPPopulateTable();

上例终止时会出现错误 SQLE_UNHANDLED_EXTENV_EXCEPTION，从而表明无 法找到表 phpTabNoExist。

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