ALTER ENDPOINT (Transact-SQL)

  • [アーティクル]

既存のエンドポイントを、次の方法で変更できるようにします。

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

  • 既存のメソッドを変更するか、またはエンドポイントから削除する。

  • エンドポイントのプロパティを変更する。

注意注

このトピックでは、ALTER ENDPOINT に固有の構文および引数について説明します。 CREATE ENDPOINT と ALTER ENDPOINT の両方に共通する引数の説明については、「CREATE ENDPOINT (Transact-SQL)」を参照してください。

SQL Server 2012 からは、ネイティブ XML Web サービス (SOAP/HTTP エンドポイント) は削除されます。

トピック リンク アイコン Transact-SQL 構文表記規則

構文

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

引数

注意注

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

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

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

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

説明

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

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

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

注意注

RC4 アルゴリズムは、旧バージョンとの互換性のためにのみサポートされています。 データベース互換性レベルが 90 または 100 の場合、新しい素材は RC4 または RC4_128 を使用してのみ暗号化できます (推奨されません)。AES アルゴリズムのいずれかなど、新しいアルゴリズムを使用してください。 SQL Server 2012 では、どの互換性レベルでも、RC4 または RC4_128 を使用して暗号化された素材を暗号化解除できます。

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

権限

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

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

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

関連項目

参照

DROP ENDPOINT (Transact-SQL)

EVENTDATA (Transact-SQL)