适用于 SQL API 的 Azure Cosmos DB Java SDK:发行说明和资源Azure Cosmos DB Java SDK for SQL API: Release notes and resources

这是适用于 SQL API 的原始 Azure Cosmos DB 同步 Java SDK v2,支持同步操作。This is the original Azure Cosmos DB Sync Java SDK v2 for SQL API which supports synchronous operations.

重要

这不是最新的 Azure Cosmos DB Java SDK!This is not the latest Java SDK for Azure Cosmos DB! 请考虑将 Azure Cosmos DB Java SDK v4 用于项目。Consider using Azure Cosmos DB Java SDK v4 for your project. 若要升级,请按照迁移到 Azure Cosmos DB Java SDK v4 指南和 Reactor 与 RxJava 指南中的说明进行操作。To upgrade, follow the instructions in the Migrate to Azure Cosmos DB Java SDK v4 guide and the Reactor vs RxJava guide.

SDK 下载SDK Download MavenMaven
API 文档API documentation Java API 参考文档Java API reference documentation
参与 SDKContribute to SDK GitHubGitHub
入门Get started Java SDK 入门Get started with the Java SDK
Web 应用教程Web app tutorial 使用 Azure Cosmos DB 开发 Web 应用程序Web application development with Azure Cosmos DB
受支持的最小运行时Minimum supported runtime Java 开发工具包 (JDK) 7+Java Development Kit (JDK) 7+

发行说明Release notes

2.5.12.5.1

  • 修复了 documentCollection 查询的主分区缓存问题。Fixes master partition cache issue on documentCollection query.

2.5.02.5.0

  • 添加了对 449 重试自定义配置的支持。Added support for 449 retry custom configuration.

2.4.72.4.7

  • 修复了连接池超时问题。Fixes connection pool timeout issue.
  • 修复了内部重试时的身份验证令牌刷新。Fixes auth token refresh on internal retries.

2.4.62.4.6

  • 更新了 databaseAccount 上正确的客户端副本策略标记,并从缓存中读取 databaseAccount 配置。Updated correct client side replica policy tag on databaseAccount and made databaseAccount configuration reads from cache.

2.4.52.4.5

  • 如果用户提供 pkRangeId,则避免重试无效的分区键范围错误。Avoiding retry on invalid partition key range error, if user provides pkRangeId.

2.4.42.4.4

  • 优化了分区键范围缓存刷新。Optimized partition key range cache refreshes.
  • 修复了以下问题:SDK 不接受来自服务器的分区拆分提示,导致客户端路由缓存刷新不正确。Fixes the scenario where the SDK doesn't entertain partition split hint from server and results in incorrect client side routing caches refresh.

2.4.22.4.2

  • 优化了集合缓存刷新。Optimized collection cache refreshes.

2.4.12.4.1

  • 添加了对从请求诊断字符串检索内部异常消息的支持。Added support to retrieve inner exception message from request diagnostic string.

2.4.02.4.0

  • 在 PartitionKeyDefinition 上引入版本 api。Introduced version api on PartitionKeyDefinition.

2.3.02.3.0

  • 为直接模式添加了单独的超时支持。Added separate timeout support for direct mode.

2.2.32.2.3

  • 使用服务的 Null 错误消息并生成文档客户端异常。Consuming null error message from service and producing document client exception.

2.2.22.2.2

  • 套接字连接改进,添加 SoKeepAlive 默认值 true。Socket connection improvement, adding SoKeepAlive default true.

2.2.02.2.0

  • 添加了请求诊断字符串支持。Added request diagnostics string support.

2.1.32.1.3

  • 修复了适用于哈希 V2 的 PartitionKey 中的 bug。Fixed bug in PartitionKey for Hash V2.

2.1.22.1.2

  • 添加了对组合索引的支持。Added support for composite indexes.
  • 修复了多区域终结点管理器中的 bug 以强制刷新。Fixed bug in multiple-regional endpoint manager to force refresh.
  • 修复了在直接模式下使用前提条件更新插入的 bug。Fixed bug for upserts with pre-conditions in direct mode.

