SQL API용 Azure Cosmos DB Node.js SDK: 릴리스 정보 및 리소스

적용 대상: SQL API

리소스 링크
SDK 다운로드 NPM
API 설명서 JavaScript SDK 참조 설명서
SDK 설치 지침 설치 지침
SDK에 참여 GitHub
샘플 Node.js 코드 샘플
시작 자습서 JavaScript SDK 시작
웹앱 자습서 Azure Cosmos DB를 사용하여 Node.js 웹 애플리케이션 빌드
현재 지원되는 플랫폼 Node.js v12.x - SDK 버전 3.x.x
Node.js v10.x - SDK 버전 3.x.x
Node.js v8.x - SDK 버전 3.x.x
Node.js v6.x - SDK 버전 2.x.x
Node.js v4.2.0- SDK 버전 1.x.x
Node.js v0.12- SDK 버전 1.x.x
Node.js v0.10- SDK 버전 1.x.x

릴리스 정보

3.1.0

  • 기본 ResponseContinuationTokenLimitInKB를 1kb로 설정했습니다. 기본적으로 긴 헤더를 방지하지 위해 1kb로 제한하는 것입니다(Node.js에는 전역 헤더 크기 제한이 있음). 사용자는 이 필드를 긴 헤더를 허용하도록 설정할 수 있습니다. 그러면 백 엔드에서 쿼리 실행을 최적화하는 데 도움이 될 수 있습니다.
  • disableSSLVerification을 제거했습니다. 이 옵션에는 #388에 설명된 새로운 대안이 있습니다.

3.0.4

  • initialHeaders가 파티션 키 헤더를 명시적으로 설정하도록 허용
  • package.json#files를 사용하여 불필요한 파일이 게시되는 것 방지
  • 이전 버전의 node+v8에서 라우팅 맵 정렬 오류 수정
  • 사용자가 부분 다시 시도 옵션을 제공했을 때의 버그 수정

3.0.3

  • Webpack이 필수로 호출된 모듈을 확인하는 것 방지

3.0.2

  • RU가 집계 쿼리에 대해 항상 0으로 보고되는 장기 미해결 버그 수정

3.0.0

🎉 v3 릴리스! 🎉 다양한 새 기능, 버그 수정 및 몇 가지 주요 변경 내용이 있습니다. 이 릴리스의 주요 목표:

  • 주요 새로운 기능을 구현
    • DISTINCT 쿼리
    • LIMIT/OFFSET 쿼리
    • 사용자 취소 가능한 요청
  • 모든 컨테이너가 무제한으로 확장된 최신 Cosmos REST API 버전으로 업데이트
  • 브라우저에서 Cosmos를 보다 쉽게 사용
  • 새 Azure JS SDK 지침에 맞게 조정

주요 변경 내용에 대한 마이그레이션 가이드

향상된 클라이언트 생성자 옵션

생성자 옵션이 간소화되었습니다.

  • masterKey를 key로 이름 변경하고 최상위 수준으로 이동했습니다.
  • 이전에 options.auth 아래에 있던 속성을 최상위 수준으로 이동했습니다.
// v2
const client = new CosmosClient({
    endpoint: "https://your-database.cosmos.azure.com",
    auth: {
        masterKey: "your-primary-key"
    }
})

// v3
const client = new CosmosClient({
    endpoint: "https://your-database.cosmos.azure.com",
    key: "your-primary-key"
})
간소화된 QueryIterator API

v2에서는 쿼리 결과를 반복하거나 검색하는 다양한 방법이 있었습니다. v3 API를 간소화하고 유사하거나 중복된 API를 제거하려고 노력했습니다.

  • iterator.next() 및 iterator.current()를 제거했습니다. fetchNext()를 사용하여 결과 페이지를 가져옵니다.
  • iterator.forEach()를 제거했습니다. 대신 비동기 반복기를 사용합니다.
  • iterator.executeNext()를 iterator.fetchNext()로 이름을 변경했습니다.
  • iterator.toArray()를 iterator.fetchAll()로 이름을 변경했습니다.
  • 이제 페이지가 일반 JS 개체가 아닌 적절한 응답 개체입니다.
  • const container = client.database(dbId).container(containerId)
