NoSQL Java SDK용 Azure Cosmos DB(레거시): 릴리스 정보 및 리소스

  • 아티클

적용 대상: NoSQL

이 문서에서는 NoSQL용 API에 대한 Azure Cosmos DB Sync Java SDK v2에 대해 설명합니다. 이 API는 동기 작업만 지원합니다.

Important

Azure Cosmos DB의 최신 Java SDK가 아닙니다! 프로젝트에 Azure Cosmos DB Java SDK v4를 사용하는 것이 좋습니다. 업그레이드하려면 Azure Cosmos DB Java SDK v4로 마이그레이션 가이드 및 Reactor 및 RxJava 가이드의 지침을 따릅니다.

Warning

2024년 2월 29일부터 Azure Cosmos DB Sync Java SDK v2.x가 사용 중지되었습니다. Azure Cosmos DB는 사용 중지 후 이 SDK에 대한 기본 테넌트 또는 지원을 더 이상 제공하지 않습니다. Azure Cosmos DB Java SDK v4로 마이그레이션하려면 여기 의 지침을 따르세요.

링크
SDK 다운로드 Maven
API 설명서 Java API 참조 설명서
SDK에 기여 GitHub
시작 Java SDK 시작
웹앱 자습서 Azure Cosmos DB를 사용한 웹 애플리케이션 개발
지원되는 최소 런타임 JDK(Java Development Kit) 7+

릴리스 정보

다음은 SDK의 각 버전에 대한 릴리스 정보입니다.

2.6.5

  • 보안 취약성으로 인한 테스트 종속성 com.google.guava/guava 제거
  • 종속성을 com.fasterxml.jackson.core/jackson-databind 2.14.0으로 업그레이드했습니다.
  • 종속성을 commons-codec/commons-codec 1.15로 업그레이드했습니다.
  • 종속성을 org.json/json 20180130 업그레이드

2.6.4

  • 읽기 시간 제한에 대한 재시도 정책을 수정했습니다.

2.6.3

  • 래핑 IllegalStateException 될 때 GoneException 재시도 정책이 수정됨 - Spark 커넥터(Spark 2.4의 경우)가 사용자 지정 재시도 정책을 사용하여 파티션 분할 중에 쿼리가 성공할 수 있도록 게이트웨이 캐시가 410에서 새로 고쳐지도록 이 변경이 필요합니다.

2.6.2

  • 읽기 시간 제한 시 다시 시도하기 위한 새 재시도 정책이 추가됨
  • 종속성을 com.fasterxml.jackson.core/jackson-databind 2.9.10.8로 업그레이드했습니다.
  • 종속성을 org.apache.httpcomponents/httpclient 4.5.13으로 업그레이드함

2.6.1

  • 서비스 interop을 통해 쿼리를 처리하는 버그가 수정되었습니다.

2.6.0

  • 특정 시점에서 변경 피드를 쿼리하기 위한 지원이 추가되었습니다.

2.5.1

  • documentCollection 쿼리에서 기본 파티션 캐시 문제를 해결합니다.

2.5.0

  • 449 재시도 사용자 지정 구성에 대한 지원이 추가되었습니다.

2.4.7

  • 연결 풀 제한 시간 문제를 수정합니다.
  • 내부 재시도에서 인증 토큰 새로 고침을 수정합니다.

2.4.6

  • databaseAccount의 올바른 클라이언트 쪽 복제본 정책 태그를 업데이트하고 캐시에서 databaseAccount 구성을 읽었습니다.

2.4.5

  • 사용자가 pkRangeId를 제공하는 경우 이 버전은 잘못된 파티션 키 범위 오류에 대한 재시도를 방지합니다.

2.4.4

  • 파티션 키 범위 캐시 새로 고침이 최적화되었습니다.
  • SDK가 서버의 파티션 분할 힌트를 접대하지 않고 잘못된 클라이언트 쪽 라우팅 캐시 새로 고침이 발생하는 시나리오를 수정합니다.

2.4.2

  • 최적화된 컬렉션 캐시 새로 고침

2.4.1

  • 요청 진단 문자열에서 내부 예외 메시지를 검색하는 지원이 추가되었습니다.