2.1.12.1.1

  • 修复了网关地址缓存中的 bug。Fixed bug in gateway address cache.

2.1.02.1.0

  • 为直接模式添加了多区域写入支持。Multi-region write support added for direct mode.
  • 添加了对处理从代理作为 ServiceUnavailable 异常引发的 IOExceptions 的支持。Added support for handling IOExceptions thrown as ServiceUnavailable exceptions, from a proxy.
  • 修复了终结点发现重试策略中的 bug。Fixed a bug in endpoint discovery retry policy.
  • 修复了 bug,以确保 BaseDatabaseAccountConfigurationProvider 不会引发空指针异常。Fixed a bug to ensure null pointer exceptions are not thrown in BaseDatabaseAccountConfigurationProvider.
  • 修复了 bug,以确保查询迭代器不会返回 Null 值。Fixed a bug to ensure QueryIterator does not return nulls.
  • 修复了 bug,以确保允许较大的 PartitionKeyFixed a bug to ensure large PartitionKey is allowed

2.0.02.0.0

  • 为网关模式添加了多区域写入支持。Multi-region write support added for gateway mode.

1.16.41.16.4

  • 修复了读取查询的分区键范围时的 bug。Fixed a bug in Read partition Key ranges for a query.

1.16.31.16.3

  • 修复了在 DirectHttps 模式下设置继续标记标头大小时的 bug。Fixed a bug in setting continuation token header size in DirectHttps mode.

1.16.21.16.2

  • 添加了流式故障转移支持。Added streaming fail over support.
  • 添加了对自定义元数据的支持。Added support for custom metadata.
  • 改进了会话处理逻辑。Improved session handling logic.
  • 修复了分区键范围缓存中的 bug。Fixed a bug in partition key range cache.
  • 修复了直接模式下的 NPE bug。Fixed a NPE bug in direct mode.

1.16.11.16.1

  • 添加了对唯一索引的支持。Added support for Unique Index.
  • 在源选项中添加了对限制继续标记大小的支持。Added support for limiting continuation token size in feed-options.
  • 修复了 Json 序列化(时间戳)中的一个 bug。Fixed a bug in Json Serialization (timestamp).
  • 修复了 Json 序列化(枚举)中的一个 bug。Fixed a bug in Json Serialization (enum).
  • com.fasterxml.jackson.core:jackson-databind 的依赖项升级到了 2.9.5。Dependency on com.fasterxml.jackson.core:jackson-databind upgraded to 2.9.5.

1.16.01.16.0

  • 改进了直接模式的连接池。Improved Connection Pooling for Direct Mode.
  • 改进了非 orderby 跨分区查询的预提取。Improved Prefetch improvement for non-orderby cross partition query.
  • 改进了 UUID 生成。Improved UUID generation.
  • 改进了会话一致性逻辑。Improved Session consistency logic.
  • 添加了对多多边形的支持。Added support for multipolygon.
  • 添加了对集合的分区键范围统计信息的支持。Added support for Partition Key Range Statistics for Collection.
  • 修复了多区域支持方面的一个 bug。Fixed a bug in Multi-region support.

1.15.01.15.0

1.14.01.14.0

  • 对 Azure 友元库进行了内部更改。Internal changes for Azure friends libraries.

1.13.01.13.0

  • 修复了读取单个分区键范围的问题。Fixed an issue in reading single partition key ranges.
  • 修复了 ResourceID 分析中影响使用短名称的数据库的问题。Fixed an issue in ResourceID parsing that affects database with short names.
  • 修复了分区键编码导致的问题。Fixed an issue cause by partition key encoding.

1.12.01.12.0

  • 关键 bug 修复,用于在分区拆分期间请求处理。Critical bug fixes to request processing during partition splits.
  • 解决了 Strong 和 BoundedStaleness 一致性级别存在的问题。Fixed an issue with the Strong and BoundedStaleness consistency levels.

1.11.01.11.0

  • 添加了对称为“ConsistentPrefix”的新一致性级别的支持。Added support for a new consistency level called ConsistentPrefix.
  • 修复了以会话模式读取集合时的 bug。Fixed a bug in reading collection in session mode.

