sql server 2005 T-SQL ALTER ENDPOINT (Transact-SQL)

来源:互联网 发布:oracle和mysql的转换 编辑:程序博客网 时间:2024/03/28 21:33

允许通过以下方法修改现有端点:

  • 向现有端点中添加一个新方法
  • 修改或删除端点中的现有方法
  • 更改端点的属性
注意: 本主题描述了特定于 ALTER ENDPOINT 的语法和参数。有关对 CREATE ENDPOINT 和 ALTER ENDPOINT 都通用的参数(包括所有 HTTP 协议和 TCP 协议特定的项,以及 SOAP、TSQL、SERVICE_BROKER 和 DATABASE_MIRRORING 负载特定的项)的说明,请参阅 CREATE ENDPOINT (Transact-SQL)。

主题链接图标 Transact-SQL 语法约定

ALTER ENDPOINT endPointName [ AUTHORIZATION login ]
[ STATE = { STARTED | STOPPED | DISABLED } ]
AS { TCP | HTTP } (
<protocol_specific_items>
)
FOR { SOAP | TSQL | SERVICE_BROKER | DATABASE_MIRRORING } (
<language_specific_items>
)

<AS HTTP_protocol_specific_arguments> ::=
AS HTTP (
[ [ , ] PATH = 'url' ]
[ [ , ] PORTS = ( { CLEAR | SSL } [ ,...n ] ) ]
[ [ , ] SITE = { '*' | '+' | 'webSite' } , ]
[ [ , ] CLEAR_PORT = clearPort ]
[ [ , ] SSL_PORT = SSLPort ]
[ [,] AUTHENTICATION = ( { BASIC | DIGEST | NTLM | KERBEROS | INTEGRATED } [ ,...n ] ) ]
[ [ , ] AUTH_REALM = { 'realm' | NONE } ]
[ [ , ] DEFAULT_LOGON_DOMAIN = { 'domain' | NONE } ]
[ [ , ] COMPRESSION = { ENABLED | DISABLED } ]
)

<AS TCP_protocol_specific_arguments> ::=
AS TCP (
LISTENER_PORT = listenerPort
[ [ , ] LISTENER_IP = ALL | ( 4-part-ip ) | ( "ip_address_v6" ) ]
)

<FOR SOAP_language_specific_arguments> ::=
FOR SOAP (
[ { ADD WEBMETHOD [ 'namespace' .] 'method_alias'
( NAME = 'database.owner.name'
[ , SCHEMA = {NONE | STANDARD | DEFAULT } ]
[ , FORMAT = { ALL_RESULTS | ROWSETS_ONLY | NONE} ]
)
} [ ,...n ]
]

[ { ALTER WEBMETHOD [ 'namespace' .] 'method_alias'
( NAME = 'database.owner.name'
[ , SCHEMA = {NONE | STANDARD | DEFAULT} ]
[ , FORMAT = { ALL_RESULTS | ROWSETS_ONLY } ]
)
} [ ,...n]
]
[ [ , ] { DROP WEBMETHOD [ 'namespace' .] 'method_alias' } [ ,...n ] ]
[ [ , ] BATCHES = { ENABLED | DISABLED } ]
[ [ , ] WSDL = { NONE | DEFAULT | 'sp_name' } ]
[ [ , ] SESSIONS = { ENABLED | DISABLED } ]
[ [ , ] LOGIN_TYPE = { MIXED | WINDOWS } ]
[ [ , ] SESSION_TIMEOUT = timeoutInterval ]
[ [ , ] DATABASE = { 'database_name' | DEFAULT } ]
[ [ , ] NAMESPACE = { 'namespace' | DEFAULT } ]
[ [ , ] SCHEMA = { NONE | STANDARD } ]
[ [ , ] CHARACTER_SET = { SQL | XML } ]
[ [ , ] HEADER_LIMIT = int ]
)

