分享方式:


CREATE ROUTE (Transact-SQL)

適用於:SQL Server Azure SQL 受控執行個體

將新的路由加入目前資料庫的路由表中。 如果是外寄郵件,Service Broker 會檢查本機資料庫中的路由表來判斷路由。 如果是另一個執行個體所引發交談的訊息,其中包括要轉寄的訊息,Service Broker 會檢查 msdb 中的路由。

Transact-SQL 語法慣例

語法

CREATE ROUTE route_name  
[ AUTHORIZATION owner_name ]  
WITH    
   [ SERVICE_NAME = 'service_name', ]  
   [ BROKER_INSTANCE = 'broker_instance_identifier' , ]  
   [ LIFETIME = route_lifetime , ]  
   ADDRESS =  'next_hop_address'  
   [ , MIRROR_ADDRESS = 'next_hop_mirror_address' ]  
[ ; ]  

引數

route_name
這是要建立的路由名稱。 新路由會建立在目前的資料庫中,擁有者是 AUTHORIZATION 子句所指定的主體。 您不可指定伺服器、資料庫和結構描述名稱。 route_name 必須是有效的 sysname

AUTHORIZATION owner_name
將路由的擁有者設為指定的資料庫使用者或角色。 當目前使用者是 db_owner 固定資料庫角色的成員或 sysadmin 固定伺服器角色的成員時,owner_name 可以是任何有效使用者或角色的名稱。 否則,owner_name 必須是目前使用者的名稱、目前使用者有其 IMPERSONATE 權限的使用者名稱,或目前使用者所屬的角色名稱。 當略過這個子句時,路由會屬於目前的使用者。

WITH
導入定義所建立之路由的子句。

SERVICE_NAME = 'service_name'
指定這個路由所指向的遠端服務名稱。 service_name 必須與遠端服務所使用的名稱完全相符。 Service Broker 會使用逐一位元組比較方式來比對 service_name。 換言之,這項比較會區分大小寫,且不會考慮目前的定序。 如果省略 SERVICE_NAME,這個路由會符合任何服務名稱,但符合的優先權低於指定 SERVICE_NAME 的路由。 服務名稱是 'SQL/ServiceBroker/BrokerConfiguration' 的路由,是指向 Broker Configuration Notice 服務的路由。 指向這項服務的路由不能指定 Broker 執行個體。

BROKER_INSTANCE = 'broker_instance_identifier'
指定主控目標服務的資料庫。 broker_instance_identifier 參數必須是遠端資料庫的 Broker 執行個體識別碼,您可以在所選資料庫中執行下列查詢來取得這個識別碼:

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

當省略 BROKER_INSTANCE 子句時,這項路由會符合任何 Broker 執行個體。 當交談並未指定 Broker 執行個體時,符合任何 Broker 執行個體的路由,其相符優先權會高於含明確 Borker 執行個體的路由。 如果交談指定了 Broker 執行個體,含 Borker 執行個體的路由之優先權會高於符合任何 Broker 執行個體的路由。

LIFETIME =route_lifetime
指定 SQL Server 將路由保留在路由表中的時間量 (以秒為單位)。 在存留期間結束時,路由會到期,SQL Server 在選擇新交談的路由時,不會再考慮這個路由。 如果省略這個子句,route_lifetime 便是 NULL,且路由永遠不會到期。

ADDRESS ='next_hop_address'
針對 SQL 受控執行個體,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';  

當服務在鏡像資料庫中,您也必須指定主控鏡像資料庫之其他執行個體的 MIRROR_ADDRESS。 否則,這個路由不會進行容錯移轉,將工作交給鏡像。

當路由在 next_hop_address 中指定 'LOCAL' 時,訊息會傳遞給在目前 SQL Server 執行個體內的服務。

當路由在 next_hop_address 中指定 'TRANSPORT' 時,會根據服務名稱中的網路位址來決定網路位址。 指定 'TRANSPORT' 的路由不能指定服務名稱或 Broker 執行個體。

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 陳述式來更新這個目錄檢視。

依預設,每個使用者資料庫中的路由表都包含一個路由。 這個路由的名稱是 AutoCreatedLocal。 這個路由在 next_hop_address 中指定 'LOCAL' ,且會比對任何服務名稱和 Broker 執行個體識別碼。

當路由在 next_hop_address 中指定 'TRANSPORT' 時,會根據服務名稱來決定網路位址。 SQL Server 可以順利處理開頭是網路位址且格式對 next_hop_address 有效的服務名稱。

路由表可以包含指定相同服務、網路位址和 Broker 執行個體識別碼之任意數目的路由。 在這個情況下,Service Broker 會利用在交談所指定的資訊和路由表所指定的資訊之間,設計用來尋找完全相符項目的程序,來選擇路由。

Service Broker 不會從路由表移除過期的路由。 您可以利用 ALTER ROUTE 陳述式,使過期的路由成為在使用中。

路由不能是暫存物件。 您可以使用開頭是 # 的路由名稱,但它們是永久物件。