1.10.01.10.0

  • 启用了对吞吐量低至 2,500 RU/秒并且缩放增量为 100 RU/秒的分区集合的支持。Enabled support for partitioned collection with as low as 2,500 RU/sec and scale in increments of 100 RU/sec.
  • 修复了本机程序集中的 bug,该 bug 在某些查询中可能会导致 NullRef 异常。Fixed a bug in the native assembly which can cause NullRef exception in some queries.

1.9.61.9.6

  • 修复了查询引擎配置中可能会导致网关模式下查询异常的 Bug。Fixed a bug in the query engine configuration that may cause exceptions for queries in Gateway mode.
  • 修复了会话容器中的一些 Bug,这些 Bug 可能会在创建集合后立即导致“找不到所有者资源”请求异常。Fixed a few bugs in the session container that may cause an "Owner resource not found" exception for requests immediately after collection creation.

1.9.51.9.5

  • 添加了对聚合查询(COUNT、MIN、MAX、SUM、AVG)的支持。Added support for aggregation queries (COUNT, MIN, MAX, SUM, and AVG). 请参阅聚合支持See Aggregation support.
  • 添加了对更改源的支持。Added support for change feed.
  • 通过 RequestOptions.setPopulateQuotaInfo 添加了对集合配额信息的支持。Added support for collection quota information through RequestOptions.setPopulateQuotaInfo.
  • 通过 RequestOptions.setScriptLoggingEnabled 添加了对存储过程脚本日志记录的支持。Added support for stored procedure script logging through RequestOptions.setScriptLoggingEnabled.
  • 修复了以下 bug:DirectHttps 模式中的查询在遇到限制失败时可能会停止响应。Fixed a bug where query in DirectHttps mode may stop responding when encountering throttle failures.
  • 修复了会话一致性模式中的一个 Bug。Fixed a bug in session consistency mode.
  • 修复了一个 Bug,该 Bug 可能在请求率很高时导致 HttpContext 中出现 NullReferenceException。Fixed a bug which may cause NullReferenceException in HttpContext when request rate is high.
  • 改进了 DirectHttps 模式的性能。Improved performance of DirectHttps mode.

1.9.41.9.4

  • 使用 ConnectionPolicy.setProxy() API 添加了基于简单客户端实例的代理支持。Added simple client instance-based proxy support with ConnectionPolicy.setProxy() API.
  • 添加了 DocumentClient.close() API 以正确关闭 DocumentClient 实例。Added DocumentClient.close() API to properly shutdown DocumentClient instance.
  • 通过从本机程序集(而非网关)派生查询计划,提高直接连接模式下的查询性能。Improved query performance in direct connectivity mode by deriving the query plan from the native assembly instead of the Gateway.
  • 设置 FAIL_ON_UNKNOWN_PROPERTIES = false,使用户无需在其 POJO 中定义 JsonIgnoreProperties。Set FAIL_ON_UNKNOWN_PROPERTIES = false so users don't need to define JsonIgnoreProperties in their POJO.
  • 重构了日志记录以使用 SLF4J。Refactored logging to use SLF4J.
  • 修复了一致性读取器中的其他几个 Bug。Fixed a few other bugs in consistency reader.

1.9.31.9.3

  • 修复了连接管理中的 bug,防止直接连接模式下的连接泄漏。Fixed a bug in the connection management to prevent connection leaks in direct connectivity mode.
  • 修复了 TOP 查询中可能会引发 NullReference 异常的 bug。Fixed a bug in the TOP query where it may throw NullReference exception.
  • 通过减少调用内部缓存的网络数提高了性能。Improved performance by reducing the number of network call for the internal caches.
  • 在 DocumentClientException 中添加了状态代码、ActivityID 和请求 URI,以更好地进行故障排除。Added status code, ActivityID and Request URI in DocumentClientException for better troubleshooting.

1.9.21.9.2

  • 修复了连接管理中的问题,实现了更好的稳定性。Fixed an issue in the connection management for stability.

