ALTER ENDPOINT (Transact-SQL)

Si applica a:SQL Server

Consente di modificare un endpoint esistente tramite:

• L'aggiunta di un nuovo metodo a un endpoint esistente.
• La modifica o l'eliminazione di un metodo esistente dall'endpoint.
• La modifica delle proprietà di un endpoint.

I servizi Web XML nativi (endpoint SOAP/HTTP) verranno eliminati a partire da SQL Server 2012 (11.x).

Convenzioni relative alla sintassi Transact-SQL

Sintassi

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

Argomenti

Gli argomenti seguenti sono specifici di ALTER ENDPOINT. Per le descrizioni degli argomenti rimanenti, vedere CREATE ENDPOINT.

AS { TCP }

Non è possibile modificare il protocollo di trasporto con ALTER ENDPOINT.

LOGIN AUTHORIZATION

L'opzione AUTHORIZATION non è disponibile in ALTER ENDPOINT. La proprietà può essere assegnata solo quando l'endpoint viene creato.

FOR { TSQL | SERVICE_BROKER | DATABASE_MIRRORING }

Non è possibile modificare il tipo di payload con ALTER ENDPOINT.

Osservazioni:

Quando si usa ALTER ENDPOINT, specificare solo i parametri da aggiornare. Tutte le proprietà di un endpoint esistente rimangono invariate a meno che non vengano modificate in modo esplicito.

Le ENDPOINT DDL istruzioni non possono essere eseguite all'interno di una transazione utente.

Per informazioni sulla scelta di un algoritmo di crittografia da usare con un endpoint, vedere Scegliere un algoritmo di crittografia.

Algoritmo RC4 deprecato

L'algoritmo RC4 è supportato solo per motivi di compatibilità con le versioni precedenti. È possibile crittografare il nuovo materiale usando RC4 o RC4_128 solo quando il livello di compatibilità del database è 90 o 100. (Non consigliato.) Usare un algoritmo più recente, ad esempio uno degli algoritmi AES. In SQL Server 2012 (11.x) e versioni successive il materiale crittografato con RC4 o RC4_128 può essere decrittografato in qualsiasi livello di compatibilità.

Autorizzazioni

Richiede l'appartenenza al ruolo predefinito del server sysadmin , al proprietario dell'endpoint o ALTER ANY ENDPOINT all'autorizzazione.

Per modificare la proprietà di un endpoint esistente, è necessario usare l'istruzione ALTER AUTHORIZATION . Per altre informazioni, vedere ALTER AUTHORIZATION.

Per altre informazioni, vedere GRANT Endpoint Permissions.For more information, see GRANT Endpoint Permissions.

Contenuti correlati

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