ALTER ROUTE (Transact-SQL)

[アーティクル]
06/18/2013

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

構文

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 でルートを選択するときには、メッセージ交換で指定された情報とルーティングテーブル内の情報を照合して、最も正確に一致する情報を取得するためのプロシージャが使用されます。

サービスの 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'

次の方法で共有

ALTER ROUTE (Transact-SQL)

構文

引数

説明

権限

使用例

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

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

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

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

関連項目

参照

その他のリソース