ALTER ENDPOINT (Transact-SQL)

Aplica-se:SQL Server

Habilita a modificação de um ponto de extremidade existente das seguintes formas:

• Adicionando um novo método a um ponto de extremidade existente.
• Modificando ou descartando um método existente do ponto de extremidade.
• Alterando as propriedades de um ponto de extremidade.

Serviços Web XML nativos (pontos de extremidade SOAP/HTTP) são removidos a partir do SQL Server 2012 (11.x).

Convenções de sintaxe de Transact-SQL

Sintaxe

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

Argumentos

Os argumentos a seguir são específicos para ALTER ENDPOINT. Para obter descrições dos argumentos restantes, consulte CREATE ENDPOINT.

AS { TCP }

Não é possível alterar o protocolo de transporte com ALTER ENDPOINT.

Logon de AUTORIZAÇÃO

A AUTHORIZATION opção não está disponível em ALTER ENDPOINT. A propriedade só pode ser atribuída quando o ponto de extremidade é criado.

FOR { TSQL | SERVICE_BROKER | DATABASE_MIRRORING }

Não é possível alterar o tipo de conteúdo com ALTER ENDPOINT.

Comentários

Quando você usa ALTER ENDPOINT, especifique apenas os parâmetros que deseja atualizar. Todas as propriedades de um ponto de extremidade existente permanecem as mesmas, a não ser que você as altere explicitamente.

As ENDPOINT DDL instruções não podem ser executadas dentro de uma transação de usuário.

Para obter informações sobre como escolher um algoritmo de criptografia para uso com um ponto de extremidade, consulte Escolher um algoritmo de criptografia.

Algoritmo RC4 preterido

O algoritmo RC4 tem suporte somente para compatibilidade com versões anteriores. O novo material só pode ser criptografado por meio do algoritmo RC4 ou RC4_128 quando o banco de dados está no nível de compatibilidade 90 ou 100. (Não recomendável.) Use um algoritmo mais recente; por exemplo, um dos algoritmos AES. No SQL Server 2012 (11.x) e em versões posteriores, o material criptografado por meio do algoritmo RC4 ou RC4_128 pode ser descriptografado em qualquer nível de compatibilidade.

Permissões

Requer associação à função de servidor fixa sysadmin , ao proprietário do ponto de extremidade ou ALTER ANY ENDPOINT à permissão.

Para alterar a propriedade de um ponto de extremidade existente, você deve usar a ALTER AUTHORIZATION instrução. Para obter mais informações, consulte ALTER AUTHORIZATION.

Para obter mais informações, consulte Grant Endpoint Permissions.

Conteúdo relacionado

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