Spring Data Azure Cosmos DB v3 for API for NoSQL(레거시): 릴리스 정보 및 리소스
적용 대상: 
NoSQL
NoSQL용 Spring Data Azure Cosmos DB 버전 3을 사용하면 개발자가 Spring 애플리케이션에서 Azure Cosmos DB를 사용할 수 있습니다. Spring Data Azure Cosmos DB는 데이터베이스 및 컬렉션을 조작하고, 문서 작업을 수행하고, 쿼리를 실행하기 위한 Spring Data 인터페이스를 제공합니다. 동기화 및 비동기(반응형) API는 모두 동일한 Maven 아티팩트에서 지원됩니다.
Warning
이 버전의 Spring Data Azure Cosmos DB SDK는 이전 버전의 Spring Boot 및 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 V3의 성능 문제 및 불안정성으로 인해 프로젝트에 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를 사용할 수 있습니다.
버전 지원 정책
Spring Boot 버전 지원
이 프로젝트는 여러 Spring Boot 버전을 지원합니다. 자세한 내용은 Spring Boot 지원 정책을 참조하세요. Maven 사용자는 프로젝트에서 상속하여 Spring에서 spring-boot-starter-parent 종속성 버전을 관리할 수 있도록 종속성 관리 섹션을 가져올 수 있습니다. 자세한 내용은 Spring Boot 버전 지원을 참조하세요.
Spring Data 버전 지원
이 프로젝트는 다양한 spring-data-commons 버전을 지원합니다. 자세한 내용은 Spring Data 버전 지원을 참조하세요.
사용해야 하는 Azure Spring Data Azure Cosmos DB 버전
Azure Spring Data Azure Cosmos DB 라이브러리는 여러 버전의 Spring Boot/Spring Cloud를 지원합니다. Spring Boot/Spring Cloud 버전과 함께 사용할 Azure Spring Data Azure Cosmos DB 버전에 대한 자세한 내용은 Azure Spring Data Azure Cosmos DB 버전 매핑을 참조하세요.
Important
이러한 릴리스 정보는 Spring Data Azure Cosmos DB 버전 3에 대한 것입니다.
Azure Spring Data Azure Cosmos DB SDK는 Spring Data 프레임워크에 종속되며 NoSQL용 API만 지원합니다.
다른 Azure Cosmos DB API의 Spring Data에 대한 정보는 다음 문서를 참조하세요.
빠른 시작
Spring Boot Starter 가이드에 따라 Spring Data Azure Cosmos DB를 시작하고 실행합니다. Spring Boot Starter 접근 방식은 Spring Data Azure Cosmos DB 커넥터 사용을 시작하는 데 권장되는 방법입니다.
또는 아래와 같이 Spring Data Azure Cosmos DB 종속성을 아래 표시된 pom.xml 파일에 추가할 수 있습니다.
<dependency>
<groupId>com.azure</groupId>
<artifactId>azure-spring-data-cosmos</artifactId>
<version>latest-version</version>
</dependency>
유용한 콘텐츠
릴리스 기록
릴리스 기록은 azure-sdk-for-java 리포지토리에서 유지 관리됩니다. 자세한 릴리스 목록은 변경 로그 파일을 참조하세요.
권장 버전
Azure Spring Data Azure Cosmos DB v5로 업그레이드하고 권장되는 최소 버전 이상을 사용하는 것이 좋습니다.
추가 참고 사항
- Spring Data Azure Cosmos DB는 Java JDK 8, Java JDK 11을 지원합니다. 버전 3.8.0 이상은 Java JDK 17도 지원합니다.
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에 대해 자세히 알아봅니다.