1.9.11.9.1

  • 添加了对 BoundedStaleness 一致性级别的支持。Added support for BoundedStaleness consistency level.
  • 添加了对分区集合的 CRUD 操作的直接连接支持。Added support for direct connectivity for CRUD operations for partitioned collections.
  • 修复了使用 SQL 查询数据库的一个 bug。Fixed a bug in querying a database with SQL.
  • 修复了会话缓存中会话令牌设置可能不正确的 bug。Fixed a bug in the session cache where session token may be set incorrectly.

1.9.01.9.0

  • 添加了对跨分区并行查询的支持。Added support for cross partition parallel queries.
  • 添加了对分区集合的 TOP/ORDER BY 查询支持。Added support for TOP/ORDER BY queries for partitioned collections.
  • 添加了非常一致性支持。Added support for strong consistency.
  • 添加了使用直接连接时对基于名称的请求的支持。Added support for name based requests when using direct connectivity.
  • 修复了 bug,使 ActivityId 在所有请求重试中保持一致。Fixed to make ActivityId stay consistent across all request retries.
  • 修复了在重新创建同名集合时与会话缓存相关的 bug。Fixed a bug related to the session cache when recreating a collection with the same name.
  • 为地域隔离的空间查询指定集合索引策略时增加了多边形和 LineString 数据类型。Added Polygon and LineString DataTypes while specifying collection indexing policy for geo-fencing spatial queries.
  • 解决 Java 文档中的 Java 1.8 的问题。Fixed issues with Java Doc for Java 1.8.

1.8.11.8.1

  • 修复了 PartitionKeyDefinitionMap 中的一个 bug,以便缓存单个分区集合,而不进行额外的提取分区键的请求。Fixed a bug in PartitionKeyDefinitionMap to cache single partition collections and not make extra fetch partition key requests.
  • 修复了一个 bug,以便在提供不正确的分区键值时不重试。Fixed a bug to not retry when an incorrect partition key value is provided.

1.8.01.8.0

  • 添加了对多区域数据库帐户的支持。Added the support for multi-region database accounts.
  • 添加了对自动重试限制请求的支持,并提供了选项用于自定义最大重试次数和最大重试等待时间。Added support for automatic retry on throttled requests with options to customize the max retry attempts and max retry wait time. 请参阅 RetryOptions 和 ConnectionPolicy.getRetryOptions()。See RetryOptions and ConnectionPolicy.getRetryOptions().
  • 弃用了基于 IPartitionResolver 的自定义分区代码。Deprecated IPartitionResolver based custom partitioning code. 请使用分区集合来提高存储和吞吐量。Please use partitioned collections for higher storage and throughput.

1.7.11.7.1

  • 添加了对速率限制的重试策略支持。Added retry policy support for rate limiting.

1.7.01.7.0

  • 对文档添加了生存时间 (TTL) 支持。Added time to live (TTL) support for documents.

1.6.01.6.0

1.5.11.5.1

  • 修复了 HashPartitionResolver 中的 Bug 以生成 little-endian 格式的哈希值,以便与其他 SDK 保持一致。Fixed a bug in HashPartitionResolver to generate hash values in little-endian to be consistent with other SDKs.

1.5.01.5.0

  • 添加哈希和范围分区冲突解决程序以协助跨多个分区对应用程序进行分片。Add Hash & Range partition resolvers to assist with sharding applications across multiple partitions.

1.4.01.4.0

  • 实现 Upsert。Implement Upsert. 添加了新的 upsertXXX 方法以支持 Upsert 功能。New upsertXXX methods added to support Upsert feature.
  • 实现基于 ID 的路由。Implement ID Based Routing. 无公共 API 更改,全部均为内部更改。No public API changes, all changes internal.

1.3.01.3.0

  • 跳过了发布以使版本号与其他 SDK 符合Release skipped to bring version number in alignment with other SDKs

1.2.01.2.0

  • 支持地理空间索引Supports GeoSpatial Index
  • 验证所有资源的 ID 属性。Validates ID property for all resources. 资源的 ID 不能包含 ?、/、#、, 字符或以空格结尾。Ids for resources cannot contain ?, /, #, , characters or end with a space.
  • 将新标头“索引转换进度”添加到 ResourceResponse。Adds new header "index transformation progress" to ResourceResponse.

