次の方法で共有


ALTER ROUTE (Transact-SQL)

更新 : 2007 年 9 月 15 日

既存のルートに関するルート情報を変更します。

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

構文

 ALTER ROUTE route_name WITH     [ SERVICE_NAME = 'service_name' [ , ] ]   [ BROKER_INSTANCE = 'broker_instance' [ , ] ]   [ LIFETIME = route_lifetime [ , ] ]   [ ADDRESS =  'next_hop_address' [ , ] ]   [ MIRROR_ADDRESS = 'next_hop_mirror_address' ] [ ; ] 

引数

  • route_name
    変更するルートの名前を指定します。サーバー名、データベース名、スキーマ名は指定できません。
  • WITH
    変更するルート情報を定義するための句を、WITH の後に指定します。
  • SERVICE_NAME ='service_name'
    このルートが示すリモート サービスの名前を指定します。service_name はリモート サービスで使用される名前と正確に一致する必要があります。Service Broker では、service_name がバイト単位で照合されます。つまり、この場合、大文字小文字は区別され、現在の照合順序は考慮されません。'SQL/ServiceBroker/BrokerConfiguration' というサービス名を持つルートは、Broker Configuration Notice サービスへのルートです。このサービスへのルートは、ブローカ インスタンスを指定できません。

    SERVICE_NAME 句を省略した場合、ルートのサービス名は変更されません。

  • BROKER_INSTANCE ='broker_instance'
    対象サービスをホストするデータベースを指定します。broker_instance パラメータは、リモート データベース用のブローカ インスタンス識別子である必要があります。これは選択したデータベースで次のクエリを実行することにより取得できます。

    SELECT service_broker_guid
    FROM sys.databases
    WHERE database_id = DB_ID()
    

    BROKER_INSTANCE 句を省略した場合、ルートのブローカ インスタンスは変更されません。

  • LIFETIME **=**route_lifetime
    SQL Server がルーティング テーブルにルートを保持する時間を秒単位で指定します。有効期間が終了するとルートは期限切れとなり、SQL Server では、新しいメッセージ交換用のルートを選択するときに、そのルートは考慮されなくなります。この句を省略した場合、ルートの有効期限は変更されません。
  • ADDRESS **='**next_hop_address'
    ルート用のネットワーク アドレスを指定します。next_hop_address には、次の形式で TCP/IP アドレスを指定します。

    TCP:// { dns_name | netbios_name |ip_address } : port_number

    指定した port_number は、指定したコンピュータにおける SQL Server インスタンスの Service Broker エンドポイント用のポート番号と一致する必要があります。これは選択したデータベースで次のクエリを実行することにより取得できます。

    SELECT tcpe.port
    FROM sys.tcp_endpoints AS tcpe
    INNER JOIN sys.service_broker_endpoints AS ssbe
       ON ssbe.endpoint_id = tcpe.endpoint_id
    WHERE ssbe.name = N'MyServiceBrokerEndpoint';
    

    ルートの next_hop_address'LOCAL' になっている場合、メッセージは現在の SQL Server インスタンス内のサービスに配信されます。

    ルートの next_hop_address'TRANSPORT'' になっている場合、ネットワーク アドレスは、サービス名の中にあるネットワーク アドレスに基づいて決まります。'TRANSPORT' を指定するルートは、サービス名またはブローカ インスタンスを指定できます。

    next_hop_address にデータベース ミラーのプリンシパル サーバーを指定した場合は、ミラー サーバーの MIRROR_ADDRESS も指定する必要があります。それ以外の場合、このルートではミラー サーバーへの自動フェールオーバーは行われません。

  • MIRROR_ADDRESS ='next_hop_mirror_address'
    next_hop_address にプリンシパル サーバーを指定した場合に、ミラー化の対象となるミラー サーバーのネットワーク アドレスを指定します。next_hop_mirror_address には、次の形式で TCP/IP アドレスを指定します。

    TCP://{ dns_name | netbios_name | ip_address } **:**port_number

    指定した port_number は、指定したコンピュータにおける SQL Server インスタンスの Service Broker エンドポイント用のポート番号と一致する必要があります。これは選択したデータベースで次のクエリを実行することにより取得できます。

    SELECT tcpe.port
    FROM sys.tcp_endpoints AS tcpe
    INNER JOIN sys.service_broker_endpoints AS ssbe
       ON ssbe.endpoint_id = tcpe.endpoint_id
    WHERE ssbe.name = N'MyServiceBrokerEndpoint';
    

    MIRROR_ADDRESS が指定されている場合、ルートには SERVICE_NAME 句と BROKER_INSTANCE 句を指定する必要があります。ルートの next_hop_address'LOCAL' または 'TRANSPORT' になっている場合、そのルートではミラー アドレスを指定できません。

