ALTER ENDPOINT (Transact-SQL)

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

  • 向现有端点中添加一个新方法
  • 修改或删除端点中的现有方法
  • 更改端点的属性
ms186332.note(zh-cn,SQL.90).gif注意:
本主题描述了特定于 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 }
)

参数

ms186332.note(zh-cn,SQL.90).gif注意:
以下参数特定于 ALTER ENDPOINT。有关对 CREATE ENDPOINT 和 ALTER ENDPOINT 都通用的参数(包括所有 HTTP 协议和 TCP 协议特定的项,以及 SOAP、TSQL、SERVICE_BROKER 和 DATABASE_MIRRORING 负载特定的项)的说明,请参阅 CREATE ENDPOINT (Transact-SQL)
  • ADD WEBMETHOD
    添加一个新的方法端点。

    ms186332.note(zh-cn,SQL.90).gif重要提示:
    使用 ADD WEBMETHOD 公开方法时,必须确保当同一 HTTP 端点服务于多个 SQL Server 数据库时,不会出现名称重叠。若要避免发生这一问题,请考虑在命名空间路径中添加注册域名 URL。
  • ALTER WEBMETHOD
    更改现有方法端点的定义。
  • DROP WEBMETHOD
    删除现有方法端点。

备注

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

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

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

ms186332.note(zh-cn,SQL.90).gif注意:
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)
);

请参阅

参考

CREATE ENDPOINT (Transact-SQL)
DROP ENDPOINT (Transact-SQL)
EVENTDATA (Transact-SQL)

其他资源

示例 XML 应用程序

帮助和信息

获取 SQL Server 2005 帮助