2.4.0

  • PartitionKeyDefinition의 버전 API가 도입되었습니다.

2.3.0

  • 직접 모드에 대해 별도의 시간 제한 지원이 추가되었습니다.

2.2.3

  • 서비스에서 null 오류 메시지를 사용하고 문서 클라이언트 예외를 생성합니다.

2.2.2

  • 소켓 연결 개선, SoKeepAlive 기본값 true 추가

2.2.0

  • 요청 진단 문자열 지원이 추가되었습니다.

2.1.3

  • Hash V2용 PartitionKey의 버그가 수정되었습니다.

2.1.2

  • 복합 인덱스에 대한 지원이 추가되었습니다.
  • 전역 엔드포인트 관리자에서 새로 고침을 강제 적용하는 버그가 수정되었습니다.
  • 직접 모드에서 사전 조건이 있는 upsert 작업에 대한 버그가 수정되었습니다.

2.1.1

  • 게이트웨이 주소 캐시의 버그가 수정되었습니다.

2.1.0

  • 직접 모드에 대한 다중 지역 쓰기 지원이 추가되었습니다.
  • 프록시에서 예외로 ServiceUnavailable throw된 IOExceptions 처리에 대한 지원이 추가되었습니다.
  • 엔드포인트 검색 재시도 정책의 버그가 수정되었습니다.
  • BaseDatabaseAccountConfigurationProvider에서 null 포인터 예외가 throw되지 않도록 하는 버그가 수정되었습니다.
  • QueryIterator가 null을 반환하지 않도록 하는 버그가 수정되었습니다.
  • 큰 PartitionKey가 허용되는지 확인하기 위한 버그가 수정되었습니다.

2.0.0

  • 게이트웨이 모드에 대한 다중 지역 쓰기 지원이 추가되었습니다.

1.16.4

  • 쿼리에 대한 읽기 파티션 키 범위의 버그가 수정되었습니다.

1.16.3

  • DirectHttps 모드에서 연속 토큰 헤더 크기를 설정하는 버그가 수정되었습니다.

1.16.2

  • 스트리밍 장애 조치(failover) 지원이 추가되었습니다.
  • 사용자 지정 메타데이터에 대한 지원이 추가되었습니다.
  • 세션 처리 논리가 향상되었습니다.
  • 파티션 키 범위 캐시의 버그가 수정되었습니다.
  • 직접 모드에서 NullPointerException NPE(버그)를 수정했습니다.

1.16.1

  • 고유 인덱스 지원이 추가되었습니다.
  • 피드 옵션에서 연속 토큰 크기를 제한하기 위한 지원이 추가되었습니다.
  • Json Serialization의 버그를 수정했습니다(타임스탬프).
  • Json Serialization(열거형)의 버그가 수정되었습니다.
  • com.fasterxml.jackson.core:jackson-databind 종속성이 2.9.5로 업그레이드되었습니다.

1.16.0

  • 직접 모드에 대한 커넥트ion 풀링이 향상되었습니다.
  • nonorderby 파티션 간 쿼리에 대한 프리페치 개선
  • 향상된 UUID 생성.
  • 세션 일관성 논리가 향상되었습니다.
  • 다각형에 대한 지원이 추가되었습니다.
  • 컬렉션에 대한 파티션 키 범위 통계에 대한 지원이 추가되었습니다.
  • 다중 지역 지원의 버그가 수정되었습니다.

1.15.0

  • JSON Serialization 성능이 향상되었습니다.
  • 이 SDK 버전을 사용하려면 최신 버전의 Azure Cosmos DB 에뮬레이터가 필요합니다.

1.14.0

  • Microsoft 친구 라이브러리에 대한 내부 변경 내용입니다.

1.13.0

  • 단일 파티션 키 범위를 읽는 문제를 해결했습니다.
  • 이름이 짧은 데이터베이스에 영향을 주는 ResourceID 구문 분석 문제가 해결되었습니다.
  • 파티션 키 인코딩으로 인한 문제를 해결했습니다.

1.12.0

  • 파티션 분할 중에 처리를 요청하는 중요한 버그 수정입니다.
  • Strong 및 BoundedStaleness 일관성 수준 관련 문제를 수정했습니다.

