Java Api for Azure Cosmos Documents DB (SQL Api)

Question

我已经开始使用Azure Cosmos DB Sql Api。我发现了两个不同的Java，它们可以用来管理这个数据库：

com.azure::azure-cosmos

在以下快速启动演示之后(可在Azure门户快速启动部分获得)

​

​

我下载了演示代码，它依赖于：

<dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-cosmos</artifactId>
    <version>4.0.0-preview.1</version>
</dependency>

这里描述了这个Api：天青-宇宙。在这个Api中，我发现了几个像CosmosClientBuilder，CosmosContainer.这样有用的类

com.microsoft.azure::azure-documentdb

但是，在阅读了docs.microsoft.azure.com的文档之后，我发现他们建议使用com.microsoft.azure::azure-documentdb

<dependency>
    <groupId>com.microsoft.azure</groupId>
    <artifactId>azure-documentdb</artifactId>
    <version>LATEST</version>
</dependency>
<dependency>
    <groupId>com.microsoft.azure</groupId>
    <artifactId>azure-cosmosdb</artifactId>
    <version>2.6.5</version>
</dependency>

在这个Api中，我没有看到有用的CosmosClientBuilder类，创建到数据库的连接的方式也没有什么不同。

我想知道推荐使用哪种Api？它们是否有不同的用途？

Answer 1

com.azure:: Azure -cosmos是Azure Cosmos DB Java for SQL的新用户推荐的版本。从Maven工件(“4.0.0.预览-1”)中可以看出，最新版本是v4的预览版本--请注意3月底Azure Cosmos DB v4 for SQL的通用(非预览)版本。它将使用稍微不同的Maven工件名称。

Answer 2

所有这些包都是针对同一个API的SDK更新，即Core (SQL) API，这是推荐的最佳perf和支持。

版本号是最重要的。3.x.x是最新的稳定4.0是预览版，我们正在推动人们开始使用4.0。

下面是版本号与Maven工件的关系：

com.azure::azure-cosmos: v4.0.x Async/Sync (public preview)

com.microsoft.azure::azure-cosmos : v3.x.x Async/Sync (stable)

com.microsoft.azure::azure-cosmosdb : v2.x.x Async (stable)

com.microsoft.azure::azure-documentdb : v2.4.7 "Legacy" Sync, deprecated (stable)

如果您对同一个SDK的许多不同的Maven工件感到困惑--这是在Azure Cosmos DB SDK迁移到主线Azure SDK回购时发生的；我们已经完成了完善包名的过程。我们预计这一前景将是稳定的。