Skip to content

Commit d4b3f92

Browse files
authored
Merge pull request #265326 from seesharprun/cosmos-archive-java-spark-v2
Cosmos DB | Retire `articles/cosmos-db/sdk-java-spark-v2.md`
2 parents c58eb1c + cc9261a commit d4b3f92

10 files changed

+13
-71
lines changed

articles/cosmos-db/includes/cosmos-db-sdk-list.md

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,6 @@ ms.date: 09/28/2022
1515
> * [Node.js](../nosql/sdk-nodejs.md)
1616
> * [Java SDK v4](../nosql/sdk-java-v4.md)
1717
> * [Async Java SDK v2](../nosql/sdk-java-async-v2.md)
18-
> * [Sync Java SDK v2](../nosql/sdk-java-v2.md)
1918
> * [Spring Data v2](../nosql/sdk-java-spring-data-v2.md)
2019
> * [Spring Data v3](../nosql/sdk-java-spring-data-v3.md)
2120
> * [Spring Data v5](../nosql/sdk-java-spring-data-v5.md)

articles/cosmos-db/nosql/TOC.yml

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -938,8 +938,6 @@
938938
href: sdk-java-v4.md
939939
- name: Async Java SDK v2 (legacy)
940940
href: sdk-java-async-v2.md
941-
- name: Sync Java SDK v2 (legacy)
942-
href: sdk-java-v2.md
943941
- name: Spring Data Connector v2 (legacy)
944942
href: sdk-java-spring-data-v2.md
945943
- name: Spring Data Connector v3

