ALTER ENDPOINT (Transact-SQL)

适用于:SQL Server

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

  • 向现有端点中添加一个新方法。

  • 修改或删除端点中的现有方法。

  • 更改端点的属性。

注意

本主题描述了特定于 ALTER ENDPOINT 的语法和参数。 有关 CREATE ENDPOINT 和 ALTER ENDPOINT 共有参数的说明,请参阅 CREATE ENDPOINT (Transact-SQL)

从 SQL Server 2012 (11.x) 开始,删除了本机 XML Web 服务(SOAP/HTTP 端点)

Transact-SQL 语法约定

语法

  
ALTER ENDPOINT endPointName [ AUTHORIZATION login ]  
[ STATE = { STARTED | STOPPED | DISABLED } ]  
[ AS { TCP } ( <protocol_specific_items> ) ]  
[ FOR { TSQL | SERVICE_BROKER | DATABASE_MIRRORING } (  
   <language_specific_items>  
        ) ]  
  
<AS TCP_protocol_specific_arguments> ::=  
AS TCP (  
  LISTENER_PORT = listenerPort  
  [ [ , ] LISTENER_IP = ALL | ( 4-part-ip ) | ( "ip_address_v6" ) ]  
)  
<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 }  
)  
  

注意

若要查看 SQL Server 2014 (12.x) 及更早版本的 Transact-SQL 语法,请参阅早期版本文档

参数

注意

以下参数特定于 ALTER ENDPOINT。 有关其余参数的说明,请参阅 CREATE ENDPOINT (Transact-SQL)

AS { TCP }
不能使用 ALTER ENDPOINT 更改传输协议。

AUTHORIZATIONlogin
AUTHORIZATION 选项在 ALTER ENDPOINT 中不可用。 只能在创建端点时分配所有权。

FOR { TSQL | SERVICE_BROKER | DATABASE_MIRRORING }
不能使用 ALTER ENDPOINT 更改有效负载类型。

备注

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

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

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

备注

RC4 算法仅用于支持向后兼容性。 仅当数据库兼容级别为 90 或 100 时,才能使用 RC4 或 RC4_128 对新材料进行加密。 (建议不要使用。)而是使用一种较新的算法,如 AES 算法之一。 在 SQL Server 2012 (11.x) 和更高版本中,可以在任何兼容性级别对使用 RC4 或 RC4_128 加密的材料进行解密。

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

权限

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

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

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

另请参阅

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