解説

ルートを格納するルーティング テーブルは、sys.routes カタログ ビューを使用して読み取ることができるメタデータ テーブルです。このルーティング テーブルは、CREATE ROUTE、ALTER ROUTE、および DROP ROUTE ステートメントでのみ更新できます。

ALTER ROUTE コマンドで指定できない句に関する情報は、変更されません。したがって、ALTER を使用して、ルートのタイムアウトを無効にしたり、ルートをすべてのサービス名やブローカ インスタンスと照合するような変更はできません。このようなルート情報を変更するには、既存のルートを削除して新しいルートを作成し、新しい情報を指定する必要があります。

ルートの next_hop_address'TRANSPORT' の場合、ネットワーク アドレスはサービスの名前に基づいて決定されます。SQL Server では、next_hop_address のネットワーク アドレスが有効な形式であれば、このネットワーク アドレスで始まるサービス名が適切に処理されます。名前に有効なネットワーク アドレスが含まれているサービスは、そのサービス名のネットワーク アドレスにルートされます。

ルートで指定されているサービス、ネットワーク アドレス、およびブローカ インスタンス識別子が同じであれば、ルーティング テーブルにはルートをいくつでも含めることができます。このような場合、Service Broker でルートを選択するときには、メッセージ交換で指定された情報とルーティング テーブル内の情報を照合して、最も正確に一致する情報を取得するためのプロシージャが使用されます。Service Broker がルートを選択する方法の詳細については、「Service Broker のルーティングとネットワーク」を参照してください。

サービスの AUTHORIZATION を変更するには、ALTER AUTHORIZATION ステートメントを使用します。

権限

既定では、ルートを変更する権限は、ルートの所有者、db_ddladmin 固定データベース ロールまたは db_owner 固定データベース ロールのメンバ、および sysadmin 固定サーバー ロールのメンバに与えられています。

A. ルートのサービスを変更する

次の例では、ExpenseRoute ルートが示すサービスを、リモート サービス //Adventure-Works.com/Expenses に変更します。

ALTER ROUTE ExpenseRoute
   WITH 
     SERVICE_NAME = '//Adventure-Works.com/Expenses'

B. ルートの対象データベースを変更する

次の例では、ExpenseRoute ルートの対象データベースを、一意識別子 D8D4D268-00A3-4C62-8F91-634B89B1E317. によって指定されるデータベースに変更します。

ALTER ROUTE ExpenseRoute
   WITH 
     BROKER_INSTANCE = 'D8D4D268-00A3-4C62-8F91-634B89B1E317'

C. ルートのアドレスを変更する

次の例では、ExpenseRoute ルートのネットワーク アドレスを、ホスト IP アドレス 10.2.19.72、TCP ポート 1234 に変更します。

ALTER ROUTE ExpenseRoute 
   WITH 
     ADDRESS = 'TCP://10.2.19.72:1234'

D. ルートのデータベースとアドレスを変更する

次の例では、ExpenseRoute ルートのネットワーク アドレスを、ホスト DNS 名 www.Adventure-Works.com、TCP ポート 1234 に変更し、対象データベースを、一意識別子 D8D4D268-00A3-4C62-8F91-634B89B1E317 によって指定されるデータベースに変更します。

ALTER ROUTE ExpenseRoute
   WITH 
     BROKER_INSTANCE = 'D8D4D268-00A3-4C62-8F91-634B89B1E317',
     ADDRESS = 'TCP://www.Adventure-Works.com:1234'

参照

関連項目

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

その他の技術情報

Service Broker のルーティング

ヘルプおよび情報

SQL Server 2005 の参考資料の入手

変更履歴

リリース 履歴

2007 年 9 月 15 日

変更内容 :
  • ADDRESS 引数や MIRROR_ADDRESS 引数に指定するエンドポイント ポート アドレスの検索方法を示すサンプル クエリを追加しました。