1.1.01.1.0

  • 实现 V2 索引策略Implements V2 indexing policy

1.0.01.0.0

  • GA SDKGA SDK

发布日期和停用日期Release and retirement dates

Azure 会在停用 SDK 时至少提前 12 个月发出通知,以便用户顺利转换为更高版本/受支持版本。Azure will provide notification at least 12 months in advance of retiring an SDK in order to smooth the transition to a newer/supported version. 新特性和功能以及优化仅添加到当前 SDK,因此建议始终尽早升级到最新 SDK 版本。New features and functionality and optimizations are only added to the current SDK, as such it is recommend that you always upgrade to the latest SDK version as early as possible.

警告

在 2020 年 5 月 30 日之后,Azure Cosmos DB 将不再进行 bug 修复,不再添加新功能,也不再支持 1.x 版的 Azure Cosmos DB Java SDK for SQL API。After 30 May 2020, Azure Cosmos DB will no longer make bug fixes, add new features, and provide support to versions 1.x of the Azure Cosmos DB Java SDK for SQL API. 如果你不想升级,则从 1.x 版 SDK 发送的请求将继续由 Azure Cosmos DB 服务处理。If you prefer not to upgrade, requests sent from version 1.x of the SDK will continue to be served by the Azure Cosmos DB service.

在 2016 年 2 月 29 日之后,Azure Cosmos DB 将不再进行 bug 修复,不再添加新功能,也不再支持 0.x 版的 Azure Cosmos DB Java SDK for SQL API。After 29 February 2016, Azure Cosmos DB will no longer make bug fixes, add new features, and provide support to versions 0.x of the Azure Cosmos DB Java SDK for SQL API. 如果你不想升级,则从 0.x 版 SDK 发送的请求将继续由 Azure Cosmos DB 服务处理。If you prefer not to upgrade, requests sent from version 0.x of the SDK will continue to be served by the Azure Cosmos DB service.

