資料服務版本控制 (WCF Data Services)
Open Data Protocol (OData) 可讓您建立資料服務，讓用戶端可以根據資料模型使用 URI 存取資料做為資源。 OData 也支援服務作業的定義。 初始部署並在其存留期期間潛在進行數次之後，可能會因為各種原因而需要變更這些資料服務 (例如變更商務需要、資訊技術需求) 或處理其他問題。 當您針對現有的資料服務進行變更時，必須考慮是否要定義新的資料服務版本，以及如何妥善地將對於現有用戶端應用程式的影響降至最低。 本主題提供建立新資料服務版本時機和方式的指引。 本主題也會描述 WCF Data Services 如何處理支援不同版本 OData 通訊協定之用戶端與資料服務之間的交換。
WCF Data Services 的版本控制
部署資料服務並取用資料之後，對於資料服務的變更便有可能造成與現有用戶端應用程式的相容性問題。 不過，由於服務的整體商務需求通常需要變更，因此您必須考慮建立新資料服務版本的時機與方式，並將對於用戶端應用程式的影響降至最低。
建議新資料服務版本的資料模型變更
考慮是否要發行新資料服務版本時，最好先了解不同種類的變更影響用戶端應用程式的方式。 對於可能要求您建立新資料服務版本之資料服務的變更可分成下列兩種類別：
對於服務合約的變更—其中包括服務作業的更新、對於實體集 (摘要) 存取範圍的變更、版本變更，以及對於服務行為的其他變更。
對於資料合約的變更—其中包括對於資料模型、摘要格式或摘要自訂的變更。
下表詳細說明您應該考慮發行新資料服務版本的哪些變更種類：
變更類型 |
需要新版本 |
不需要新版本 |
|---|---|---|
服務作業 |
|
|
服務行為 |
|
|
實體集權限 |
|
|
實體屬性 |
|
|
實體集 |
|
|
摘要自訂 |
|
1 這可能取決於用戶端應用程式依賴接收特定錯誤碼的嚴格程度。
2 您可以將 IgnoreMissingProperties 屬性設定為 true，讓用戶端忽略用戶端上未定義之資料服務所傳送的任何新屬性。 不過，進行插入時，用戶端沒有包含在 POST 要求中的屬性會設為其預設值。 若是更新，屬性中用戶端未知的任何現有資料都可能會以預設值覆寫。 在此情況下，您應該將更新當做 MERGE 要求傳送，這是預設值。 如需詳細資訊，請參閱管理資料服務內容 (WCF Data Services)。
如何進行資料服務的版本控制
必要時，您可以使用更新的服務合約或資料模型建立新的服務執行個體，藉以定義新的資料服務版本。 接著，您要使用新的 URI 端點公開這個新服務，以區別舊版本。 例如：
舊版本：http://services.odata.org/Northwind/v1/Northwind.svc/
新版本：http://services.odata.org/Northwind/v2/Northwind.svc/
升級資料服務時，用戶端也需要根據新的資料服務中繼資料進行更新，並使用新的根 URI。 如果可能，您應該維護資料服務的舊版本，以支援尚未進行升級以使用新版本的用戶端。 不再需要舊版本的資料服務時，可以將其移除。 您應該考慮在外部組態檔中維護資料服務端點 URI。
OData 通訊協定版本
發行新版本的 OData 時，用戶端應用程式可能就不會使用資料服務支援的相同 OData 通訊協定版本。 舊版用戶端應用程式可以存取支援新版 OData 的資料服務。 用戶端應用程式也可以使用新版本的 WCF Data Services 用戶端程式庫，這個用戶端程式庫支援比存取之資料服務更新版本的 OData。
WCF Data Services 會利用 OData 提供的支援來處理這種版本控制案例。 還支援在用戶端所使用的 OData 版本與資料服務所使用之版本不同時，產生及使用資料模型中繼資料來建立用戶端資料服務類別。 如需詳細資訊，請參閱 OData：通訊協定版本控制。
版本交涉
不論用戶端所要求的版本為何，資料服務都可以設定為定義服務將使用的最高 OData 通訊協定版本。 您可以為資料服務所使用的 DataServiceBehavior 的 MaxProtocolVersion 屬性指定 DataServiceProtocolVersion 值來執行此動作。 如需詳細資訊，請參閱設定資料服務 (WCF Data Services)。
當應用程式使用 WCF Data Services 用戶端程式庫來存取資料服務時，程式庫會根據 OData 的版本和您應用程式中所使用的特性，自動將這些標頭設定為正確的值。 根據預設，WCF Data Services 會使用可支援要求之作業的最低通訊協定版本。
下表詳細說明 .NET Framework 和 Silverlight 的版本，其中包含特定版本 OData 通訊協定的 WCF Data Services 支援。
OData 通訊協定版本 |
下列版本引入的支援 |
|---|---|
第 1 版 |
|
第 2 版 |
|
第 3 版 |
|
中繼資料版本
根據預設，WCF Data Services 會使用 1.1 版的 CSDL 來代表資料模型。 這就是以反映提供者或自訂資料服務提供者為基礎之資料模型的情況。 但是，當使用 Entity Framework 來定義資料模型時，傳回的 CSDL 版本會與 Entity Framework 所使用的版本相同。 CSDL 的版本是由 Schema 項目的命名空間來判斷。 如需詳細資訊，請參閱 規格 [MC-CSDL]：概念結構定義檔案格式.
傳回之中繼資料的 DataServices 項目還包含 DataServiceVersion 屬性，該值與回應訊息中 DataServiceVersion 標頭的值相同。 用戶端應用程式 (例如 Visual Studio 中的 [加入服務參考] 對話方塊) 會使用此資訊來產生用戶端資料服務類別，這些類別可搭配裝載資料服務之 WCF Data Services 的版本正常運作。 如需詳細資訊，請參閱 OData：通訊協定版本控制。