articles/cosmos-db/nosql/how-to-manage-conflicts.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -89,7 +89,7 @@ DocumentCollection createdCollection = client.createCollection(databaseUri, coll
8989

9090
# [Sync Java V2 SDK](#tab/sync)
9191

92-
[Sync Java V2 SDK](sdk-java-v2.md) (Maven [com.microsoft.azure::azure-documentdb](https://mvnrepository.com/artifact/com.microsoft.azure/azure-documentdb))
92+
(Maven [com.microsoft.azure::azure-documentdb](https://mvnrepository.com/artifact/com.microsoft.azure/azure-documentdb))
9393

9494
```java
9595
DocumentCollection lwwCollection = new DocumentCollection();
@@ -274,7 +274,7 @@ DocumentCollection createdCollection = client.createCollection(databaseUri, coll
274274

275275
# [Sync Java V2 SDK](#tab/sync)
276276

277-
[Sync Java V2 SDK](sdk-java-v2.md) (Maven [com.microsoft.azure::azure-documentdb](https://mvnrepository.com/artifact/com.microsoft.azure/azure-documentdb))
277+
(Maven [com.microsoft.azure::azure-documentdb](https://mvnrepository.com/artifact/com.microsoft.azure/azure-documentdb))
278278

279279
```java
280280
DocumentCollection udpCollection = new DocumentCollection();
@@ -384,7 +384,7 @@ DocumentCollection createdCollection = client.createCollection(databaseUri, coll
384384

385385
# [Sync Java V2 SDK](#tab/sync)
386386

387-
[Sync Java V2 SDK](sdk-java-v2.md) (Maven [com.microsoft.azure::azure-documentdb](https://mvnrepository.com/artifact/com.microsoft.azure/azure-documentdb))
387+
(Maven [com.microsoft.azure::azure-documentdb](https://mvnrepository.com/artifact/com.microsoft.azure/azure-documentdb))
388388

389389
```java
390390
DocumentCollection manualCollection = new DocumentCollection();
@@ -478,7 +478,7 @@ for (Conflict conflict : response.getResults()) {
478478
```
479479
# [Sync Java V2 SDK](#tab/v2sync)
480480

481-
[Sync Java V2 SDK](sdk-java-v2.md) (Maven [com.microsoft.azure::azure-documentdb](https://mvnrepository.com/artifact/com.microsoft.azure/azure-documentdb))
481+
(Maven [com.microsoft.azure::azure-documentdb](https://mvnrepository.com/artifact/com.microsoft.azure/azure-documentdb))
482482

483483
```java
484484
Iterator<Conflict> conflictsIterator = client.readConflicts(this.collectionLink, null).getQueryIterator();

articles/cosmos-db/nosql/how-to-use-stored-procedures-triggers-udfs.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ ms.custom: devx-track-csharp
2020

2121
The API for NoSQL in Azure Cosmos DB supports registering and invoking stored procedures, triggers, and user-defined functions (UDFs) written in JavaScript. After you define one or more stored procedures, triggers, or user-defined functions, you can load and view them in the [Azure portal](https://portal.azure.com/) by using Data Explorer.
2222

23-
You can use the API for NoSQL SDK across multiple platforms including [.NET v2 (legacy)](sdk-dotnet-v2.md), [.NET v3](sdk-dotnet-v3.md), [Java](sdk-java-v2.md), [JavaScript](sdk-nodejs.md), or [Python](sdk-python.md) SDKs to do these tasks. If you haven't worked with one of these SDKs before, see the quickstart article for the appropriate SDK:
23+
You can use the API for NoSQL SDK across multiple platforms including [.NET v2 (legacy)](sdk-dotnet-v2.md), [.NET v3](sdk-dotnet-v3.md), [Java](/java/api/overview/azure/cosmos-readme), [JavaScript](sdk-nodejs.md), or [Python](sdk-python.md) SDKs to do these tasks. If you haven't worked with one of these SDKs before, see the quickstart article for the appropriate SDK:
2424

2525
| SDK | Getting started |
2626
| :--- | :--- |

articles/cosmos-db/nosql/migrate-java-v4-sdk.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -36,7 +36,7 @@ The following table lists different Azure Cosmos DB Java SDKs, the package name
3636
| Java SDK| Release Date | Bundled APIs | Maven Jar | Java package name |API Reference | Release Notes | Retire date |
3737
|-------|------|-----------|-----------|--------------|-------------|---------------------------|--------|
3838
| Async 2.x.x | June 2018 | Async(RxJava) | `com.microsoft.azure::azure-cosmosdb` | `com.microsoft.azure.cosmosdb.rx` | [API](https://azure.github.io/azure-cosmosdb-java/2.0.0/) | [Release Notes](sdk-java-async-v2.md) | August 31, 2024 |
39-
| Sync 2.x.x | Sept 2018 | Sync | `com.microsoft.azure::azure-documentdb` | `com.microsoft.azure.cosmosdb` | [API](https://azure.github.io/azure-cosmosdb-java/2.0.0/) | [Release Notes](sdk-java-v2.md) | February 29, 2024 |
39+
| Sync 2.x.x | Sept 2018 | Sync | `com.microsoft.azure::azure-documentdb` | `com.microsoft.azure.cosmosdb` | [API](https://azure.github.io/azure-cosmosdb-java/2.0.0/) | | February 29, 2024 |
4040
| 3.x.x | July 2019 | Async(Reactor)/Sync | `com.microsoft.azure::azure-cosmos` | `com.azure.data.cosmos` | [API](https://azure.github.io/azure-cosmosdb-java/3.0.0/) | - | August 31, 2024 |
4141
| 4.0 | June 2020 | Async(Reactor)/Sync | `com.azure::azure-cosmos` | `com.azure.cosmos` | [API](/java/api/overview/azure/cosmosdb) | - | - |
4242

articles/cosmos-db/nosql/performance-tips-java.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ ms.custom: devx-track-java, devx-track-extended-java
2626
> [!IMPORTANT]
2727
> This is *not* the latest Java SDK for Azure Cosmos DB! You should upgrade your project to [Azure Cosmos DB Java SDK v4](sdk-java-v4.md) and then read the Azure Cosmos DB Java SDK v4 [performance tips guide](performance-tips-java-sdk-v4.md). Follow the instructions in the [Migrate to Azure Cosmos DB Java SDK v4](migrate-java-v4-sdk.md) guide and [Reactor vs RxJava](https://github.com/Azure-Samples/azure-cosmos-java-sql-api-samples/blob/main/reactor-rxjava-guide.md) guide to upgrade.
2828
>
29-
> These performance tips are for Azure Cosmos DB Sync Java SDK v2 only. Please view the Azure Cosmos DB Sync Java SDK v2 [Release notes](sdk-java-v2.md) and [Maven repository](https://mvnrepository.com/artifact/com.microsoft.azure/azure-documentdb) for more information.
29+
> These performance tips are for Azure Cosmos DB Sync Java SDK v2 only. Please view the [Maven repository](https://mvnrepository.com/artifact/com.microsoft.azure/azure-documentdb) for more information.
3030
>
3131
3232
> [!IMPORTANT]
@@ -38,7 +38,7 @@ ms.custom: devx-track-java, devx-track-extended-java
3838
> Azure Cosmos DB Java SDK v4.
3939
>
4040
41-
Azure Cosmos DB is a fast and flexible distributed database that scales seamlessly with guaranteed latency and throughput. You do not have to make major architecture changes or write complex code to scale your database with Azure Cosmos DB. Scaling up and down is as easy as making a single API call. To learn more, see [how to provision container throughput](how-to-provision-container-throughput.md) or [how to provision database throughput](how-to-provision-database-throughput.md). However, because Azure Cosmos DB is accessed via network calls there are client-side optimizations you can make to achieve peak performance when using [Azure Cosmos DB Sync Java SDK v2](./sdk-java-v2.md).
41+
Azure Cosmos DB is a fast and flexible distributed database that scales seamlessly with guaranteed latency and throughput. You do not have to make major architecture changes or write complex code to scale your database with Azure Cosmos DB. Scaling up and down is as easy as making a single API call. To learn more, see [how to provision container throughput](how-to-provision-container-throughput.md) or [how to provision database throughput](how-to-provision-database-throughput.md). However, because Azure Cosmos DB is accessed via network calls there are client-side optimizations you can make to achieve peak performance when using Azure Cosmos DB Sync Java SDK v2.
4242

4343
So if you're asking "How can I improve my database performance?" consider the following options:
4444

@@ -84,7 +84,7 @@ So if you're asking "How can I improve my database performance?" consider the fo
8484
## SDK Usage
8585
1. **Install the most recent SDK**
8686

87-
The Azure Cosmos DB SDKs are constantly being improved to provide the best performance. See the [Azure Cosmos DB SDK](./sdk-java-v2.md) pages to determine the most recent SDK and review improvements.
87+
The Azure Cosmos DB SDKs are constantly being improved to provide the best performance. See the [Azure Cosmos DB SDK](/java/api/overview/azure/cosmos-readme) pages to determine the most recent SDK and review improvements.
8888
2. **Use a singleton Azure Cosmos DB client for the lifetime of your application**
8989

9090
Each [DocumentClient](/java/api/com.microsoft.azure.documentdb.documentclient) instance is thread-safe and performs efficient connection management and address caching when operating in Direct Mode. To allow efficient connection management and better performance by DocumentClient, it is recommended to use a single instance of DocumentClient per AppDomain for the lifetime of the application.
@@ -110,7 +110,7 @@ So if you're asking "How can I improve my database performance?" consider the fo
110110
111111
5. **Implement backoff at getRetryAfterInMilliseconds intervals**
112112
113-
During performance testing, you should increase load until a small rate of requests get throttled. If throttled, the client application should backoff on throttle for the server-specified retry interval. Respecting the backoff ensures that you spend minimal amount of time waiting between retries. Retry policy support is included in Version 1.8.0 and above of the [Azure Cosmos DB Sync Java SDK](./sdk-java-v2.md). For more information, see [getRetryAfterInMilliseconds](/java/api/com.microsoft.azure.documentdb.documentclientexception.getretryafterinmilliseconds).
113+
During performance testing, you should increase load until a small rate of requests get throttled. If throttled, the client application should backoff on throttle for the server-specified retry interval. Respecting the backoff ensures that you spend minimal amount of time waiting between retries. Retry policy support is included in Version 1.8.0 and above of the [Azure Cosmos DB Sync Java SDK](/java/api/overview/azure/cosmos-readme). For more information, see [getRetryAfterInMilliseconds](/java/api/com.microsoft.azure.documentdb.documentclientexception.getretryafterinmilliseconds).
114114
115115
6. **Scale out your client-workload**
116116

articles/cosmos-db/nosql/performance-tips.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -181,7 +181,7 @@ Azure Cosmos DB requests are made over HTTPS/REST when you use gateway mode. The
181181
During performance testing, you should increase load until a small rate of requests are throttled. If requests are throttled, the client application should back off on throttle for the server-specified retry interval. Respecting the backoff ensures you spend a minimal amount of time waiting between retries.
182182

183183
Retry policy support is included in these SDKs:
184-
- Version 1.8.0 and later of the [.NET SDK for SQL](sdk-dotnet-v2.md) and the [Java SDK for SQL](sdk-java-v2.md)
184+
* Version 1.8.0 and later of the [.NET SDK for SQL](sdk-dotnet-v2.md) and the [Java SDK for SQL](/java/api/overview/azure/cosmos-readme)
185185
- Version 1.9.0 and later of the [Node.js SDK for SQL](sdk-nodejs.md) and the [Python SDK for SQL](sdk-python.md)
186186
- All supported versions of the [.NET Core](sdk-dotnet-core-v2.md) SDKs
187187

articles/cosmos-db/nosql/sdk-java-async-v2.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ ms.custom: devx-track-java, devx-track-extended-java
1717

1818
[!INCLUDE[SDK selector](../includes/cosmos-db-sdk-list.md)]
1919

20-
The API for NoSQL Async Java SDK differs from the API for NoSQL Java SDK by providing asynchronous operations with support of the [Netty library](https://netty.io/). The pre-existing [API for NoSQL Java SDK](sdk-java-v2.md) does not support asynchronous operations.
20+
The API for NoSQL Async Java SDK differs from the API for NoSQL Java SDK by providing asynchronous operations with support of the [Netty library](https://netty.io/). The pre-existing [API for NoSQL Java SDK](/java/api/overview/azure/cosmos-readme) does not support asynchronous operations.
2121

2222
> [!IMPORTANT]
2323
> This is *not* the latest Java SDK for Azure Cosmos DB! We **strongly recommend** using [Azure Cosmos DB Java SDK v4](sdk-java-v4.md) for your project. To upgrade, follow the instructions in the [Migrate to Azure Cosmos DB Java SDK v4](migrate-java-v4-sdk.md) guide and the [Reactor vs RxJava](https://github.com/Azure-Samples/azure-cosmos-java-sql-api-samples/blob/main/reactor-rxjava-guide.md) guide.

articles/cosmos-db/nosql/sdk-java-spark-v2.md

Lines changed: 0 additions & 55 deletions
This file was deleted.

articles/cosmos-db/nosql/sdk-java-v4.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ ms.custom: devx-track-java, devx-track-extended-java
1717

1818
[!INCLUDE[SDK selector](../includes/cosmos-db-sdk-list.md)]
1919

20-
The Azure Cosmos DB Java SDK v4 for NoSQL combines an Async API and a Sync API into one Maven artifact. The v4 SDK brings enhanced performance, new API features, and Async support based on Project Reactor and the [Netty library](https://netty.io/). Users can expect improved performance with Azure Cosmos DB Java SDK v4 versus the [Azure Cosmos DB Async Java SDK v2](sdk-java-async-v2.md) and the [Azure Cosmos DB Sync Java SDK v2](sdk-java-v2.md).
20+
The Azure Cosmos DB Java SDK v4 for NoSQL combines an Async API and a Sync API into one Maven artifact. The v4 SDK brings enhanced performance, new API features, and Async support based on Project Reactor and the [Netty library](https://netty.io/). Users can expect improved performance with Azure Cosmos DB Java SDK v4 versus the [Azure Cosmos DB Async Java SDK v2](sdk-java-async-v2.md) and the [Azure Cosmos DB Sync Java SDK v2](/java/api/overview/azure/cosmos-readme).
2121

2222
> [!IMPORTANT]
2323
> These Release Notes are for Azure Cosmos DB Java SDK v4 only. If you are currently using an older version than v4, see the [Migrate to Azure Cosmos DB Java SDK v4](migrate-java-v4-sdk.md) guide for help upgrading to v4.

0 commit comments

Comments
 (0)