// v2
container.items.query('SELECT * from c').toArray()
container.items.query('SELECT * from c').executeNext()
container.items.query('SELECT * from c').forEach(({ body: item }) => { console.log(item.id) })

// v3
container.items.query('SELECT * from c').fetchAll()
container.items.query('SELECT * from c').fetchNext()
for await(const { result: item } in client.databases.readAll().getAsyncIterator()) {
    console.log(item.id)
}
이제 고정 컨테이너가 분할됨

이제 Cosmos 서비스는 이전에 고정 컨테이너로 만든 컨테이너를 포함하여 모든 컨테이너의 파티션 키를 지원합니다. v3 SDK는이 변경 내용을 구현하는 최신 API 버전으로 업데이트되지만 호환성이 손상되지는 않습니다. 작업에 대한 파티션 키를 제공하지 않으면 기존 컨테이너와 문서 모두에서 작동하는 시스템 키가 기본값으로 사용됩니다.

저장 프로시저에 대해 upsert 제거

이전에는 분할되지 않은 컬렉션에 대해 upsert를 허용했지만 API 버전 업데이트에서는 모든 컬렉션이 분할되므로 이를 완전히 제거했습니다.

항목 읽기가 404에서 throw되지 않음

const container = client.database(dbId).container(containerId)

// v2
try {
    container.items.read(id, undefined)
} catch (e) {
    if (e.code === 404) { console.log('item not found') }
}

// v3
const { result: item }  = container.items.read(id, undefined)
if (item === undefined) { console.log('item not found') }
기본 다중 지역 쓰기

이제 Cosmos 구성에서 지원하는 경우 SDK는 기본적으로 여러 지역에 쓸 수 있습니다. 이전에는 옵트인 동작이었습니다.

적절한 오류 개체

이제 실패한 요청은 적절한 오류 또는 오류 하위 클래스를 throw합니다. 이전에는 일반 JS 개체를 throw했습니다.

새로운 기능

사용자 취소 가능한 요청

내부적으로 fetch로 이동하면 브라우저가 AbortController API를 사용하여 사용자 취소 가능한 작업을 지원할 수 있습니다. 잠재적으로 여러 요청이 진행 중인 작업(예: 파티션 간 쿼리)의 경우 작업에 대한 모든 요청이 취소됩니다. 최신 브라우저 사용자는 이미 AbortController가 있습니다. Node.js 사용자는 보충 기능 라이브러리를 사용해야 합니다.

 const controller = new AbortController()
 const {result: item} = await items.query('SELECT * from c', { abortSignal: controller.signal});
 controller.abort()
db/container create 작업의 일부로 처리량 설정
const { database }  = client.databases.create({ id: 'my-database', throughput: 10000 })
database.containers.create({ id: 'my-container', throughput: 10000 })
@azure/cosmos-sign

헤더 토큰 생성이 새 라이브러리 @azure/cosmos-sign으로 분할되었습니다. Cosmos REST API를 직접 호출하는 모든 사용자는 이를 사용하여 @azure/cosmos 내부에서 호출하는 동일한 코드를 사용하여 헤더에 서명할 수 있습니다.

생성된 ID의 UUID

v2에는 항목 ID를 생성하는 사용자 지정 코드가 있습니다. 잘 알려져 있고 유지 관리되는 커뮤니티 라이브러리 uuid로 전환했습니다.

연결 문자열

이제 Azure Portal에서 복사된 연결 문자열을 전달할 수 있습니다.

