다음을 통해 공유

Spring Data Azure Cosmos DB v2 for API for NoSQL(레거시): 릴리스 정보 및 리소스

  • 아티클

적용 대상: NoSQL

Spring Data Azure Cosmos DB 버전 2 for NoSQL을 사용하면 개발자가 Spring 애플리케이션에서 Azure Cosmos DB를 사용할 수 있습니다. Spring Data Azure Cosmos DB는 데이터베이스 및 컬렉션을 조작하고, 문서 작업을 수행하고, 쿼리를 실행하기 위한 Spring Data 인터페이스를 제공합니다. 동기화 및 비동기(반응형) API는 모두 동일한 Maven 아티팩트에서 지원됩니다.

Warning

이 버전의 Spring Data Azure Cosmos DB SDK는 사용 중지된 버전의 Azure Cosmos DB Java SDK에 따라 달라집니다. 이 Spring Data Azure Cosmos DB SDK는 가까운 장래에 사용 중지로 발표될 예정입니다! Azure Cosmos DB용 최신 Azure Spring Data Azure Cosmos DB SDK가 아니며 오래되었습니다. Azure Spring Data Azure Cosmos DB SDK V2의 성능 문제 및 불안정성으로 인해 프로젝트에 Azure Spring Data Azure Cosmos DB v5를 사용하는 것이 좋습니다. 업그레이드하려면 Azure Cosmos DB Java SDK v4로 마이그레이션 가이드의 지침에 따라 기본 Java SDK V4의 차이점을 이해합니다.

Spring Framework는 Java 애플리케이션 개발을 간소화하는 프로그래밍 및 구성 모델입니다. Spring은 종속성 주입을 사용하여 애플리케이션의 "배관"을 간소화합니다. 애플리케이션을 보다 간단하게 빌드하고 테스트할 수 있기 때문에 많은 개발자들이 Spring을 좋아합니다. Spring Boot 는 웹 애플리케이션 및 마이크로 서비스 개발을 주시하면서 배관 처리를 확장합니다. Spring Data는 Spring 또는 Spring Boot 애플리케이션의 컨텍스트에서 Azure Cosmos DB와 같은 데이터 저장소에 액세스하기 위한 프로그래밍 모델입니다.

Azure Spring Apps에서 호스트되는 애플리케이션에서 Spring Data Azure Cosmos DB를 사용할 수 있습니다.

Important

이러한 릴리스 정보는 Spring Data Azure Cosmos DB 버전 2에 대한 것입니다. 여기에서 버전 3의 릴리스 정보를 확인할 수 있습니다.

Spring Data Azure Cosmos DB는 API for NoSQL만 지원합니다.

다른 Azure Cosmos DB API의 Spring Data에 대한 정보는 다음 문서를 참조하세요.

신속하게 진행하고 싶으세요?

  1. SDK를 사용할 수 있도록 지원되는 최소 Java 런타임 JDK 8을 설치합니다.
  2. 스타터를 사용하여 Spring Data Azure Cosmos DB 앱을 만듭니다. 이는 간단합니다!
  3. Spring Data Azure Cosmos DB 개발자 가이드를 통해 기본 Azure Cosmos DB 요청을 안내합니다.

Spring Initializr를 사용하여 Spring Boot Starter 앱을 빠르게 스핀업할 수 있습니다!

리소스

리소스 링크
SDK 다운로드 Maven
API 설명서 Spring Data Azure Cosmos DB 참조 설명서
SDK에 기여 GitHub의 Spring Data Azure Cosmos DB 리포지토리
Spring Boot Starter Java용 Azure Cosmos DB Spring Boot Starter 클라이언트 라이브러리
개발자 가이드 Spring Data Azure Cosmos DB 개발자 가이드
Starter 사용 Azure Cosmos DB for NoSQL에서 Spring Boot Starter를 사용하는 방법
Azure Cosmos DB Spring Boot Starter용 GitHub 리포지토리
Azure 앱 Service를 사용한 샘플 App Service on Linux를 통해 Spring 및 Azure Cosmos DB를 사용하는 방법

릴리스 기록

2.3.0(2020년 5월 21일)

새로운 기능

  • Spring Boot 버전을 2.3.0으로 업데이트합니다.

2.2.5(2020년 5월 19일)

새로운 기능

  • Azure Cosmos DB 버전을 3.7.3으로 업데이트합니다.

주요 버그 수정

  • Azure Cosmos DB SDK 3.7.3에서 메모리 누수 수정 및 Netty 버전 업그레이드를 포함합니다.

2.2.4(2020년 4월 6일)

주요 버그 수정

  • CosmosDbConfig에서 고려할 allowTelemetry 플래그를 수정합니다.
  • 컨테이너의 속성을 수정합니다 TTL .

2.2.3(2020년 2월 25일)

