ALTER ENDPOINT (Transact-SQL)

適用対象:SQL Server

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

• 新しいメソッドを既存のエンドポイントに追加する。
• 既存のメソッドを変更するか、またはエンドポイントから削除する。
• エンドポイントのプロパティを変更する。

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

Transact-SQL 構文表記規則

構文

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

引数

次の引数は、 ALTER ENDPOINTに固有です。 残りの引数の説明については、「 CREATE ENDPOINT」を参照してください。

AS { TCP }

ALTER ENDPOINTを使用してトランスポート プロトコルを変更することはできません。

AUTHORIZATION ログイン

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

FOR { TSQL |SERVICE_BROKER |DATABASE_MIRRORING }

ALTER ENDPOINTを使用してペイロードの種類を変更することはできません。

注釈

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

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

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

非推奨の RC4 アルゴリズム

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

アクセス許可

sysadmin 固定サーバー ロール、エンドポイントの所有者、またはALTER ANY ENDPOINTアクセス許可のメンバーシップが必要です。

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

詳細については、「 GRANT エンドポイントのアクセス許可」を参照してください。

関連するコンテンツ

• エンドポイントを削除 (Transact-SQL)
• EVENTDATA (Transact-SQL)