設定可用性群組的唯讀路由 (SQL Server)

若要設定 AlwaysOn 可用性群組以支援 SQL Server 2014 中的唯讀路由，您可以使用 Transact-SQL 或 PowerShell。 唯讀路由是指SQL Server將合格唯讀連線要求路由傳送至可用 AlwaysOn可讀取次要複本的能力，也就是設定為在次要角色下執行時允許唯讀工作負載的 (複本) 。 若要支援唯讀路由，可用性群組必須具有 可用性群組接聽程式。 唯讀用戶端必須將其連線要求導向此接聽程式，且用戶端的連接字串必須將應用程式的意圖指定為「唯讀」。也就是說，其必須是「讀取意圖的連線要求」。

開始之前

必要條件

• 可用性群組必須擁有可用性群組接聽程式。 如需詳細資訊，請參閱建立或設定可用性群組接聽程式 (SQL Server)。

• 一或多個可用性複本必須設定為接受次要角色中的唯讀 (，也就是要 (AlwaysOn%20Availability%20Availability%20Groups) .md) ) 的 可讀取次要複 本。 如需詳細資訊，請參閱設定可用性複本上的唯讀存取 (SQL Server)。

• 您必須連接到裝載目前主要複本的伺服器執行個體。

您必須設定哪些複本屬性，才能支援唯讀路由？

• 每一個要支援唯讀路由之可讀取的次要複本，皆必須指定 「唯讀路由 URL」(Read-Only Routing URL)。 只有在本機複本以次要角色執行時，此 URL 才會生效。 如有必要，您必須各自指定每個複本的唯讀路由 URL。 每個唯讀路由 URL 可用於將讀取意圖的連接要求路由至特定可讀取的次要複本。 一般而言，每個可讀取的次要複本都有一個指派的唯讀路由 URL。

  如需有關計算可用性複本之唯讀路由 URL 的詳細資訊，請參閱 計算 AlwaysOn 的 read_only_routing_url。

• 如果要支援唯讀路由的可用性複本為主要複本時，則必須指定 「唯讀路由清單」(Read-Only Routing List)。 只有本機複本以主要角色執行時，給定的唯讀路由清單才會生效。 如有必要，您必須各自指定每個複本的這份清單。 一般而言，每份唯讀路由清單皆會包含每一個唯讀路由 URL，並在清單結尾提供本機複本的 URL。

  注意

  讀取意圖的連接要求會路由至目前之主要複本的唯讀路由清單上，第一個可用之可讀取的次要複本。 沒有負載平衡。

安全性

權限

使用 TRANSACT-SQL

若要設定唯讀路由

1. 連接到裝載主要複本的伺服器執行個體。

2. 如果您要針對新的可用性群組指定複本，請使用 CREATE AVAILABILITY GROUP Transact-SQL 陳述式。 如果您要新增或修改現有可用性群組的複本，請使用 ALTER AVAILABILITY GROUPTransact-SQL 語句。

   • 若要設定次要角色的唯讀路由，請在 ADD REPLICA 或 MODIFY REPLICA WITH 子句中指定 SECONDARY_ROLE 選項，如下所示：

     SECONDARY_ROLE (READ_ONLY_ROUTING_URL ='TCP：// system-address ： port ')

     唯讀路由 URL 的參數如下：

     system-address
     這是明確識別目的地電腦系統的字串，例如系統名稱、完整網域名稱或 IP 位址。

     port
     這是 SQL Server 執行個體之資料庫引擎所使用的連接埠號碼。

     例如：SECONDARY_ROLE (READ_ONLY_ROUTING_URL = N'TCP://COMPUTER01.contoso.com:1433')

     在 MODIFY REPLICA 子句中，ALLOW_CONNECTIONS 是選擇性的 (如果複本已經設定為允許唯讀連接的話)。

     如需詳細資訊，請參閱 計算 AlwaysOn 的 read_only_routing_url。

   • 若要設定主要角色的唯讀路由，請在 ADD REPLICA 或 MODIFY REPLICA WITH 子句中指定 PRIMARY_ROLE 選項，如下所示：

     PRIMARY_ROLE (READ_ONLY_ROUTING_LIST = (' server ' [ ，...n ] ) )

     其中， server 會識別裝載可用性群組中唯讀次要複本的伺服器執行個體。

     例如：PRIMARY_ROLE (READ_ONLY_ROUTING_LIST=('Server1','Server2'))

     注意

     您必須先設定唯讀路由 URL，然後再設定唯讀路由清單。