새로운 기능

  • 파티션 키 API별로 새 findAll API를 추가합니다.
  • Azure Cosmos DB 버전을 3.7.0으로 업데이트합니다.

주요 버그 수정

  • collectionName ->containerName을 수정합니다.
  • entityClass 및 domainClass ->domainType을 수정합니다.
  • "입력 엔터티 대신 리포지토리에 의해 저장된 엔터티 컬렉션 반환"을 수정합니다.

2.1.10(2020년 2월 25일)

주요 버그 수정

  • "입력 엔터티 대신 리포지토리에서 저장한 엔터티 컬렉션 반환"에 대한 백포트 수정

2.2.2(2020년 1월 15일)

새로운 기능

  • Azure Cosmos DB 버전을 3.6.0으로 업데이트합니다.

주요 버그 수정

2.2.1(2019년 12월 31일)

새로운 기능

  • Azure Cosmos DB SDK 버전을 3.5.0으로 업데이트합니다.
  • 자동 컬렉션 생성을 사용하거나 사용하지 않도록 설정하는 주석 필드를 추가합니다.
  • 예외 처리를 개선합니다. 를 통해 CosmosDBAccessException노출합니다CosmosClientException.
  • 를 통해 노출합니다 requestCharge activityId ResponseDiagnostics.

주요 버그 수정

  • SDK 3.5.0 업데이트는 “Azure Cosmos DB HTTP 응답 헤더가 8192바이트보다 큰 경우 예외”, “ConsistencyPolicy.defaultConsistencyLevel()은 제한된 부실 및 일관적인 접두사에서 실패합니다.”를 수정합니다.
  • findById 메서드의 동작을 수정합니다. 이전에는 엔터티를 찾지 못한 경우 이 메서드는 예외를 throw하는 대신 빈 결과를 반환했습니다.
  • 정렬이 사용되었을 때 CosmosPageRequest 다음 페이지에 적용되지 않은 버그를 수정합니다.

2.1.9(2019년 12월 26일)

새로운 기능

  • 자동 컬렉션 생성을 사용하거나 사용하지 않도록 설정하는 주석 필드를 추가합니다.

주요 버그 수정

  • findById 메서드의 동작을 수정합니다. 이전에는 엔터티를 찾지 못한 경우 이 메서드는 예외를 throw하는 대신 빈 결과를 반환했습니다.

2.2.0(2019년 10월 21일)

새로운 기능

  • 반응형 Azure Cosmos DB 리포지토리를 완전하게 지원합니다.
  • Azure Cosmos DB 요청 진단 문자열 및 쿼리 메트릭을 지원합니다.
  • Azure Cosmos DB SDK 버전이 3.3.1로 업데이트됩니다.
  • Spring Framework 버전이 5.2.0.RELEASE로 업그레이드됩니다.
  • Spring Data Commons 버전이 2.2.0.RELEASE로 업그레이드됩니다.
  • findByIdAndPartitionKey 및 deleteByIdAndPartitionKey API를 추가합니다.
  • azure-documentdb에서 종속성을 제거합니다.
  • DocumentDB를 Azure Cosmos DB로 리브랜딩합니다.

주요 버그 수정

  • "pageSize가 리포지토리의 총 항목보다 작을 때 정렬이 예외를 throw합니다."를 수정합니다.

2.1.8(2019년 10월 18일)

새로운 기능

  • DocumentDB API는 더 이상 사용되지 않습니다.
  • findByIdAndPartitionKey 및 deleteByIdAndPartitionKey API를 추가합니다.
  • 에 따라 낙관적 잠금을 추가합니다 _etag.
  • 문서 컬렉션 이름에 SpEL 식을 사용하도록 설정합니다.
  • 향상된 기능 ObjectMapper를 추가합니다.

2.1.7(2019년 10월 18일)

새로운 기능

  • Azure Cosmos DB SDK 버전 3 종속성을 추가합니다.
  • 반응형 Azure Cosmos DB 리포지토리를 추가합니다.
  • Azure Cosmos DB SDK 버전 3을 사용하도록 구현 DocumentDbTemplate 을 업데이트합니다.
  • 반응형 Azure Cosmos DB 리포지토리 지원에 대한 다른 구성 변경 내용을 추가합니다.

2.1.2(2019년 3월 19일)

주요 버그 수정

  • 다음에 대한 종속성을 제거합니다 applicationInsights .
    • 종속성이 오염될 잠재적 위험
    • Java 11 비호환성.
    • CPU 및/또는 메모리에 대한 잠재적 성능 저하 방지

2.0.7(2019년 3월 20일)

주요 버그 수정

  • 백포트는 다음에 대한 종속성을 제거합니다 applicationInsights .
    • 종속성이 오염될 잠재적 위험
    • Java 11 비호환성.
    • CPU 및/또는 메모리에 대한 잠재적 성능 저하 방지

