ALTER ENDPOINT (Transact-SQL)

Permet de modifier un point de terminaison existant selon plusieurs procédures :

• en ajoutant une nouvelle méthode à un point de terminaison existant ;
• en modifiant ou supprimant une méthode existante du point de terminaison ;
• en modifiant les propriétés d'un point de terminaison.

Remarque :
Cette rubrique décrit la syntaxe et les arguments spécifiques à ALTER ENDPOINT. Pour connaître les arguments communs à CREATE ENDPOINT et ALTER ENDPOINT (y compris tous les éléments spécifiques aux protocoles HTTP et TCP et spécifiques à la charge utile SOAP, TSQL, SERVICE_BROKER et DATABASE_MIRRORING), consultez CREATE ENDPOINT (Transact-SQL).

Conventions de la syntaxe de Transact-SQL

Syntaxe

ALTER ENDPOINT endPointName [ AUTHORIZATION login ]
 [ STATE = { STARTED | STOPPED | DISABLED } ]
AS { TCP | HTTP } (
   <protocol_specific_items>
        )
FOR { SOAP | TSQL | SERVICE_BROKER | DATABASE_MIRRORING } (
   <language_specific_items>
        )

<AS HTTP_protocol_specific_arguments> ::=
AS HTTP (
  [ [ , ] PATH = 'url' ]
  [ [ , ] PORTS = ( { CLEAR | SSL } [ ,...n ] ) ]
  [ [ , ] SITE = { '*' | '+' | 'webSite' } , ]
  [ [ , ] CLEAR_PORT = clearPort ]
  [ [ , ] SSL_PORT = SSLPort ]
  [ [,] AUTHENTICATION = ( { BASIC | DIGEST | NTLM | KERBEROS | INTEGRATED } [ ,...n ] ) ]
  [ [ , ] AUTH_REALM = { 'realm' | NONE } ]
  [ [ , ] DEFAULT_LOGON_DOMAIN = { 'domain' | NONE } ]
  [ [ , ] COMPRESSION = { ENABLED | DISABLED } ]
)

<AS TCP_protocol_specific_arguments> ::=
AS TCP (
  LISTENER_PORT = listenerPort
  [ [ , ] LISTENER_IP = ALL | ( 4-part-ip ) | ( "ip_address_v6" ) ]
)

<FOR SOAP_language_specific_arguments> ::=
FOR SOAP (
  [ { ADD WEBMETHOD [ 'namespace' .] 'method_alias' 
    (   NAME = 'database.owner.name'
      [ , SCHEMA = {NONE | STANDARD | DEFAULT } ]
      [ , FORMAT = { ALL_RESULTS | ROWSETS_ONLY | NONE} ]
    )  
  } [ ,...n ] 
  ]

  [ { ALTER WEBMETHOD [ 'namespace' .] 'method_alias' 
    (   NAME = 'database.owner.name'
      [ , SCHEMA = {NONE | STANDARD | DEFAULT} ]
      [ , FORMAT = { ALL_RESULTS | ROWSETS_ONLY } ]
    )  
  } [ ,...n] 
]
  [ [ , ] { DROP WEBMETHOD [ 'namespace' .] 'method_alias' } [ ,...n ] ]
  [ [ , ] BATCHES = { ENABLED | DISABLED } ]
  [ [ , ] WSDL = { NONE | DEFAULT | 'sp_name' } ]
  [ [ , ] SESSIONS = { ENABLED | DISABLED } ]
  [ [ , ] LOGIN_TYPE = { MIXED | WINDOWS } ]
  [ [ , ] SESSION_TIMEOUT = timeoutInterval ]
  [ [ , ] DATABASE = { 'database_name' | DEFAULT } ]
  [ [ , ] NAMESPACE = { 'namespace' | DEFAULT } ]
  [ [ , ] SCHEMA = { NONE | STANDARD } ]
  [ [ , ] CHARACTER_SET = { SQL | XML } ]
  [ [ , ] HEADER_LIMIT = int ]
)

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

Arguments

Remarque :
Les arguments suivants sont spécifiques à ALTER ENDPOINT. Pour connaître les arguments communs à CREATE ENDPOINT et ALTER ENDPOINT (y compris tous les éléments spécifiques aux protocoles HTTP et TCP et spécifiques à la charge utile SOAP, TSQL, SERVICE_BROKER et DATABASE_MIRRORING), consultez CREATE ENDPOINT (Transact-SQL).

• ADD WEBMETHOD
  Ajoute un point de terminaison de méthode.

  Important :
  Lorsque vous utilisez ADD WEBMETHOD pour exposer des méthodes, vous devez vérifier qu'il n'y a pas de chevauchement de noms si plusieurs bases de données SQL Server sont desservies par le même point de terminaison HTTP. Pour éviter ce problème, pensez à ajouter l'URL de votre nom de domaine inscrit dans le chemin d'accès de l'espace de noms.

• ALTER WEBMETHOD
  Modifie la définition d’un point de terminaison de méthode existant.

• DROP WEBMETHOD
  Supprime un point de terminaison de méthode existant.

Notes

Lorsque vous utilisez ALTER ENDPOINT, spécifiez uniquement les paramètres que vous souhaitez mettre à jour. Toutes les propriétés d'un point de terminaison existant restent inchangées tant que vous ne les modifiez pas explicitement.

Il n'est pas possible d'exécuter d'instructions ENDPOINT DDL à l'intérieur d'une transaction utilisateur.

Pour obtenir des informations sur le choix d'un algorithme de chiffrement à utiliser avec un point de terminaison, consultez Choix d'un algorithme de chiffrement.

Remarque :
RC4 est un algorithme relativement faible, et AES est un algorithme relativement fort. Toutefois, AES est considérablement plus lent que RC4. Si vous considérez que la sécurité est une priorité plus importante que la vitesse, nous vous recommandons d'utiliser AES.

Autorisations

L'utilisateur doit être membre du rôle serveur fixe sysadmin, propriétaire du point de terminaison ou bénéficier de l'autorisation ALTER ANY ENDPOINT.

Pour modifier l'appartenance d'un point de terminaison existant, vous devez utiliser l'instruction ALTER AUTHORIZATION. Pour plus d'informations, consultez ALTER AUTHORIZATION (Transact-SQL).

Pour plus d'informations, consultez GRANT – octroi d'autorisations de point de terminaison (Transact-SQL).

Exemples

A. Ajout d'une nouvelle méthode à un point de terminaison existant

L'exemple suivant ajoute une nouvelle méthode au point de terminaison sql_endpoint créé précédemment.

ALTER ENDPOINT sql_endpoint
FOR SOAP
(
  ADD WEBMETHOD 'SayHello' (name='AdventureWorks.dbo.SayHello')
);

B. Ajout d'une nouvelle méthode fonctionnant en mode RAW SOAP

L'exemple suivant ajoute une nouvelle méthode Web ReportUsageStats qui fonctionne en mode RAW, spécifiée par FORMAT=NONE, pour fournir les résultats d'une procédure stockée telle quelle aux clients SOAP. Pour plus d'informations, consultez la description de l'option FORMAT dans CREATE ENDPOINT (Transact-SQL).

ALTER ENDPOINT sql_endpoint
FOR SOAP
(
  ADD WEBMETHOD 'ReportUsageStats' (name='myDatabase.dbo.sp_reportserverstats', FORMAT=NONE)
);

Voir aussi

Référence

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

Autres ressources

Exemples d'applications XML

Aide et Informations

Assistance sur SQL Server 2005