<FOR SERVICE_BROKER_language_specific_arguments> ::=
FOR SERVICE_BROKER (
[ AUTHENTICATION = {
WINDOWS [ { NTLM | KERBEROS | NEGOTIATE } ]
| CERTIFICATE certificate_name
| WINDOWS [ { NTLM | KERBEROS | NEGOTIATE } ] CERTIFICATE certificate_name
| CERTIFICATE certificate_name WINDOWS [ { NTLM | KERBEROS | NEGOTIATE } ]
} ]
[ , ENCRYPTION = { DISABLED
|
{{SUPPORTED | REQUIRED }
[ ALGORITHM { RC4 | AES | AES RC4 | RC4 AES } ] }
]

[ , MESSAGE_FORWARDING = {ENABLED | DISABLED} ]
[ , MESSAGE_FORWARD_SIZE = forwardSize
)

<FOR DATABASE_MIRRORING_language_specific_arguments> ::=
FOR DATABASE_MIRRORING (
[ AUTHENTICATION = {
WINDOWS [ { NTLM | KERBEROS | NEGOTIATE } ]
| CERTIFICATE certificate_name
| WINDOWS [ { NTLM | KERBEROS | NEGOTIATE } ] CERTIFICATE certificate_name
| CERTIFICATE certificate_name WINDOWS [ { NTLM | KERBEROS | NEGOTIATE } ]
} ]
[ , ENCRYPTION = { DISABLED
|
{{SUPPORTED | REQUIRED }
[ ALGORITHM { RC4 | AES | AES RC4 | RC4 AES } ] }
]
[ , ] ROLE = { WITNESS | PARTNER | ALL }
)
注意: 以下参数特定于 ALTER ENDPOINT。有关对 CREATE ENDPOINT 和 ALTER ENDPOINT 都通用的参数(包括所有 HTTP 协议和 TCP 协议特定的项,以及 SOAP、TSQL、SERVICE_BROKER 和 DATABASE_MIRRORING 负载特定的项)的说明,请参阅 CREATE ENDPOINT (Transact-SQL)。
ADD WEBMETHOD

添加一个新的方法端点。

重要提示: 使用 ADD WEBMETHOD 公开方法时,必须确保当同一 HTTP 端点服务于多个 SQL Server 数据库时,不会出现名称重叠。若要避免发生这一问题,请考虑在命名空间路径中添加注册域名 URL。
ALTER WEBMETHOD

更改现有方法端点的定义。

DROP WEBMETHOD

删除现有方法端点。

使用 ALTER ENDPOINT 时,请仅指定要更新的参数。除非进行显式更改,否则现有端点的所有属性均保持不变。

不能在用户事务中执行 ENDPOINT DDL 语句。

有关选择用于端点的加密算法的信息,请参阅选择加密算法。

注意: RC4 是一个相对较弱的算法,而 AES 是一个相对较强的算法。但是 AES 比 RC4 慢得多。如果安全性的优先级高于速度,则建议使用 AES。

用户必须是 sysadmin 固定服务器角色的成员、端点的所有者,或已被授予了 ALTER ANY ENDPOINT 权限。

若要更改现有端点的所有权,必须使用 ALTER AUTHORIZATION 语句。有关详细信息,请参阅 ALTER AUTHORIZATION (Transact-SQL)。

有关详细信息,请参阅 GRANT 端点权限 (Transact-SQL)。

A. 向现有端点添加新方法

以下示例向以前创建的端点 sql_endpoint 中添加一个新方法。

复制代码
ALTER ENDPOINT sql_endpoint
FOR SOAP
(
ADD WEBMETHOD 'SayHello' (name='AdventureWorks.dbo.SayHello')
);

B. 添加以 RAW SOAP 模式运行的新方法

以下示例添加一个以 RAW 模式运行并由 FORMAT=NONE 指定的新 Web 方法 ReportUsageStats,以将存储过程的结果“按原样”传递给 SOAP 客户端。有关详细信息,请参阅对 CREATE ENDPOINT (Transact-SQL) 中 FORMAT 选项的说明。

复制代码
ALTER ENDPOINT sql_endpoint
FOR SOAP
(
ADD WEBMETHOD 'ReportUsageStats' (name='myDatabase.dbo.sp_reportserverstats', FORMAT=NONE)
);