ALTER ENDPOINT (Transact-SQL)

Область применения: SQL Server (все поддерживаемые версии)

Эта инструкция позволяет изменять существующие конечные точки следующими способами.

  • Путем добавления нового метода к существующей конечной точке.

  • Путем изменения или удаления существующего метода из конечной точки.

  • Путем изменения свойств конечной точки.

Примечание

В этом подразделе описаны синтаксис и аргументы, характерные для инструкции ALTER ENDPOINT. Описание аргументов, общих для инструкций CREATE ENDPOINT и ALTER ENDPOINT, см. в статье CREATE ENDPOINT (Transact-SQL).

Собственные XML-веб-службы (конечные точки SOAP/HTTP) удалены, начиная с SQL Server 2012 (11.x).

Topic link iconСинтаксические обозначения в 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 }  
)  
  

Примечание

Ссылки на описание синтаксиса Transact-SQL для SQL Server 2014 и более ранних версий, см. в статье Документация по предыдущим версиям.

Аргументы

Примечание

Следующие аргументы являются характерными для инструкции 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)