版本Version 发布日期Release Date 停用日期Retirement Date
2.5.12.5.1 2020 年 6 月 3 日June 03, 2020 ---
2.5.02.5.0 2020 年 5 月 12 日May 12, 2020 ---
2.4.72.4.7 2020 年 2 月 20 日Feb 20, 2020 ---
2.4.62.4.6 2020 年 1 月 24 日Jan 24, 2020 ---
2.4.52.4.5 2019 年 11 月 10 日Nov 10, 2019 ---
2.4.42.4.4 2019 年 10 月 24 日Oct 24, 2019 ---
2.4.22.4.2 2019 年 9 月 26 日Sep 26, 2019 ---
2.4.12.4.1 2019 年 7 月 18 日Jul 18, 2019 ---
2.4.02.4.0 2019 年 5 月 04 日May 04, 2019 ---
2.3.02.3.0 2019 年 4 月 24 日Apr 24, 2019 ---
2.2.32.2.3 2019 年 4 月 16 日Apr 16, 2019 ---
2.2.22.2.2 2019 年 4 月 05 日Apr 05, 2019 ---
2.2.02.2.0 2019 年 3 月 27 日Mar 27, 2019 ---
2.1.32.1.3 2019 年 3 月 13 日Mar 13, 2019 ---
2.1.22.1.2 2019 年 3 月 09 日Mar 09, 2019 ---
2.1.12.1.1 2018 年 12 月 13 日Dec 13, 2018 ---
2.1.02.1.0 2018 年 11 月 20 日Nov 20, 2018 ---
2.0.02.0.0 2018 年 9 月 21 日Sept 21, 2018 ---
1.16.41.16.4 2018 年 9 月 10 日Sept 10, 2018 2020 年 5 月 30 日May 30, 2020
1.16.31.16.3 2018 年 9 月 9 日Sept 09, 2018 2020 年 5 月 30 日May 30, 2020
1.16.21.16.2 2018 年 6 月 29日June 29, 2018 2020 年 5 月 30 日May 30, 2020
1.16.11.16.1 2018 年 5 月 16日May 16, 2018 2020 年 5 月 30 日May 30, 2020
1.16.01.16.0 2018 年 3 月 15 日March 15, 2018 2020 年 5 月 30 日May 30, 2020
1.15.01.15.0 2017 年 11 月 14 日Nov 14, 2017 2020 年 5 月 30 日May 30, 2020
1.14.01.14.0 2017 年 10 月 28日Oct 28, 2017 2020 年 5 月 30 日May 30, 2020
1.13.01.13.0 2017 年 8 月25 日August 25, 2017 2020 年 5 月 30 日May 30, 2020
1.12.01.12.0 2017 年 7 月 11 日July 11, 2017 2020 年 5 月 30 日May 30, 2020
1.11.01.11.0 2017 年 5 月 10 日May 10, 2017 2020 年 5 月 30 日May 30, 2020
1.10.01.10.0 2017 年 3 月 11 日March 11, 2017 2020 年 5 月 30 日May 30, 2020
1.9.61.9.6 2017 年 2 月 21 日February 21, 2017 2020 年 5 月 30 日May 30, 2020
1.9.51.9.5 2017 年 1 月 31 日January 31, 2017 2020 年 5 月 30 日May 30, 2020
1.9.41.9.4 2016 年 11 月 24 日November 24, 2016 2020 年 5 月 30 日May 30, 2020
1.9.31.9.3 2016 年 10 月 30 日October 30, 2016 2020 年 5 月 30 日May 30, 2020
1.9.21.9.2 2016 年 10 月 28 日October 28, 2016 2020 年 5 月 30 日May 30, 2020
1.9.11.9.1 2016 年 10 月 26 日October 26, 2016 2020 年 5 月 30 日May 30, 2020
1.9.01.9.0 2016 年 10 月 3 日October 03, 2016 2020 年 5 月 30 日May 30, 2020
1.8.11.8.1 2016 年 6 月 30 日June 30, 2016 2020 年 5 月 30 日May 30, 2020
1.8.01.8.0 2016 年 6 月 14 日June 14, 2016 2020 年 5 月 30 日May 30, 2020
1.7.11.7.1 2016 年 4 月 30 日April 30, 2016 2020 年 5 月 30 日May 30, 2020
1.7.01.7.0 2016 年 4 月 27 日April 27, 2016 2020 年 5 月 30 日May 30, 2020
1.6.01.6.0 2016 年 3 月 29 日March 29, 2016 2020 年 5 月 30 日May 30, 2020
1.5.11.5.1 2015 年 12 月 31 日December 31, 2015 2020 年 5 月 30 日May 30, 2020
1.5.01.5.0 2015 年 12 月 4 日December 04, 2015 2020 年 5 月 30 日May 30, 2020
1.4.01.4.0 2015 年 10 月 5 日October 05, 2015 2020 年 5 月 30 日May 30, 2020
1.3.01.3.0 2015 年 10 月 5 日October 05, 2015 2020 年 5 月 30 日May 30, 2020
1.2.01.2.0 2015 年 8 月 5 日August 05, 2015 2020 年 5 月 30 日May 30, 2020
1.1.01.1.0 2015 年 7 月 9 日July 09, 2015 2020 年 5 月 30 日May 30, 2020
1.0.11.0.1 2015 年 5 月 12 日May 12, 2015 2020 年 5 月 30 日May 30, 2020
1.0.01.0.0 2015 年 4 月 7 日April 07, 2015 2020 年 5 月 30 日May 30, 2020
0.9.5-prelease0.9.5-prelease 2015 年 3 月 9 日Mar 09, 2015 2016 年 2 月 29 日February 29, 2016
0.9.4-prelease0.9.4-prelease 2015 年 2 月 17 日February 17, 2015 2016 年 2 月 29 日February 29, 2016
0.9.3-prelease0.9.3-prelease 2015 年 1 月 13 日January 13, 2015 2016 年 2 月 29 日February 29, 2016
0.9.2-prelease0.9.2-prelease 2014 年 12 月 19 日December 19, 2014 2016 年 2 月 29 日February 29, 2016
0.9.1-prelease0.9.1-prelease 2014 年 12 月 19 日December 19, 2014 2016 年 2 月 29 日February 29, 2016
0.9.0-prelease0.9.0-prelease 2014 年 12 月 10 日December 10, 2014 2016 年 2 月 29 日February 29, 2016

