通过


ALTER ENDPOINT (Transact-SQL)

适用范围:SQL Server

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

  • 向现有端点中添加一个新方法。
  • 修改或删除端点中的现有方法。
  • 更改端点的属性。

注意

本文介绍特定于 ALTER ENDPOINT.. 有关两者CREATE ENDPOINTALTER ENDPOINT通用的参数的说明,请参阅 CREATE ENDPOINT

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

Transact-SQL 语法约定

语法

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

<AS TCP_protocol_specific_arguments> ::=
AS TCP (
    LISTENER_PORT = listenerPort
    [ [ , ] LISTENER_IP = ALL | ( four_part_ipv4_address ) | ( 'ip_address_v6' ) ]
)

<FOR TSQL_language_specific_arguments> ::=
FOR TSQL (
    [ ENCRYPTION = { NEGOTIATED | STRICT } ]
)

<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 { AES | RC4 | AES RC4 | RC4 AES } ]
    } ]
    [ [ , ] MESSAGE_FORWARDING = { ENABLED | DISABLED } ]
    [ [ , ] MESSAGE_FORWARD_SIZE = forward_size ]
)

<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 { AES | RC4 | AES RC4 | RC4 AES } ]
    } ]
    [ , ] ROLE = { WITNESS | PARTNER | ALL }
)

参数

以下参数特定于 ALTER ENDPOINT. 有关其余参数的说明,请参阅 CREATE ENDPOINT

AS { TCP }

不能使用 ALTER ENDPOINT. 更改传输协议。

AUTHORIZATION login

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

FOR { TSQL |SERVICE_BROKER |DATABASE_MIRRORING }

不能使用 ALTER ENDPOINT. 更改有效负载类型。

备注

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

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

有关选择用于终结点的加密算法的信息,请参阅 “选择加密算法”。

弃用的 RC4 算法

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

权限

需要 sysadmin 固定服务器角色、终结点所有者或 ALTER ANY ENDPOINT 权限的成员身份。

若要更改现有终结点的所有权,必须使用 ALTER AUTHORIZATION 该语句。 有关详细信息,请参阅 ALTER AUTHORIZATION

有关详细信息,请参阅 GRANT 终结点权限