範例 (Transact-SQL)

下列範例會將現有可用性群組 AG1 的兩個可用性複本修改成支援唯讀路由 (如果其中一個複本目前擁有主要角色的話)。 為了識別裝載可用性複本的伺服器執行個體，此範例會指定執行個體名稱：COMPUTER01 和 COMPUTER02。

ALTER AVAILABILITY GROUP [AG1]  
 MODIFY REPLICA ON  
N'COMPUTER01' WITH   
(SECONDARY_ROLE (ALLOW_CONNECTIONS = READ_ONLY));  
ALTER AVAILABILITY GROUP [AG1]  
 MODIFY REPLICA ON  
N'COMPUTER01' WITH   
(SECONDARY_ROLE (READ_ONLY_ROUTING_URL = N'TCP://COMPUTER01.contoso.com:1433'));  
  
ALTER AVAILABILITY GROUP [AG1]  
 MODIFY REPLICA ON  
N'COMPUTER02' WITH   
(SECONDARY_ROLE (ALLOW_CONNECTIONS = READ_ONLY));  
ALTER AVAILABILITY GROUP [AG1]  
 MODIFY REPLICA ON  
N'COMPUTER02' WITH   
(SECONDARY_ROLE (READ_ONLY_ROUTING_URL = N'TCP://COMPUTER02.contoso.com:1433'));  
  
ALTER AVAILABILITY GROUP [AG1]   
MODIFY REPLICA ON  
N'COMPUTER01' WITH   
(PRIMARY_ROLE (READ_ONLY_ROUTING_LIST=('COMPUTER02','COMPUTER01')));  
  
ALTER AVAILABILITY GROUP [AG1]   
MODIFY REPLICA ON  
N'COMPUTER02' WITH   
(PRIMARY_ROLE (READ_ONLY_ROUTING_LIST=('COMPUTER01','COMPUTER02')));  
GO

使用 PowerShell

若要設定唯讀路由

1. 將預設值 (cd) 設定為裝載主要複本的伺服器執行個體。

2. 將可用性複本加入至可用性群組時，請使用 New-SqlAvailabilityReplica 指令程式。 修改現有的可用性複本時，請使用 Set-SqlAvailabilityReplica 指令程式。 相關參數如下所示：

   • 若要設定次要角色的唯讀路由，請指定 ReadonlyRoutingConnectionUrl「 url 」 參數。

     其中， url 是路由至複本進行唯讀連接時要使用的連接性完整網域名稱 (FQDN) 和通訊埠。 例如：-ReadonlyRoutingConnectionUrl "TCP://DBSERVER8.manufacturing.Adventure-Works.com:7024"

     如需詳細資訊，請參閱 計算 AlwaysOn 的 read_only_routing_url。

   • 若要設定主要角色的連線存取，請指定 ReadonlyRoutingList「 server 」 [ ，...n ]，其中 伺服器 會識別裝載可用性群組中唯讀次要複本的伺服器實例。 例如：-ReadOnlyRoutingList "SecondaryServer","PrimaryServer"

     注意

     您必須先設定複本的唯讀路由 URL，然後再設定其唯讀路由清單。

   注意

   若要檢視 Cmdlet 的語法，請使用 Get-Help SQL Server PowerShell 環境中的 Cmdlet。 如需詳細資訊，請參閱 Get Help SQL Server PowerShell。

若要設定和使用SQL Server PowerShell 提供者，請參閱SQL Server PowerShell 提供者和取得 PowerShell 的說明SQL Server。

範例 (PowerShell)