1.11.0

  • ConsistentPrefix라는 새 일관성 수준에 대한 지원이 추가되었습니다.
  • 세션 모드에서 읽기 컬렉션의 버그가 수정되었습니다.

1.10.0

  • 초당 2,500RU 및 100RU/초의 크기 조정으로 분할된 컬렉션에 대한 지원을 사용하도록 설정했습니다.
  • 일부 쿼리에서 NullRef 예외를 일으킬 수 있는 네이티브 어셈블리의 버그를 수정합니다.

1.9.6

  • 게이트웨이 모드에서 쿼리에 대한 예외를 일으킬 수 있는 쿼리 엔진 구성의 버그가 수정되었습니다.
  • 컬렉션 생성 직후 요청에 대해 "소유자 리소스를 찾을 수 없음" 예외를 일으킬 수 있는 세션 컨테이너의 몇 가지 버그가 수정되었습니다.

1.9.5

  • 집계 쿼리(COUNT, MIN, MAX, SUM 및 AVG)에 대한 지원이 추가되었습니다.
  • 변경 피드에 대한 지원이 추가되었습니다.
  • RequestOptions.setPopulateQuotaInfo를 통해 컬렉션 할당량 정보에 대한 지원이 추가되었습니다.
  • RequestOptions.setScriptLoggingEnabled를 통해 저장 프로시저 스크립트 로깅에 대한 지원이 추가되었습니다.
  • 제한 오류가 발생할 때 DirectHttps 모드의 쿼리 응답이 중지될 수 있는 버그가 수정되었습니다.
  • 세션 일관성 모드에서 버그가 수정되었습니다.
  • 요청 속도가 높을 때 HttpContext에서 NullReferenceException이 발생할 수 있는 버그를 수정합니다.
  • DirectHttps 모드의 성능이 향상되었습니다.

1.9.4

  • 커넥트ionPolicy.setProxy() API를 사용하여 간단한 클라이언트 인스턴스 기반 프록시 지원이 추가되었습니다.
  • DocumentClient 인스턴스를 제대로 닫기 위해 DocumentClient.close() API가 추가되었습니다.
  • 게이트웨이 대신 네이티브 어셈블리에서 쿼리 계획을 파생시켜 직접 연결 모드에서 쿼리 성능을 향상시켰습니다.
  • 사용자가 POJO(Plain Old Java Object)에서 JsonIgnoreProperties를 정의할 필요가 없도록 FAIL_ON_UNKNOWN_PROPERTIES = false를 설정합니다.
  • SLF4J를 사용하도록 리팩터링된 로깅
  • 일관성 판독기의 몇 가지 버그를 수정했습니다.

1.9.3

  • 직접 연결 모드에서 연결 누수 방지를 위해 연결 관리의 버그가 수정되었습니다.
  • TOP 쿼리에서 NullReference 예외를 throw할 수 있는 버그가 수정되었습니다.
  • 내부 캐시에 대한 네트워크 호출 수를 줄여 성능을 향상시켰습니다.
  • 문제 해결을 위해 DocumentClientException에 상태 코드, ActivityID 및 요청 URI가 추가되었습니다.

1.9.2

  • 연결 관리의 문제를 해결하여 안정성을 높였습니다.

1.9.1

  • BoundedStaleness 일관성 수준에 대한 지원이 추가되었습니다.
  • 분할된 컬렉션의 CRUD 작업에 대한 직접 연결 지원이 추가되었습니다.
  • SQL을 사용하여 데이터베이스를 쿼리하는 버그가 수정되었습니다.
  • 세션 토큰이 잘못 설정될 수 있는 세션 캐시의 버그가 수정되었습니다.

