ALTERAR ENDPOINT (Transact-SQL)

Aplica-se a: SQL Server

Permite modificar um endpoint existente das seguintes formas:

• Adicionando um novo método a um endpoint existente.
• Modificando ou eliminando um método existente do endpoint.
• Alterando as propriedades de um endpoint.

Os Serviços Web XML Nativos (endpoints SOAP/HTTP) são removidos a partir do SQL Server 2012 (11.x).

Transact-SQL convenções de sintaxe

Syntax

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

Arguments

Os seguintes argumentos são específicos de ALTER ENDPOINT. Para descrições dos argumentos restantes, veja CRIAR ENDPOINT.

AS {TCP }

Não pode alterar o protocolo de transporte com ALTER ENDPOINT.

Login 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.

PARA { TSQL | SERVICE_BROKER | DATABASE_MIRRORING }

Não podes alterar o tipo de carga útil com ALTER ENDPOINT.

Observações

Quando usares ALTER ENDPOINT, especifica apenas os parâmetros que queres atualizar. Todas as propriedades de um endpoint existente mantêm-se iguais, a menos que as altere explicitamente.

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

Para informações sobre a escolha de um algoritmo de encriptação para utilização com um endpoint, veja Escolher um algoritmo de encriptação.

Algoritmo RC4 obsoleto

O algoritmo RC4 só é suportado para compatibilidade com versões anteriores. O novo material só pode ser encriptado utilizando RC4 ou RC4_128 quando a base de dados estiver no nível de compatibilidade 90 ou 100. (Não recomendado.) Em vez disso, use um algoritmo mais recente, como um dos algoritmos AES. Em versões SQL Server 2012 (11.x) e posteriores, material encriptado usando RC4 ou RC4_128 pode ser desencriptado em qualquer nível de compatibilidade.

Permissões

Requer pertença ao papel fixo de servidor de sysadmin , o proprietário do endpoint ou ALTER ANY ENDPOINT permissão.

Para alterar a propriedade de um endpoint existente, deve usar a ALTER AUTHORIZATION instrução. Para mais informações, consulte ALTER AUTHORIZATION.

Para mais informações, consulte Permissões de Endpoint GRANT.

Conteúdo relacionado

• ELIMINAR PONTO DE LIGAÇÃO (Transact-SQL)
• EVENTDATA (Transact-SQL)