ALTER ENDPOINT (Transact-SQL)

Область применения:SQL Server

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

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

Примечание.

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

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

Соглашения о синтаксисе 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 недоступен в 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 Endpoint Permissions.