const client = new CosmosClient("AccountEndpoint=https://test-account.documents.azure.com:443/;AccountKey=c213asdasdefgdfgrtweaYPpgoeCsHbpRTHhxuMsTaw==;")
Add DISTINCT and LIMIT/OFFSET queries (#306)
 const { results } = await items.query('SELECT DISTINCT VALUE r.name FROM ROOT').fetchAll()
 const { results } = await items.query('SELECT * FROM root r OFFSET 1 LIMIT 2').fetchAll()

향상된 브라우저 환경

브라우저에서 v2 SDK를 사용할 수 있었지만 이상적인 환경은 아니었습니다. 여러 node.js 기본 제공 라이브러리를 보충하고 Webpack 또는 Parcel 같은 번들러를 사용해야 했습니다. v3 SDK를 사용하면 브라우저 사용자에게 가장 적합한 환경을 사용할 수 있습니다.

  • 요청 내부 구조를 fetch로 바꿈(#245)
  • 버퍼 사용 제거(#330)
  • 노드 기본 제공 사용 제거 및 노드 유니버설 패키지/API 사용(#328)
  • node-abort-controller로 전환(#294)

버그 수정

  • 제품 읽기 수정 및 제품 테스트 다시 사용(#224)
  • EnableEndpointDiscovery 수정(#207)
  • 페이지가 매겨진 결과에서 누락된 RU 수정(#360)
  • SQL 쿼리 매개 변수 형식 확장(#346)
  • ItemDefinition에 ttl 추가(#341)
  • CP 쿼리 메트릭 수정(#311)
  • FeedResponse에 activityId 추가(#293)
  • _ts 형식을 문자열에서 숫자로 전환(#252)(#295)
  • 요청 요금 집계 수정(#289)
  • 빈 문자열 파티션 키 허용(#277)
  • 충돌 쿼리 형식에 문자열 추가(#237)
  • 컨테이너에 uniqueKeyPolicy 추가(#234)

엔지니어링 시스템

항상 가장 눈에 띄는 변경 사항은 아니지만 팀이 더 나은 코드를 더 빠르게 제공하는 데 도움이 됩니다.

  • 프로덕션 빌드에 롤업 사용(#104)
  • Typescript 3.5로 업데이트(#327)
  • TS 프로젝트 참조로 변환. 테스트 폴더 추출(#270)
  • noUnusedLocals 및 noUnusedParameters 사용(#275)
  • CI 빌드용 Azure Pipelines YAML(#298)

2.1.5

  • 코드 변경이 없습니다. 2.1.4 패키지에 일부 추가 파일이 포함된 문제를 수정했습니다.

2.1.4

  • 다시 시도 정책 내에서 지역별 장애 조치(failover)를 수정
  • ChangeFeed hasMoreResults 속성을 수정
  • Dev 종속성 업데이트
  • PolicheckExclusions.txt 추가

2.1.3

  • _ts 형식을 문자열에서 숫자로 전환
  • 기본 인덱싱 테스트를 수정
  • uniqueKeyPolicy를 v2로 백포팅
  • 데모 및 데모 디버깅을 수정

2.1.2

  • v3 분기에서 제품 수정을 백포팅
  • executeNext() 형식 서명에서 버그를 수정
  • 오타 수정

2.1.1

  • 빌드 재구성. 빌드 시 SDK 버전 끌어오기를 허용합니다.

2.1.0

새로운 기능

  • ChangeFeed 지원 추가(#196)
  • 인덱싱을 위한 MultiPolygon 데이터 형식 추가(#191)
  • masterKey에 대한 별칭으로 생성자에 "key" 속성 추가(#202)

수정 프로그램

  • 반복기에서 next()가 잘못된 값을 반환하는 버그 수정

엔지니어링 기능 향상

  • typescript 소비에 대한 통합 테스트 추가(#199)
  • GitHub에서 직접 설치 사용(#194)

2.0.5

  • 노드 에이전트 형식의 인터페이스를 추가합니다. Typescript 사용자는 더 이상 @types/node를 종속성으로 설치할 필요가 없습니다.
  • 이제 기본 위치가 제대로 적용됩니다.
  • 개발자 설명서에 포함된 향상된 기능
  • 다양한 오타 수정

2.0.4

  • 2.0.3에 도입된 형식 정의 문제 수정

2.0.3

  • big-integer 종속성 제거
  • AsyncIterable 형식에 대한 참조 지시문으로 전환 Typescript 사용자는 더 이상 해당 "lib" 설정을 사용자 지정할 필요가 없습니다.
  • 오타 수정

2.0.2

  • 추가 정보 링크 수정

2.0.1

  • 재시도 인터페이스 구현 수정

2.0.0

  • JavaScript SDK 버전 2.0.0 GA
  • 다중 지역 쓰기 지원이 추가되었습니다.

2.0.0-3

  • 공개 미리 보기용 JavaScript SDK 버전 2.0.0의 RC1
  • 관련 데이터베이스, 컨테이너 및 항목 클래스에 분할된 최상위 CosmosClient 및 메서드가 있는 새로운 개체 모델
  • 프라미스에 대한 지원
  • TypeScript로 변환된 SDK

1.14.4

  • npm 설명서가 수정되었습니다.

1.14.3

  • 연결 문제에 대한 기본 재시도 지원이 추가되었습니다.
  • 컬렉션 변경 피드 읽기에 대한 지원이 추가되었습니다.
  • 일시적인 "읽기 세션을 사용할 수 없음" 세션 일관성 버그가 수정되었습니다.
  • 쿼리 메트릭에 대한 지원이 추가되었습니다.
  • http 에이전트의 최대 연결 수가 수정되었습니다.

1.14.2

  • Azure DocumentDB 대신 Azure Cosmos DB를 참조하도록 업데이트된 설명서입니다.
  • ConnectionPolicy에서 proxyUrl 설정에 대한 지원이 추가되었습니다.

1.14.1

  • 대/소문자 구분 파일 시스템에 대해 사소한 수정이 있었습니다.

1.14.0

  • 세션 일관성에 대한 지원이 추가되었습니다.
  • 이 SDK 버전을 사용하려면 최신 버전의 Azure Cosmos DB 에뮬레이터가 필요합니다.

1.13.0

  • 파티션 간 쿼리를 분할 검증했습니다
  • 선행 및 후행 슬래시(및 해당 테스트)와의 리소스 링크 지원이 추가되었습니다.

1.12.2

  • npm 설명서가 수정되었습니다.

1.12.1

  • 관련된 문서에 특수 유니코드 문자(LS, PS)가 있는 executeStoredProcedure의 버그를 수정했습니다.
  • 파티션 키의 유니코드 문자를 사용하여 문서를 처리할 때 버그를 수정했습니다.
  • 이름 미디어를 사용하여 컬렉션을 만들기 위한 지원을 수정했습니다. GitHub 문제 #114.
  • 권한 부여 토큰에 대한 지원을 수정했습니다. GitHub 문제 #178.

1.12.0

  • ConsistentPrefix라고 하는 새로운 일관성 수준에 대한 지원이 추가되었습니다.
  • UriFactory에 대한 지원이 추가되었습니다.
  • 유니코드 지원 버그를 수정했습니다. GitHub 문제 #171.

1.11.0

  • 집계 쿼리(COUNT, MIN, MAX, SUM 및 AVG)에 대한 지원이 추가되었습니다.
  • 파티션 간 쿼리에 대한 병렬 처리 수준을 제어하기 위한 옵션을 추가했습니다.
  • Azure Cosmos DB 에뮬레이터에 대해 실행하는 경우 TLS 유효성 검사를 비활성화하기 위한 옵션을 추가했습니다.
  • 분할된 컬렉션에 대한 최소 처리량이 10,100RU/s에서 2500RU/s로 감소됩니다.
  • 단일 파티션 컬렉션에 대한 연속 토큰 버그를 수정했습니다. GitHub 문제 #107.
  • 단일 매개 변수인 0을 처리하는 도중 executeStoredProcedure 버그를 수정했습니다. GitHub 문제 #155.

1.10.2

  • SDK 버전을 포함하도록 수정된 사용자 에이전트 헤더입니다.
  • 사소한 코드 정리입니다.

1.10.1

  • SDK를 사용하여 에뮬레이터를 대상으로 지정할 때(hostname=localhost) TLS 유효성 검사를 사용하지 않도록 설정됩니다.
  • 저장된 프로시저가 실행되는 동안 스크립트 로깅을 사용할 수 있도록 지원이 추가되었습니다.

1.10.0

  • 파티션 간 병렬 쿼리에 대한 지원이 추가되었습니다.
  • 분할된 컬렉션의 TOP/ORDER BY 쿼리에 대한 지원이 추가되었습니다.

1.9.0

  • 제한된 요청에 대한 재시도 정책 지원이 추가되었습니다. (제한된 요청은 오류 코드 429, 요청 속도가 너무 크다는 예외를 수신합니다.) 기본적으로 오류 코드 429가 발생하면 Azure Cosmos DB는 각 요청을 9번 다시 시도하며 응답 헤더에서 retryAfter 시간을 적용합니다. 이제 다시 시도 간의 서버에서 반환한 retryAfter 시간을 무시하려는 경우 고정된 다시 시도 간격 시간은 ConnectionPolicy 개체에서 RetryOptions 속성의 일부로 설정될 수 있습니다. Azure Cosmos DB는 제한된 요청 각각에 대해 30초 동안 대기하고(다시 시도 횟수와 관계 없이) 오류 코드 429를 포함하는 응답을 반환합니다. 이 시간도 ConnectionPolicy 개체에 있는 RetryOptions 속성에서 재정의할 수 있습니다.
  • 이제 Cosmos DB는 x-ms-throttle-retry-count 및 x-ms-throttle-retry-wait-time-ms를 다시 시도 사이에 요청이 대기한 제한 다시 시도 수 및 누적 시간을 표시하는 모든 요청의 응답 헤더로 반환합니다.
  • 기본 다시 시도 옵션의 일부를 재정의하는 데 사용할 수 있는 ConnectionPolicy 클래스에 RetryOptions 속성을 노출하여 RetryOptions 클래스를 추가했습니다.

1.8.0

  • 다중 지역 데이터베이스 계정에 대한 지원이 추가되었습니다.

1.7.0

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

1.6.0

1.5.6

  • 잘못된 concat 결과로 인해 링크를 반환하지 못했던 RangePartitionResolver.resolveForRead 버그가 수정되었습니다.

1.5.5

  • hashPartitionResolver resolveForRead() 해결: 예외를 throw하는 제공된 파티션 키가 없는 경우 모든 등록된 링크의 목록을 대신 반환합니다.

1.5.4

  • 문제 해결 #100 - 전용 HTTPS 에이전트: Azure Cosmos DB 목적으로 전역 에이전트를 수정하지 않도록 합니다. 모든 lib의 요청에 대해 전용 에이전트를 사용합니다.

1.5.3

  • 문제 #81 해결 - 미디어 ID에서 대시를 올바르게 처리합니다.

1.5.2

  • 문제 해결 #95 - EventEmitter 수신기 누수 경고

1.5.1

  • 문제 #92 해결 - 대/소문자 구분 시스템으로 인해 Hash 폴더의 이름을 hash로 바꿉니다.

1.5.0

  • 해시 및 범위 파티션 해결 프로그램을 추가하여 분할 지원 구현

1.4.0

  • Upsert를 구현합니다. DocumentClient의 새로운 upsertXXX 메서드입니다.

1.3.0

  • 다른 SDK와 정렬된 버전 번호를 가져오기 위해 건너뛰었습니다.

1.2.2

  • 프라미스 래퍼를 새 리포지토리로 분할합니다.
  • npm 레지스트리에 대한 패키지 파일로 업데이트합니다.

1.2.1

  • ID 기반 라우팅을 구현합니다.
  • 문제 #49 수정 - 현재 속성이 메서드 current()와 충돌합니다.

1.2.0

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

1.1.0

  • V2 인덱싱 정책을 구현합니다.

1.0.3

  • 문제 #40 - 핵심 및 프라미스 SDK에서 eslint 및 grunt 구성을 구현했습니다.

1.0.2

  • 문제 #45 - 프라미스 래퍼에 오류가 있는 헤더가 포함되지 않습니다.

1.0.1

  • readConflicts, readConflictAsync 및 queryConflicts를 추가하여 충돌을 쿼리하는 기능을 구현했습니다.
  • API 설명서가 업데이트되었습니다.
  • 문제 #41 - client.createDocumentAsync 오류

1.0.0

  • GA SDK.

릴리스 및 사용 중지 날짜

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

버전 출시 날짜 사용 중지 날짜
3.1.0 2019년 7월 26일 ---
3.0.4 2019년 7월 22일 ---
3.0.3 2019년 7월 17일 ---
3.0.2 2019년 7월 9일 ---
3.0.0 2019년 6월 28일 ---
2.1.5 2019년 3월 20일 ---
2.1.4 2019년 3월 15일 ---
2.1.3 2019년 3월 8일 ---
2.1.2 2019년 1월 28일 ---
2.1.1 2018년 12월 5일 ---
2.1.0 2018년 12월 4일 ---
2.0.5 2018년 11월 7일 ---
2.0.4 2018년 10월 30일 ---
2.0.3 2018년 10월 30일 ---
2.0.2 2018년 10월 10일 ---
2.0.1 2018년 9월 25일 ---
2.0.0 2018년 9월 24일 ---
2.0.0-3(RC) 2018년 8월 2일 ---
1.14.4 2018년 5월 3일 2020년 8월 30일
1.14.3 2018년 5월 3일 2020년 8월 30일
1.14.2 2017년 12월 21일 2020년 8월 30일
1.14.1 2017년 11월 10일 2020년 8월 30일
1.14.0 2017년 11월 9일 2020년 8월 30일
1.13.0 2017년 10월 11일 2020년 8월 30일
1.12.2 2017년 8월 10일 2020년 8월 30일
1.12.1 2017년 8월 10일 2020년 8월 30일
1.12.0 2017년 5월 10일 2020년 8월 30일
1.11.0 2017년 3월 16일 2020년 8월 30일
1.10.2 2017년 1월 27일 2020년 8월 30일
1.10.1 2016년 12월 22일 2020년 8월 30일
1.10.0 2016년 10월 3일 2020년 8월 30일
1.9.0 2016년 7월 7일 2020년 8월 30일
1.8.0 2016년 6월 14일 2020년 8월 30일
1.7.0 2016년 4월 26일 2020년 8월 30일
1.6.0 2016년 3월 29일 2020년 8월 30일
1.5.6 2016년 3월 8일 2020년 8월 30일
1.5.5 2016년 2월 2일 2020년 8월 30일
1.5.4 2016년 2월 1일 2020년 8월 30일
1.5.2 2016년 1월 26일 2020년 8월 30일
1.5.2 2016년 1월 22일 2020년 8월 30일
1.5.1 2016년 1월 4일 2020년 8월 30일
1.5.0 2015년 12월 31일 2020년 8월 30일
1.4.0 2015년 10월 6일 2020년 8월 30일
1.3.0 2015년 10월 6일 2020년 8월 30일
1.2.2 2015년 9월 10일 2020년 8월 30일
1.2.1 2015년 8월 15일 2020년 8월 30일
1.2.0 2015년 8월 5일 2020년 8월 30일
1.1.0 2015년 7월 9일 2020년 8월 30일
1.0.3 2015년 6월 4일 2020년 8월 30일
1.0.2 2015년 5월 23일 2020년 8월 30일
1.0.1 2015년 5월 15일 2020년 8월 30일
1.0.0 2015년 4월 8일 2020년 8월 30일

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 버전을 지원하지 않습니다.

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

참고 항목

Cosmos DB에 대한 자세한 내용은 Microsoft Azure Cosmos DB 서비스 페이지를 참조하세요.