下列範例會將可用性群組中的主要複本和一個次要複本設定為唯讀路由。 首先，此範例會將唯讀路由 URL 指派給每個複本。 然後，它會設定主要複本的唯讀路由清單。 在連接字串中設定 "ReadOnly" 屬性的連接將會重新導向至次要複本。 如果這個次要複本無法讀取 (由 ConnectionModeInSecondaryRole 設定決定)，連接將會導向回到主要複本。

Set-Location SQLSERVER:\SQL\PrimaryServer\default\AvailabilityGroups\MyAg  
$primaryReplica = Get-Item "AvailabilityReplicas\PrimaryServer"  
$secondaryReplica = Get-Item "AvailabilityReplicas\SecondaryServer"  
  
Set-SqlAvailabilityReplica -ReadOnlyRoutingConnectionUrl "TCP://PrimaryServer.domain.com:1433" -InputObject $primaryReplica  
Set-SqlAvailabilityReplica -ReadOnlyRoutingConnectionUrl "TCP://SecondaryServer.domain.com:1433" -InputObject $secondaryReplica  
Set-SqlAvailabilityReplica -ReadOnlyRoutingList "SecondaryServer","PrimaryServer" -InputObject $primaryReplica  

後續操作：設定唯讀路由之後

一旦目前的主要複本和可讀取的次要複本都設定為支援兩種角色的唯讀路由之後，可讀取的次要複本就可以從經由可用性群組接聽程式連接的用戶端接收讀取意圖連接要求。

用戶端連接字串的需求和建議

若要讓用戶端應用程式使用唯讀路由，其連接字串必須滿足下列需求：

• 使用 TCP 通訊協定。

• 將應用程式意圖屬性 (Attribute)/屬性 (Property) 設定成唯讀。

• 參考設定為支援唯讀路由之可用性群組的接聽程式。

• 參考該可用性群組中的資料庫。

此外，我們建議連接字串要啟用多重子網路容錯移轉，以便針對每個子網路上的每個複本支援平行用戶端執行緒。 這樣做可在容錯移轉之後盡量縮短用戶端重新連接時間。

連接字串的語法主要取決於應用程式所使用的 SQL Server 提供者。 下列 .NET Framework Data Provider 4.0.2 for SQL Server 範例連接字串說明了針對唯讀路由運作時必要且建議的連接字串部分。

Server=tcp:MyAgListener,1433;Database=Db1;IntegratedSecurity=SSPI;ApplicationIntent=ReadOnly;MultiSubnetFailover=True  

如需唯讀應用程式意圖和唯讀路由的詳細資訊，請參閱可用性群組接聽程式、用戶端連接性及應用程式容錯移轉 (SQL Server)。

如果唯讀路由未正確運作

如需針對唯讀路由組態進行疑難排解的相關資訊，請參閱 唯讀路由未正確運作。

相關工作

若要檢視唯讀路由組態

• sys.availability_read_only_routing_lists (Transact-SQL)

• sys.availability_replicas (Transact-SQL) (read_only_routing_url 資料行)

若要設定用戶端連接存取

• 建立或設定可用性群組接聽程式 (SQL Server)

• 設定可用性複本上的唯讀存取 (SQL Server)

若要在應用程式中使用連接字串

• 高可用性/災害復原的 SQL Server Native Client 支援

• 搭配 SQL Server Native Client 使用連接字串關鍵字

相關內容

• 部落格：

  計算 AlwaysOn 的 read_only_routing_url

  SQL Server AlwaysOn 團隊部落格：官方 SQL Server AlwaysOn 團隊部落格

  CSS SQL Server 工程師部落格

• 白皮書：

  Microsoft 的 SQL Server 2012 白皮書

  SQL Server 客戶諮詢團隊白皮書

另請參閱

AlwaysOn 可用性群組概觀 (SQL Server)
AlwaysOn 可用性群組概觀 (SQL Server)
使用中次要：可讀取的次要複本 (AlwaysOn 可用性群組)
關於可用性複本的用戶端連接存取 (SQL Server)
可用性群組接聽程式、用戶端連線及應用程式容錯移轉 (SQL Server)