權限

建立路由的權限預設為 db_ddladmindb_owner 固定資料庫角色的成員,以及 sysadmin 固定伺服器角色的成員。

範例

A. 使用 DNS 名稱來建立 TCP/IP 路由

下列範例會建立服務 //Adventure-Works.com/Expenses 的路由。 這個路由指定送往這項服務的訊息要通過 TCP 而到達 DNS 名稱 1234 所識別之主機的通訊埠 www.Adventure-Works.com。 目標伺服器會在到達時將訊息傳遞給唯一識別碼 D8D4D268-00A3-4C62-8F91-634B89C1E315 所識別的 Broker 執行個體。

CREATE ROUTE ExpenseRoute  
    WITH  
    SERVICE_NAME = '//Adventure-Works.com/Expenses',  
    BROKER_INSTANCE = 'D8D4D268-00A3-4C62-8F91-634B89C1E315',  
    ADDRESS = 'TCP://www.Adventure-Works.com:1234' ;  

B. 使用 NetBIOS 名稱來建立 TCP/IP 路由

下列範例會建立服務 //Adventure-Works.com/Expenses 的路由。 這個路由指定送往這項服務的訊息要通過 TCP 而到達 NetBIOS 名稱 1234 所識別之主機的通訊埠 SERVER02。 在到達時,目標 SQL Server 會將訊息傳遞給依據唯一識別碼 D8D4D268-00A3-4C62-8F91-634B89C1E315 識別的資料庫執行個體。

CREATE ROUTE ExpenseRoute  
    WITH   
    SERVICE_NAME = '//Adventure-Works.com/Expenses',  
    BROKER_INSTANCE = 'D8D4D268-00A3-4C62-8F91-634B89C1E315',  
    ADDRESS = 'TCP://SERVER02:1234' ;  

C. 使用 IP 位址來建立 TCP/IP 路由

下列範例會建立服務 //Adventure-Works.com/Expenses 的路由。 這個路由指定送往這項服務的訊息要通過 TCP 而到達在 IP 位址 1234 之主機的通訊埠 192.168.10.2。 在到達時,目標 SQL Server 會將訊息傳遞給依據唯一識別碼 D8D4D268-00A3-4C62-8F91-634B89C1E315 來識別的 Broker 執行個體。

CREATE ROUTE ExpenseRoute  
    WITH  
    SERVICE_NAME = '//Adventure-Works.com/Expenses',  
    BROKER_INSTANCE = 'D8D4D268-00A3-4C62-8F91-634B89C1E315',  
    ADDRESS = 'TCP://192.168.10.2:1234' ;  

D. 建立通往轉送 Broker 的路由

下列範例會建立通往伺服器 dispatch.Adventure-Works.com 之轉送 Broker 的路由。 由於既未指定服務名稱,也未指定 Broker 執行個體識別碼,因此,SQL Server 會將這個路由用在未定義任何其他路由的服務上。

CREATE ROUTE ExpenseRoute  
    WITH  
    ADDRESS = 'TCP://dispatch.Adventure-Works.com' ;   

E. 建立通往本機服務的路由

下列範例會建立通往與路由位於相同執行個體之服務 //Adventure-Works.com/LogRequests 的路由。

CREATE ROUTE LogRequests  
    WITH  
    SERVICE_NAME = '//Adventure-Works.com/LogRequests',  
    ADDRESS = 'LOCAL' ;  

F. 建立含指定存留期間的路由

下列範例會建立服務 //Adventure-Works.com/Expenses 的路由。 路由的存留期間是 259200 秒,相當於 72 小時。

CREATE ROUTE ExpenseRoute  
    WITH  
    SERVICE_NAME = '//Adventure-Works.com/Expenses',  
    LIFETIME = 259200,  
    ADDRESS = 'TCP://services.Adventure-Works.com:1234' ;  

G. 建立通往鏡像資料庫的路由

下列範例會建立服務 //Adventure-Works.com/Expenses 的路由。 服務在鏡像的資料庫中。 其中一個鏡像資料庫所在的位址是 services.Adventure-Works.com:1234,另一個資料庫所在的位址是 services-mirror.Adventure-Works.com:1234

CREATE ROUTE ExpenseRoute  
    WITH  
    SERVICE_NAME = '//Adventure-Works.com/Expenses',  
    BROKER_INSTANCE = '69fcc80c-2239-4700-8437-1001ecddf933',  
    ADDRESS = 'TCP://services.Adventure-Works.com:1234',   
    MIRROR_ADDRESS = 'TCP://services-mirror.Adventure-Works.com:1234' ;  

H. 建立使用服務名稱來進行傳遞的路由

下列範例會建立一個路由,利用服務名稱來判斷訊息所要送往的網路位址。 請注意,在網路位址中指定 'TRANSPORT' 的路由,符合的優先權低於其他路由。

CREATE ROUTE TransportRoute  
    WITH ADDRESS = 'TRANSPORT' ;  

另請參閱

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