데이터 서비스 버전 관리(WCF Data Services)
Open Data Protocol(OData)을 사용하면 클라이언트가 데이터 모델에 기반한 URI를 사용하여 데이터를 리소스로 액세스할 수 있도록 데이터 서비스를 만들 수 있습니다. OData도 서비스 작업의 정의를 지원합니다. 이러한 데이터 서비스는 비즈니스 요구의 변경, 정보 기술의 요구 사항 또는 다른 문제 해결 등의 다양한 이유 때문에 최초로 배포된 후, 수명 동안 여러 차례에 걸쳐 변경되어야 할 수 있습니다. 기존 데이터 서비스를 변경한 경우 새 버전의 데이터를 정의할 것인지와 기존 클라이언트 응용 프로그램에 미치는 영향을 최소화할 최선의 방법을 고려해야 합니다. 이 항목에서는 새 버전의 데이터 서비스를 만드는 방법 및 시기에 대한 지침을 제공합니다. 또한 WCF Data Services에서 다른 버전의 OData 프로토콜을 지원하는 클라이언트 및 데이터 서비스 사이에서 교환을 처리하는 방식에 대해 설명합니다.
WCF Data Service 버전 관리
데이터 서비스를 배포한 후 데이터가 사용되고 있을 때 데이터 서비스를 변경하면 기존 클라이언트 응용 프로그램에 호환성 문제가 나타날 수 있습니다. 하지만 서비스의 전반적 비즈니스 요구사항으로 인해 변경이 필요한 경우가 많기 때문에 클라이언트 응용 프로그램에 가장 적은 영향을 미치면서 데이터 서비스의 새 버전을 만들 시기와 방법을 고려해야 합니다.
새 데이터 서비스 버전을 권장하는 데이터 모델 변경
데이터 서비스의 새로운 버전을 게시할 것인지를 고려할 때에는 다른 종류의 변경이 클라이언트 응용 프로그램에 어떻게 영향을 미칠 것인가를 이해하는 것이 중요합니다. 데이터 서비스의 새로운 버전을 만들어야 할 수 있는 데이터 서비스 변경은 다음 두 가지 범주로 나눌 수 있습니다.
서비스 계약 변경 - 서비스 작업, 엔터티 집합(피드)의 액세스 가능성 변경, 버전 변경, 기타 서비스 동작 변경이 포함됩니다.
데이터 계약 변경 - 데이터 모델, 피드 형식 또는 피드 사용자 지정이 포함됩니다.
다음 표에는 새 버전의 데이터 서비스를 게시할 때 고려해야 하는 변경의 종류가 자세히 나와 있습니다.
변경 유형 |
새 버전 필요 |
새 버전이 필요하지 않음 |
|---|---|---|
서비스 작업 |
|
|
서비스 동작 |
|
|
엔터티 집합 권한 |
|
|
엔터티 속성 |
|
|
엔터티 집합 |
|
|
피드 사용자 지정 |
|
1 이는 클라이언트 응용 프로그램이 특정 오류 코드 수신에 얼마나 엄격하게 의존하는가에 따라 달라질 수 있습니다.
2 클라이언트에 정의되지 않은 데이터 서비스에서 보낸 모든 새 속성을 클라이언트가 무시하도록 하려면 IgnoreMissingProperties 속성을 true로 설정할 수 있습니다. 그러나 삽입이 수행되면 POST 요청의 클라이언트에 의해 포함되지 않은 속성이 기본 값으로 설정됩니다. 업데이트의 경우 클라이언트에 알려지지 않은 속성의 모든 기존 데이터는 기본 값으로 덮어 쓰여질 수 있습니다. 이 경우 업데이트를 기본값인 MERGE 요청으로 보내야 합니다. 자세한 내용은 데이터 서비스 컨텍스트 관리(WCF Data Services)를 참조하십시오.
데이터 서비스 버전 관리 방법
필요한 경우 업데이트된 서비스 계약 또는 데이터 모델로 서비스의 새 인스턴스를 만들어 새 데이터 서비스 버전을 정의할 수 있습니다. 그런 다음 이 새로운 서비스는 이전 버전과 차별화하는 새 URI 끝점을 사용하여 노출됩니다. 예를 들면 다음과 같습니다.
데이터 서비스를 업그레이드 하는 경우 클라이언트는 또한 새 데이터 서비스 메타데이터를 기반으로 업데이트하고 새 루트 URI를 사용해야 합니다. 가능한 경우, 아직 업그레이드되지 않아 새 버전을 사용하지 않는 클라이언트를 지원할 수 있도록 이전 버전의 데이터 서비스를 유지해야 합니다. 이전 버전의 데이터 서비스가 더 이상 필요하지 않으면 제거할 수 있습니다. 외부 구성 파일에 데이터 서비스 끝점의 URI를 유지하는 것을 고려해야 합니다.
OData 프로토콜 버전
새로운 버전의 OData가 출시됨에 따라 클라이언트 응용 프로그램이 데이터 서비스에서 지원하는 동일한 버전의 OData 프로토콜을 사용하지 않을 수 있습니다. 이전 클라이언트 응용 프로그램은 새 버전의 OData를 지원하는 데이터 서비스에 액세스할 수 있습니다 클라이언트 응용 프로그램이 액세스 중인 데이터 서비스에서 지원하는 버전보다 이후 버전의 OData를 지원하는 새 버전의 WCF Data Services 클라이언트 라이브러리를 사용하고 있을 수도 있습니다.
WCF Data Services는 OData에서 제공하는 지원 기능을 활용하여 이러한 버전 관리 시나리오를 처리합니다. 클라이언트가 데이터 서비스에서 사용하는 것과 다른 버전의 OData를 사용하는 경우 클라이언트 데이터 서비스 클래스를 만들기 위해 데이터 모델 메타데이터를 생성하고 사용하기 위한 지원 기능도 있습니다. 자세한 내용은 OData: Protocol Versioning을 참조하십시오.
버전 협상
클라이언트가 요청하는 버전에 관계없이 데이터 서비스에서 사용할 가장 높은 버전의 OData 프로토콜을 정의하도록 데이터 서비스를 구성할 수 있습니다. 이렇게 하려면 데이터 서비스에서 사용되는 DataServiceBehavior의 MaxProtocolVersion 속성에 대한 DataServiceProtocolVersion 값을 지정합니다. 자세한 내용은 데이터 서비스 구성(WCF Data Services)을 참조하십시오.
응용 프로그램이 WCF Data Services 클라이언트 라이브러리를 사용하여 데이터 서비스에 액세스하는 경우 라이브러리는 응용 프로그램에서 사용되는 기능과 OData의 버전에 따라 이러한 헤더를 올바른 값으로 자동으로 설정합니다. 기본적으로 WCF Data Services는 요청된 작업을 지원하는 가장 낮은 프로토콜 버전을 사용합니다.
다음 표에서는 특정 버전의 OData프로토콜에 대한 WCF Data Services를 포함하는 .NET Framework 및 Silverlight 버전에 대해 자세히 설명합니다.
OData 프로토콜 버전 |
도입된 지원 |
|---|---|
버전 1 |
|
버전 2 |
|
버전 3 |
|
메타데이터 버전
기본적으로 WCF Data Services는 CSDL 버전 1.1을 사용하여 데이터 모델을 나타냅니다. 이는 리플렉션 공급자 또는 사용자 지정 데이터 서비스 공급자를 기반으로 하는 데이터 모델의 경우 항상 해당됩니다. 그러나 데이터 모델이 Entity Framework를 사용하여 정의된 경우 반환된 CSDL 버전은 Entity Framework에서 사용되는 버전과 동일합니다. CSDL의 버전은 Schema 요소의 네임스페이스에 의해 결정됩니다. 자세한 내용은 다음 항목을 참조하십시오. 사양 [MC-CSDL]: Conceptual Schema Definition File Format.
반환된 메타데이터의 DataServices 요소에는 응답 메시지의 DataServiceVersion 헤더와 값이 동일한 DataServiceVersion 특성도 포함되어 있습니다. Visual Studio의 서비스 참조 추가 대화 상자와 같은 클라이언트 응용 프로그램은 이 정보를 사용하여 데이터 서비스를 호스팅하는 WCF Data Services의 버전에서 올바르게 작동하는 클라이언트 데이터 서비스 클래스를 생성합니다. 자세한 내용은 OData: Protocol Versioning을 참조하십시오.
참고 항목
개념
데이터 서비스 공급자(WCF Data Services)