iAnywhere.com - ALTER SERVER 语句

ALTER SERVER 语句

ALTER SERVER server-name
[ CLASS 'server-class' ]
[ USING 'connection-info' ]
[ CAPABILITY 'cap-name' { ON | OFF } ]
[ CONNECTION CLOSE [ CURRENT | ALL | connection-id

connection-info :
machine-name:port-number[/dbname ] | data-source-name

参数

CLASS 子句 指定 CLASS 子句以更改服务器类。

有关服务器类和如何配置服务器的详细信息，请参见用于进行远程数据访问的服务器类。

USING 子句 指定 USING 子句以更改服务器连接信息。有关 connection-info 的信息，请参见 CREATE SERVER 语句。

CAPABILITY 子句 CAPABILITY 子句将服务器功能设置为 ON 或 OFF。服务器功能存储在系统表 syscapability 中。这些功能的名称存储在系统表 syscapabilityname 中。syscapability 表要到与远程服务器建立了第一个连接时，才包含对应于该服务器的条目。首次连接时，Adaptive Server Anywhere 向服务器询问其功能，然后填充 syscapability 表。对于后面的连接，它从该表中获取服务器的功能。

通常情况下，不需要变更服务器的功能。可能需要变更属于 ODBC 类的通用服务器的功能。

CONNECTION CLOSE 子句

当用户创建了到远程服务器的连接时，该远程连接要到用户从本地数据库断开连接后才关闭。CONNECTION CLOSE 子句允许您显式关闭到远程服务器的连接。当远程连接处于非活动状态或不再需要时，您会发现此功能很有用。

以下 SQL 语句是等效的，均可关闭到远程服务器的当前连接：

ALTER SERVER server-name CONNECTION CLOSE

ALTER SERVER server-name CONNECTION CLOSE CURRENT

您可以使用此语法关闭到远程服务器的 ODBC 连接和 JDBC 连接。执行这些语句不需要 DBA 权限。

您还可以通过指定连接 ID 来断开特定远程 ODBC 连接，或通过指定 ALL 关键字来断开所有远程 ODBC 连接。如果试图通过指定连接 ID 或 ALL 关键字来关闭 JDBC 连接，则会发生错误。如果由 connection-id 标识的连接不是当前本地连接，则用户必须具有 DBA 权限才能够关闭该连接。

用法

ALTER SERVER 语句修改服务器的属性。这些更改直到下一次与远程服务器连接时才生效。

权限

必须有 RESOURCE 权限。

副作用

自动提交。

另请参见

标准和兼容性

SQL/92 供应商扩展。
SQL/99 供应商扩展。
Sybase 受 Open Client/Open Server 支持。

示例

下面的示例更改名为 ase_prod 的 Adaptive Server 的服务器类，使该服务器与 Adaptive Server Anywhere 的连接基于 ODBC。其数据源名为 ase_prod。

ALTER SERVER ase_prod
CLASS 'ASEODBC'
USING 'ase_prod'

下面的示例更改服务器 infodc 的功能。

ALTER SERVER infodc
CAPABILITY 'insert select' OFF

下面的示例可关闭到远程服务器 rem_test 的所有连接。

ALTER SERVER rem_test
CONNECTION CLOSE ALL

下面的示例可关闭到远程服务器 rem_test、连接 ID 为 142536 的连接。

ALTER SERVER rem_test
CONNECTION CLOSE 142536