1.9.0

  • 파티션 간 병렬 쿼리에 대한 지원이 추가되었습니다.
  • 분할된 컬렉션에 대한 TOP/ORDER BY 쿼리에 대한 지원이 추가되었습니다.
  • 강력한 일관성에 대한 지원이 추가되었습니다.
  • 직접 연결을 사용할 때 이름 기반 요청에 대한 지원이 추가되었습니다.
  • 모든 요청 재시도에서 ActivityId가 일관성을 유지하도록 수정되었습니다.
  • 동일한 이름의 컬렉션을 다시 만들 때 세션 캐시와 관련된 버그가 수정되었습니다.
  • 지역 펜싱 공간 쿼리에 대한 컬렉션 인덱싱 정책을 지정하는 동안 Polygon 및 LineString DataTypes가 추가되었습니다.
  • Java 1.8용 Java Doc 관련 문제가 해결되었습니다.

1.8.1

  • PartitionKeyDefinitionMap에서 단일 파티션 컬렉션을 캐시하고 추가 페치 파티션 키 요청을 하지 않는 버그가 수정되었습니다.
  • 잘못된 파티션 키 값이 제공될 때 다시 시도하지 않는 버그가 수정되었습니다.

1.8.0

  • 다중 지역 데이터베이스 계정에 대한 지원이 추가되었습니다.
  • 최대 재시도 시도 및 최대 재시도 대기 시간을 사용자 지정하는 옵션을 사용하여 제한된 요청에 대한 자동 재시도 지원이 추가되었습니다. 자세한 내용은 RetryOptions 및 커넥트IonPolicy.getRetryOptions()를 참조하세요.
  • 사용되지 않는 IPartitionResolver 기반 사용자 지정 분할 코드입니다. 더 높은 스토리지 및 처리량을 위해 분할된 컬렉션을 사용합니다.

1.7.1

  • 속도 제한에 대한 재시도 정책 지원이 추가되었습니다.

1.7.0

  • 문서에 대한 TTL(Time to Live) 지원이 추가되었습니다.

1.6.0

1.5.1

  • 다른 SDK(소프트웨어 개발 키트)와 일치하도록 little-endian에서 해시 값을 생성하는 HashPartitionResolver의 버그를 수정했습니다.

1.5.0

  • 여러 파티션 간의 애플리케이션 분할을 지원하기 위해 해시 및 범위 파티션 해결 프로그램을 추가합니다.

1.4.0

  • Upsert를 구현합니다. Upsert 기능을 지원하기 위해 추가된 새로운 upsertXXX 메서드입니다.
  • ID 기반 라우팅을 구현합니다. 공용 API가 변경되지 않고 모든 변경 내용이 내부적으로 변경됩니다.

1.3.0

  • 다른 SDK와 일치하는 버전 번호를 가져오기 위해 건너뛴 릴리스

1.2.0

  • 지리 공간적 인덱스를 지원합니다.
  • 모든 리소스에 대한 ID 속성의 유효성을 검사합니다. 리소스의 ID에는 공백으로 끝나거나, , /, #\문자가 포함될 ?수 없습니다.
  • ResourceResponse에 새 헤더 "인덱스 변환 진행률"을 추가합니다.

1.1.0

  • V2 인덱싱 정책 구현

1.0.0

  • GA SDK

릴리스 및 사용 중지 날짜

Microsoft는 최신/지원 버전으로 원활히 전환할 수 있도록 SDK 사용 중지 최소 12개월 전에 알림을 제공합니다. 새로운 기능 및 최적화는 현재 SDK에만 추가됩니다. 항상 가능한 한 빨리 최신 SDK 버전으로 업그레이드하는 것이 좋습니다.

Warning

2020년 30일 이후 Azure Cosmos DB는 더 이상 버그 수정을 수행하고, 새 기능을 추가하고, NoSQL용 API용 Azure Cosmos DB Java SDK 버전 1.x를 지원하지 않습니다. 업그레이드하지 않을 경우 SDK의 버전 1.x에서 전송된 요청은 Azure Cosmos DB 서비스에서 계속 처리됩니다.

2016년 2월 29일 이후 Azure Cosmos DB는 더 이상 버그를 수정하거나 새로운 기능을 추가하거나 NoSQL용 API의 Azure Cosmos DB Java SDK 버전 0.x에 대한 지원을 제공하지 않습니다. 업그레이드하지 않으려는 경우 SDK 버전 0.x에서 보낸 요청은 Azure Cosmos DB 서비스에서 계속 제공됩니다.

