ALTER ENDPOINT (Transact-SQL)

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

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

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

  • 更改端点的属性。

备注

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

从 SQL Server 2012 开始,删除了本机 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 }
)

参数

备注

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

  • AS { TCP }
    无法使用 ALTER ENDPOINT 更改传输协议。

  • AUTHORIZATION login
    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 和更高版本中,可以通过任何兼容级别对使用 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)