2.1.1(2019년 3월 7일)

새로운 기능

  • 주 버전을 2.1.1로 업데이트합니다.

2.0.6(2019년 3월 7일)

새로운 기능

  • 원격 분석에서 모든 예외를 무시합니다.

2.1.0(2018년 12월 17일)

새로운 기능

  • 문제를 해결하기 위해 버전을 2.1.0으로 업데이트합니다.

2.0.5(2018년 9월 13일)

새로운 기능

  • exists 및 startsWith 키워드를 추가합니다.
  • 추가 정보 업데이트

주요 버그 수정

  • "엔터티에 대해 자체 href를 직접 호출할 수 없습니다."를 수정합니다.
  • "컬렉션이 만들어지지 않으면 findAll이 실패합니다."를 수정합니다.

2.0.4(시험판) (2018년 8월 23일)

새로운 기능

  • 패키지 이름을 documentdb에서 cosmosdb로 바꿉니다.
  • 쿼리 메서드 키워드의 새 기능을 추가합니다. NoSQL용 API의 16개 키워드가 현재 지원됩니다.
  • 페이징 및 정렬을 사용하여 쿼리의 새로운 기능을 추가합니다.
  • spring-data-cosmosdb의 구성을 간소화합니다.
  • deleteCollection 및 deleteAll API를 추가합니다.

주요 버그 수정

  • 버그 수정 및 결함 완화.

FAQ

사용 중지된 SDK에 대한 알림은 어떻게 받나요?

Microsoft는 지원되는 SDK로 매끄럽게 전환할 수 있도록 사용 중지되는 SDK 지원이 종료되기 12개월 전에 사전 알림을 제공합니다. Azure Portal, Azure 업데이트, 할당된 서비스 관리자에 대한 직접 통신 등 다양한 통신 채널을 통해 알려드립니다.

12개월 동안 사용 중지된 Azure Cosmos DB SDK를 사용하여 애플리케이션을 작성할 수 있나요?

예, 12개월 알림 기간 동안 사용 중지된 Azure Cosmos DB SDK를 사용하여 애플리케이션을 작성, 배포 및 수정할 수 있습니다. 12개월 알림 기간 동안 지원되는 최신 버전의 Azure Cosmos DB SDK로 적절하게 마이그레이션하는 것이 좋습니다.

사용 중지 날짜 후에는 지원되지 않는 Azure Cosmos DB SDK를 사용하는 애플리케이션은 어떻게 되나요?

사용 중지 날짜 이후 Azure Cosmos DB는 더 이상 버그를 수정하거나, 새 기능을 추가하거나, 사용 중지된 SDK 버전을 지원하지 않습니다. 업그레이드하지 않으려는 경우 사용 중지된 버전의 SDK에서 보낸 요청은 Azure Cosmos DB 서비스에서 계속 제공됩니다.

최신 기능 및 업데이트가 있는 SDK 버전은 무엇입니까?

새 기능 및 업데이트는 지원되는 최신 주요 SDK 버전의 최신 부 버전에만 추가됩니다. 항상 최신 버전을 사용하여 새로운 기능, 성능 향상 및 버그 수정을 활용하는 것이 좋습니다. 사용 중지되지 않은 이전 버전의 SDK를 사용하는 경우 Azure Cosmos DB에 대한 요청은 계속 작동하지만 새 기능에는 액세스할 수 없습니다.

컷오프 날짜 전에 애플리케이션을 업데이트할 수 없는 경우 어떻게 해야 하나요?

가능한 한 빨리 최신 SDK로 업그레이드하는 것이 좋습니다. SDK가 사용 중지로 태깅된 후 12개월 내에 애플리케이션을 업데이트해야 합니다. 사용 중지 날짜까지 업데이트할 수 없는 경우 사용 중지된 버전의 SDK에서 보낸 요청은 Azure Cosmos DB에서 계속 제공되므로 실행 중인 애플리케이션이 계속 작동합니다. 그러나 Azure Cosmos DB는 더 이상 버그를 수정하거나 새 기능을 추가하거나 사용 중지된 SDK 버전을 지원하지 않습니다.

지원 계획이 있고 기술 지원이 필요한 경우 지원 티켓을 제출하여 문의하세요 .

SDK 또는 커넥터에 기능 추가를 요청하려면 어떻게 해야 하나요?

새로운 기능이 모든 SDK 또는 커넥터에 항상 즉시 추가되는 것은 아닙니다. 지원되지 않는 기능 중 추가하려는 기능이 있는 경우 커뮤니티 포럼에 피드백을 추가합니다.

다음 단계

Azure Cosmos DB에 대해 자세히 알아봅니다.

Spring Framework에 대해 자세히 알아봅니다.

Spring Boot에 대해 자세히 알아보세요.

Spring Data에 대해 자세히 알아봅니다.