ALTER ROUTE (Transact-SQL)

[アーティクル]
12/16/2008

更新 : 2007 年 9 月 15 日

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

構文

 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'

参照

その他の技術情報

Service Broker のルーティング

ヘルプおよび情報

SQL Server 2005 の参考資料の入手

変更履歴

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

次の方法で共有