ALTER ENDPOINT (Transact-SQL)ALTER ENDPOINT (Transact-SQL)

ОБЛАСТЬ ПРИМЕНЕНИЯ: даSQL Server нетБаза данных SQL Azure нетAzure Synapse Analytics (хранилище данных SQL) нетParallel Data Warehouse APPLIES TO: yesSQL Server noAzure SQL Database noAzure Synapse Analytics (SQL DW) noParallel Data Warehouse

Эта инструкция позволяет изменять существующие конечные точки следующими способами.Enables modifying an existing endpoint in the following ways:

  • Путем добавления нового метода к существующей конечной точке.By adding a new method to an existing endpoint.

  • Путем изменения или удаления существующего метода из конечной точки.By modifying or dropping an existing method from the endpoint.

  • Путем изменения свойств конечной точки.By changing the properties of an endpoint.

Примечание

В этом подразделе описаны синтаксис и аргументы, характерные для инструкции ALTER ENDPOINT.This topic describes the syntax and arguments that are specific to ALTER ENDPOINT. Описание аргументов, общих для инструкций CREATE ENDPOINT и ALTER ENDPOINT, см. в разделе CREATE ENDPOINT (Transact-SQL).For descriptions of the arguments that are common to both CREATE ENDPOINT and ALTER ENDPOINT, see CREATE ENDPOINT (Transact-SQL).

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

Значок ссылки на раздел Синтаксические обозначения в Transact-SQLTopic link icon Transact-SQL Syntax Conventions

СинтаксисSyntax

  
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 }  
)  
  

АргументыArguments

Примечание

Следующие аргументы являются характерными для инструкции ALTER ENDPOINT.The following arguments are specific to ALTER ENDPOINT. Описания остальных аргументов см. в разделе CREATE ENDPOINT (Transact-SQL).For descriptions of the remaining arguments, see CREATE ENDPOINT (Transact-SQL).

AS { TCP }AS { TCP }
Транспортный протокол нельзя изменить с помощью инструкции ALTER ENDPOINT.You cannot change the transport protocol with ALTER ENDPOINT.

AUTHORIZATION loginAUTHORIZATION login
Параметр AUTHORIZATION недоступен в инструкции ALTER ENDPOINT.The AUTHORIZATION option is not available in ALTER ENDPOINT. Владельца можно назначать только в момент создания конечной точки.Ownership can only be assigned when the endpoint is created.

FOR { TSQL | SERVICE_BROKER | DATABASE_MIRRORING }FOR { TSQL | SERVICE_BROKER | DATABASE_MIRRORING }
Тип полезных данных нельзя изменить с помощью инструкции ALTER ENDPOINT.You cannot change the payload type with ALTER ENDPOINT.

ПримечанияRemarks

При использовании ALTER ENDPOINT укажите только те параметры, которые необходимо обновить.When you use ALTER ENDPOINT, specify only those parameters that you want to update. При отсутствии явного изменения все свойства существующей конечной точки остаются прежними.All properties of an existing endpoint remain the same unless you explicitly change them.

Инструкции ENDPOINT DDL внутри пользовательской транзакции выполняться не могут.The ENDPOINT DDL statements cannot be executed inside a user transaction.

Дополнительные сведения о выборе алгоритма шифрования для использования с конечной точкой см. в разделе Выбор алгоритма шифрования.For information on choosing an encryption algorithm for use with an endpoint, see Choose an Encryption Algorithm.

Примечание

Алгоритм RC4 поддерживается только в целях обратной совместимости.The RC4 algorithm is only supported for backward compatibility. Когда база данных имеет уровень совместимости 90 или 100, новые материалы могут шифроваться только с помощью алгоритмов RC4 или RC4_128.New material can only be encrypted using RC4 or RC4_128 when the database is in compatibility level 90 or 100. (Не рекомендуется.) Используйте вместо этого более новые алгоритмы, например AES.(Not recommended.) Use a newer algorithm such as one of the AES algorithms instead. В SQL Server 2012 (11.x)SQL Server 2012 (11.x) и более поздних версиях материалы, зашифрованные с помощью алгоритмов RC4 или RC4_128, могут быть расшифрованы на любом уровне совместимости.In SQL Server 2012 (11.x)SQL Server 2012 (11.x) and later versions, material encrypted using RC4 or RC4_128 can be decrypted in any compatibility level.

RC4 — относительно слабый алгоритм, а AES — относительно сильный.RC4 is a relatively weak algorithm, and AES is a relatively strong algorithm. Однако AES заметно медленнее RC4.But AES is considerably slower than RC4. Если приоритет защиты выше скорости, рекомендуется использовать алгоритм AES.If security is a higher priority for you than speed, we recommend you use AES.

РазрешенияPermissions

Необходимо, чтобы пользователь был членом предопределенной роли сервера sysadmin, владельцем конечной точки или имел разрешение ALTER ANY ENDPOINT.User must be a member of the sysadmin fixed server role, the owner of the endpoint, or have been granted ALTER ANY ENDPOINT permission.

Чтобы изменить принадлежность существующей конечной точки, необходимо применить инструкцию ALTER AUTHORIZATION.To change ownership of an existing endpoint, you must use the ALTER AUTHORIZATION statement. Дополнительные сведения см. в разделе ALTER AUTHORIZATION (Transact-SQL).For more information, see ALTER AUTHORIZATION (Transact-SQL).

Дополнительные сведения см. в разделе GRANT, предоставление разрешений на конечную точку (Transact-SQL).For more information, see GRANT Endpoint Permissions (Transact-SQL).

См. такжеSee Also

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