Compartilhar via


ALTER ENDPOINT (Transact-SQL)

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.

ObservaçãoObservação

Este tópico descreve a sintaxe e os argumentos que são específicos para ALTER ENDPOINT. Para obter descrições dos argumentos que são comuns a CREATE ENDPOINT e a ALTER ENDPOINT, consulte CREATE ENDPOINT (Transact-SQL).

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

Ícone de vínculo de tópico Convenções da sintaxe Transact-SQL

Sintaxe

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

Argumentos

ObservaçãoObservação

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

  • AS { TCP }
    Não é possível alterar o protocolo de transporte com ALTER ENDPOINT.

  • AUTHORIZATION login
    A opção AUTHORIZATION 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 carga com ALTER ENDPOINT.

Comentários

Quando você usar ALTER ENDPOINT, especifique somente 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.

Não podem ser executadas instruções ENDPOINT DDL em 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.

ObservaçãoObservação

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, o material criptografado por meio do algoritmo RC4 ou RC4_128 pode ser descriptografado em qualquer nível de compatibilidade.

RC4 é um algoritmo relativamente fraco e AES é um algoritmo relativamente forte. Mas AES é consideravelmente mais lento do que RC4. Se segurança for uma prioridade mais alta para você do que a velocidade, recomendamos que use AES.

Permissões

O usuário deve ser um membro da função de servidor fixa sysadmin, o proprietário do ponto de extremidade ou ter recebido a permissão ALTER ANY ENDPOINT.

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

Para obter mais informações, consulte Permissões de ponto de extremidade GRANT (Transact-SQL).

Consulte também

Referência

DROP ENDPOINT (Transact-SQL)

EVENTDATA (Transact-SQL)