ALTER ENDPOINT (Transact-SQL)

構文

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

引数

注
次の引数は、ALTER ENDPOINT に固有の引数です。その他の引数の説明については、「CREATE ENDPOINT (Transact-SQL)」を参照してください。

• ADD WEBMETHOD
  新しいメソッド エンドポイントを追加します。

  重要
  ADD WEBMETHOD を使用してメソッドを公開する際には、複数の SQL Server データベースが同じ HTTP エンドポイントによって処理される場合に名前の重複が発生しないようにする必要があります。名前の重複を回避するには、登録済みのドメイン名の URL を、名前空間のパスの一部として追加することをお勧めします。

• ALTER WEBMETHOD
  既存のメソッド エンドポイントの定義を変更します。

• AS { TCP | HTTP }
  ALTER ENDPOINT ではトランスポート プロトコルを変更できません。

• AUTHORIZATIONlogin
  ALTER ENDPOINT では AUTHORIZATION オプションを使用できません。エンドポイントの作成時にのみ所有者を割り当てることができます。

• DROP WEBMETHOD
  既存のメソッド エンドポイントを削除します。

• FOR { SOAP | TSQL | SERVICE_BROKER | DATABASE_MIRRORING }
  ALTER ENDPOINT ではペイロードの種類を変更できません。

説明

ALTER ENDPOINT を使用する場合、更新するパラメーターのみを指定します。既存のエンドポイントのすべてのプロパティは、明示的に変更しない限り変更されません。

ENDPOINT DDL ステートメントは、ユーザー トランザクション内部では実行できません。

エンドポイントに対して使用する暗号化アルゴリズムの選択については、「暗号化アルゴリズムの選択」を参照してください。

注
RC4 は比較的弱いアルゴリズムで、AES は比較的強いアルゴリズムです。しかし、AES は RC4 に比べて非常に処理が遅くなります。速度よりもセキュリティを優先する場合は、AES を使用することをお勧めします。

権限

固定サーバー ロール sysadmin のメンバーであるか、そのエンドポイントの所有者であるか、または ALTER ANY ENDPOINT 権限が許可されている必要があります。

既存のエンドポイントの所有権を変更するには、ALTER AUTHORIZATION ステートメントを使用する必要があります。詳細については、「ALTER AUTHORIZATION (Transact-SQL)」を参照してください。

詳細については、「GRANT (エンドポイントの権限の許可) (Transact-SQL)」を参照してください。

例

A. 新しいメソッドを既存のエンドポイントに追加する

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

B. RAW SOAP モードで動作する新しいメソッドを追加する

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

関連項目

参照

概念