常见问题解答FAQ

1.如何向客户通知即将停用的 SDK?1. How will customers be notified of the retiring SDK?

Azure 会在即将停用的 SDK 的支持结束之前提前 12 个月进行通知,以便协助平稳地转换到支持的 SDK。Azure will provide 12 month advance notification to the end of support of the retiring SDK in order to facilitate a smooth transition to a supported SDK. 此外,会通过各种通信渠道(Azure 管理门户、开发人员中心、博客文章以及与分配的服务管理员的直接通信)来通知客户。Further, customers will be notified through various communication channels - Azure Management Portal, Developer Center, blog post, and direct communication to assigned service administrators.

2.在这 12 个月期间,客户是否可以使用“即将”停用的 Azure Cosmos DB SDK 来创作应用程序?2. Can customers author applications using a "to-be" retired Azure Cosmos DB SDK during the 12 month period?

可以,客户在 12 个月宽限期内具有完全访问权限,可以使用“即将”停用的 Azure Cosmos DB SDK 创作、部署和修改应用程序。Yes, customers will have full access to author, deploy and modify applications using the "to-be" retired Azure Cosmos DB SDK during the 12 month grace period. 在 12 个月宽限期内,建议客户根据相应情况迁移到支持的较新版本 Azure Cosmos DB SDK。During the 12 month grace period, customers are advised to migrate to a newer supported version of Azure Cosmos DB SDK as appropriate.

3.在 12 个月通知期之后,客户是否可以使用已停用的 Azure Cosmos DB SDK 创建和修改应用程序?3. Can customers author and modify applications using a retired Azure Cosmos DB SDK after the 12 month notification period?

在 12 个月通知期之后,SDK 会停用。After the 12 month notification period, the SDK will be retired. Azure Cosmos DB 平台不允许使用已停用 SDK 的应用程序对 Azure Cosmos DB 进行任何访问。Any access to Azure Cosmos DB by an applications using a retired SDK will not be permitted by the Azure Cosmos DB platform. 此外,Azure 不会对已停用的 SDK 提供客户支持。Further, Azure will not provide customer support on the retired SDK.

4.如果客户运行使用不支持的 Azure Cosmos DB SDK 版本的应用程序,会发生什么情况?4. What happens to Customer's running applications that are using unsupported Azure Cosmos DB SDK version?

任何使用已停用 SDK 版本连接 Azure Cosmos DB 服务的尝试都会被拒绝。Any attempts made to connect to the Azure Cosmos DB service with a retired SDK version will be rejected.

5.新特性和功能是否会适用于所有未停用的 SDK?5. Will new features and functionality be applied to all non-retired SDKs?

新特性和功能只添加到新版本。New features and functionality will only be added to new versions. 如果使用的是未停用的旧版本 SDK,则对 Azure Cosmos DB 进行的请求仍会与以前一样正常工作,但是你无法访问任何新功能。If you are using an old, non-retired, version of the SDK your requests to Azure Cosmos DB will still function as previous but you will not have access to any new capabilities.

6.如果无法在截止日期之前更新应用程序,该怎么办?6. What should I do if I cannot update my application before a cut-off date?

我们建议尽早升级到最新 SDK。We recommend that you upgrade to the latest SDK as early as possible. SDK 标记为要停用之后,会有 12 个月来更新应用程序。Once an SDK has been tagged for retirement you will have 12 months to update your application. 如果由于任何原因而无法在此时间范围内完成应用程序更新,请在截止日期之前与 Cosmos DB 团队联系并请求其帮助。If, for whatever reason, you cannot complete your application update within this timeframe then please contact the Cosmos DB Team and request their assistance before the cutoff date.

另请参阅See also

若要了解有关 Cosmos DB 的详细信息,请参阅 Azure Cosmos DB 服务页。To learn more about Cosmos DB, see Azure Cosmos DB service page.