ALTER SERVER 语句

修改远程服务器的属性。由 ALTER SERVER 所做的更改将直到下一次与远程服务器连接时才生效。

快速链接：

转至参数

转至示例

转至用法

转至标准

转至权限

语法

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

server-class - (back to Syntax)
   { SAODBC  
      | ASEODBC
      | DB2ODBC  
      | MSSODBC 
      | ORAODBC  
      | ODBC }

connection-info - (back to Syntax)
   { : [ / ] |  }

参数

cap-name 服务器功能的名称

CLASS 更改服务器类。

USING 如果使用基于 JDBC 的服务器类，则 USING 子句为 : [ / ]，其中： – 是运行远程服务器的计算机。 – 是远程服务器监听的 TCP/IP 端口号。SAP IQ 和 SAP SQL Anywhere 缺省端口号为 2638。 – 对于 SAP SQL Anywhere 远程服务器，如果不指定，则使用缺省数据库。对于 SAP ASE，缺省值为 master 数据库，除使用之外，另一个选择是通过其它某些方法（例如，在 FORWARD TO 语句中）指定另一个数据库。如果使用基于 ODBC 的服务器类，则 USING 子句为，即 ODBC 数据源名称。

– 是运行远程服务器的计算机。

– 是远程服务器监听的 TCP/IP 端口号。SAP IQ 和 SAP SQL Anywhere 缺省端口号为 2638。

– 对于 SAP SQL Anywhere 远程服务器，如果不指定，则使用缺省数据库。对于 SAP ASE，缺省值为 master 数据库，除使用之外，另一个选择是通过其它某些方法（例如，在 FORWARD TO 语句中）指定另一个数据库。

CAPABILITY 将服务器功能设置为 ON 或 OFF。服务器功能存储在系统表 SYSCAPABILITY 中。这些功能的名称存储在系统表 SYSCAPABILITYNAME 中。SYSCAPABILITY 表要等到与远程服务器建立了第一个连接时，才包含对应于该服务器的条目。在第一个连接中，SAP IQ 向服务器询问其功能，然后填充 SYSCAPABILITY。对于后面的连接，系统从该表中获取服务器的功能。通常情况下，不需要变更服务器的功能。可能需要变更 ODBC 类的通用服务器的功能。

CONNECTION CLOSE 当用户创建与远程服务器的连接时，在用户从本地数据库断开连接之前，远程连接不会关闭。CONNECTION CLOSE 子句允许您显式关闭到远程服务器的连接。当远程连接处于非活动状态或不再需要时，您会发现此功能很有用。这些 SQL 语句是等效的，均可关闭到远程服务器的当前连接：ALTER SERVER server-name CONNECTION CLOSEALTER SERVER server-name CONNECTION CLOSE CURRENT可以使用此语法关闭与远程服务器的 ODBC 连接和 JDBC 连接。不需要 SERVER OPERATOR 系统特权便可执行这些语句。还可以通过指定连接 ID 来断开特定远程 ODBC 连接，或通过指定 ALL 关键字来断开所有远程 ODBC 连接。如果试图通过指定连接 ID 或 ALL 关键字来关闭 JDBC 连接，则会发生错误。如果由标识的连接不是当前本地连接，用户必须拥有 SERVER OPERATOR 系统特权才能关闭连接。

示例

示例 1 更改名为 ase_prod 的 SAP ASE 服务器的服务器类，基于 ODBC 建立其与 SAP IQ 的连接。数据源名称为 ase_prod。 ALTER SERVER ase_prodCLASS 'ASEODBC'USING 'ase_prod'

示例 2 更改服务器 infodc 的功能： ALTER SERVER infodcCAPABILITY 'insert select' OFF

示例 3 关闭与名为 rem_test 的远程服务器的所有连接： ALTER SERVER rem_testCONNECTION CLOSE ALL

示例 4 关闭与名为 rem_test 的远程服务器的连接（连接 ID 为 142536）： ALTER SERVER rem_testCONNECTION CLOSE 142536

用法

副作用：

自动提交

标准

SQL - ISO/ANSI SQL 语法的服务商扩展。

SAP 数据库产品 - 受 Open Client/Open Server 支持。

权限

需要 SERVER OPERATOR 系统特权。