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 端点)
语法
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 (11.x) 和更高版本中,可以在任何兼容性级别对使用 RC4 或 RC4_128 加密的材料进行解密。
RC4 是一个相对较弱的算法,而 AES 是一个相对较强的算法。 但是 AES 比 RC4 慢得多。 如果安全性的优先级高于速度,则建议使用 AES。
权限
用户必须是 sysadmin 固定服务器角色的成员、端点的所有者,或已被授予 ALTER ANY ENDPOINT 权限。
若要更改现有端点的所有权,必须使用 ALTER AUTHORIZATION 语句。 有关详细信息,请参阅 ALTER AUTHORIZATION (Transact-SQL)。
有关详细信息,请参阅 GRANT 终结点权限 (Transact-SQL)。