버전 출시 날짜 사용 중지 날짜
2.6.1 2020년 12월 17일 2024년 2월 29일
2.6.0 2020년 7월 16일 2024년 2월 29일
2.5.1 2020년 6월 3일 2024년 2월 29일
2.5.0 2020년 5월 12일 2024년 2월 29일
2.4.7 2020년 2월 20일 2024년 2월 29일
2.4.6 2020년 1월 24일 2024년 2월 29일
2.4.5 2019년 11월 10일 2024년 2월 29일
2.4.4 2019년 10월 24일 2024년 2월 29일
2.4.2 2019년 9월 26일 2024년 2월 29일
2.4.1 2019년 7월 18일 2024년 2월 29일
2.4.0 2019년 5월 4일 2024년 2월 29일
2.3.0 2019년 4월 24일 2024년 2월 29일
2.2.3 2019년 4월 16일 2024년 2월 29일
2.2.2 2019년 4월 5일 2024년 2월 29일
2.2.0 2019년 3월 27일 2024년 2월 29일
2.1.3 2019년 3월 13일 2024년 2월 29일
2.1.2 2019년 3월 9일 2024년 2월 29일
2.1.1 2018년 12월 13일 2024년 2월 29일
2.1.0 2018년 11월 20일 2024년 2월 29일
2.0.0 2018년 9월 21일 2024년 2월 29일
1.16.4 2018년 9월 10일 2020년 5월 30일
1.16.3 Sept 09, 2018 2020년 5월 30일
1.16.2 2018년 6월 29일 2020년 5월 30일
1.16.1 2018년 5월 16일 2020년 5월 30일
1.16.0 2018년 3월 15일 2020년 5월 30일
1.15.0 2017년 11월 14일 2020년 5월 30일
1.14.0 2017년 10월 28일 2020년 5월 30일
1.13.0 2017년 8월 25일 2020년 5월 30일
1.12.0 2017년 7월 11일 2020년 5월 30일
1.11.0 2017년 5월 10일 2020년 5월 30일
1.10.0 2017년 3월 11일 토요일 2020년 5월 30일
1.9.6 2017년 2월 21일 2020년 5월 30일
1.9.5 2017년 1월 31일 2020년 5월 30일
1.9.4 2016년 11월 24일 2020년 5월 30일
1.9.3 2016년 10월 30일 2020년 5월 30일
1.9.2 2016년 10월 28일 2020년 5월 30일
1.9.1 2016년 10월 26일 2020년 5월 30일
1.9.0 2016년 10월 3일 2020년 5월 30일
1.8.1 2016년 6월 30일 2020년 5월 30일
1.8.0 2016년 6월 14일 2020년 5월 30일
1.7.1 2016년 4월 30일 2020년 5월 30일
1.7.0 2016년 4월 27일 2020년 5월 30일
1.6.0 2016년 3월 29일 2020년 5월 30일
1.5.1 2015년 12월 31일 목요일 2020년 5월 30일
1.5.0 2015년 12월 4일 2020년 5월 30일
1.4.0 2015년 10월 5일 2020년 5월 30일
1.3.0 2015년 10월 5일 2020년 5월 30일
1.2.0 2015년 8월 5일 2020년 5월 30일
1.1.0 2015년 7월 9일 2020년 5월 30일
1.0.1 2015년 5월 12일 2020년 5월 30일
1.0.0 2015년 4월 7일 2020년 5월 30일
0.9.5-prelease 2015년 3월 9일 2016년 2월 29일
0.9.4-prelease 2015년 2월 17일 2016년 2월 29일
0.9.3-prelease 2015년 1월 13일 2016년 2월 29일
0.9.2-prelease 2014년 12월 19일 2016년 2월 29일
0.9.1-시험판 2014년 12월 19일 2016년 2월 29일
0.9.0-prelease 2014년 12월 10일 2016년 2월 29일

질문과 대답

사용 중지된 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 또는 커넥터에 항상 즉시 추가되는 것은 아닙니다. 지원되지 않는 기능 중 추가하려는 기능이 있는 경우 커뮤니티 포럼에 피드백을 추가합니다.