Spring Data Azure Cosmos DB v3 for API for NoSQL (heredado): notas de la versión y recursos
SE APLICA A: 
NoSQL
- .NET SDK v3
- SDK de .NET v2
- SDK de .NET Core v2
- SDK de fuente de cambios de .NET, versión 2
- Node.js
- SDK de Java v4
- SDK de Java v2 sincrónico
- Versión 2 del SDK de Java asincrónico
- Spring Data v2
- Spring Data v3
- Spring Data v5
- Python
- Go
- REST
- Proveedor de recursos de REST
- SQL
- Bulk Executor: .NET v2
- Bulk Executor: Java
La versión 3 de Spring Data Azure Cosmos DB para NoSQL permite a los desarrolladores utilizar Azure Cosmos DB en aplicaciones de Spring. Spring Data Azure Cosmos DB expone la interfaz de Spring Data para manipular las bases de datos y las colecciones, trabajar con documentos y emitir consultas. Las API sincrónicas y las API asincrónicas (reactivas) se admiten en el mismo artefacto Maven.
Advertencia
Esta versión del SDK de Spring Data Azure Cosmos DB depende de una versión anterior del SDK de Java de Spring Boot y Azure Cosmos DB. Este SDK de Spring Data Azure Cosmos DB se anunciará como retirada en un futuro próximo. Esta no es la versión más reciente del SDK de Azure Spring Data Azure Cosmos DB para Azure Cosmos DB y no está actualizada. Debido a problemas de rendimiento e inestabilidad en azure Spring Data SDK V3 de Azure Cosmos DB, se recomienda encarecidamente usar Azure Spring Data Azure Cosmos DB v5 para el proyecto. Para actualizarla, siga las instrucciones de la guía Migración al SDK v4 para Java de Azure Cosmos DB para comprender la diferencia en el SDK V4 para Java subyacente.
Spring Framework es un modelo de programación y configuración que simplifica el desarrollo de aplicaciones Java. Spring simplifica las relaciones de las aplicaciones mediante la inserción dependencias. Son muchos los desarrolladores que prefieren Spring, ya que resulta más sencillo compilar y probar las aplicaciones. Spring Boot amplía este control de los recursos pensando en la implementación de microservicios y aplicaciones web. Spring Data es un modelo y una plataforma de programación para acceder a almacenes de datos como Azure Cosmos DB desde el contexto de una aplicación de Spring o Spring Boot.
Puede usar Spring Data Azure Cosmos DB en las aplicaciones hospedadas en Azure Spring Apps.
Directiva de compatibilidad de versiones
Compatibilidad con versiones de Spring Boot
Este proyecto admite varias versiones de Spring Boot. Visite directiva de compatibilidad con Spring Boot para obtener más información. Los usuarios de Maven pueden heredar del proyecto spring-boot-starter-parent para obtener una sección de administración de dependencias que permita a Spring administrar las versiones para las dependencias. Visite compatibilidad con versiones de Spring Boot para obtener más información.
Compatibilidad con versiones de Spring Data
Este proyecto admite diferentes versiones de spring-data-commons. Visite compatibilidad con versiones de Spring Data para obtener más información.
¿Qué versión de Azure Spring Data Azure Cosmos DB debería usar?
La biblioteca de Azure Spring Data Azure Cosmos DB admite varias versiones de Spring Boot o Spring Cloud. Consulte asignación de versiones de Azure Spring Data Azure Cosmos DB para obtener información detallada sobre la versión de Azure Spring Data Azure Cosmos DB que se va a usar con la versión de Spring Boot o Spring Cloud.
Importante
Estas notas de la versión corresponden a la versión 3 de Spring Data Azure Cosmos DB.
El SDK de Azure Spring Data Azure Cosmos DB depende del marco de Spring Data y solo admite la API para NoSQL.
Consulte estos artículos para obtener información sobre Spring Data en otras API de Azure Cosmos DB:
Empiece rápidamente
Empiece a trabajar rápidamente con Spring Data Azure Cosmos DB gracias a la Guía de Spring Boot Starter. El enfoque de Spring Boot Starter es el método recomendado para empezar a usar el conector Spring Data Azure Cosmos DB.
También puede agregar la dependencia Spring Data Azure Cosmos DB al archivo pom.xml, como se muestra a continuación:
<dependency>
<groupId>com.azure</groupId>
<artifactId>azure-spring-data-cosmos</artifactId>
<version>latest-version</version>
</dependency>
Contenido útil
| Contenido | Vínculo |
|---|---|
| Notas de la versión | Notas de la versión 3 del SDK de Spring Data Azure Cosmos DB |
| Documentación del SDK | Documentación de la versión 3 del SDK de Azure Spring Data Azure Cosmos DB |
| Descarga del SDK | Maven |
| Documentación de la API | Documentación de referencia de API |
| Contribuya al SDK | Repositorio central del SDK de Azure para Java en GitHub |
| Introducción | Inicio rápido: creación de una aplicación de la versión 3 de Spring Data Azure Cosmos DB para administrar los datos de Azure Cosmos DB for NoSQL Repositorio de GitHub con código de inicio rápido |
| Ejemplos de código básicos | Azure Cosmos DB: ejemplos de Spring Data Azure Cosmos DB para la API para NoSQL Repositorio de GitHub con código de ejemplo |
| Consejos de rendimiento | Sugerencias de rendimiento para el SDK de Java v4 (aplicable a Spring Data) |
| Solución de problemas | Solución de problemas del SDK de Java v4 (aplicable a Spring Data) |
| Talleres y laboratorios de Azure Cosmos DB | Página principal de talleres de Azure Cosmos DB |
Historial de versiones
El historial de versiones se mantiene en el repositorio azure-sdk-for-java. Para obtener una lista detallada de las versiones, consulte el archivo changelog.
Versión recomendada
Se recomienda encarecidamente actualizar a Azure Spring Data Azure Cosmos DB v5 y usar la versión mínima recomendada y posteriores.
Notas adicionales
- Spring Data Azure Cosmos DB admite Java JDK 8, Java JDK 11. La versión 3.8.0 y posteriores también admiten Java JDK 17.
Preguntas más frecuentes
¿Cómo se me notificará de la retirada del SDK?
Microsoft le notificará 12 meses antes de la finalización del soporte técnico del SDK que se retira para facilitar una transición sin problemas a un SDK compatible. Se le notificará a través de diversos canales de comunicación: Azure Portal, actualizaciones de Azure y comunicación directa a los administradores de servicios asignados.
¿Puedo crear aplicaciones con un SDK de Azure Cosmos DB que se retirará durante el período de 12 meses?
Sí, podrá crear, implementar y modificar aplicaciones mediante el SDK de Azure Cosmos DB que se retirará durante el período de aviso de 12 meses. Se recomienda que migre a una versión compatible más reciente del SDK de Azure Cosmos DB durante el período de aviso de 12 meses, según corresponda.
Tras la fecha de retirada, ¿qué ocurre con las aplicaciones que usan el SDK de Azure Cosmos DB no compatible?
Después de la fecha de retirada, Azure Cosmos DB ya no hará correcciones de errores, ni agregará nuevas características, ni proporcionará soporte técnico para las versiones del SDK retiradas. Si prefiere no realizar la actualización, el servicio Azure Cosmos DB seguirá atendiendo las solicitudes enviadas desde las versiones retiradas del SDK.
¿Qué versiones del SDK tendrán las características y actualizaciones más recientes?
Se agregarán nuevas características y actualizaciones solo a la versión secundaria más reciente de la versión del SDK principal compatible más reciente. Se recomienda que use siempre la versión más reciente para aprovechar las ventajas de las nuevas características, mejoras de rendimiento y correcciones de errores. Si usa una versión anterior del SDK que no se haya retirado, las solicitudes realizadas a Azure Cosmos DB seguirán funcionando, pero no tendrá acceso a las nuevas funcionalidades.
¿Qué debo hacer si no puedo actualizar la aplicación antes de una fecha límite?
Se recomienda que actualice al SDK más reciente tan pronto como sea posible. Después de etiquetar un SDK para su retirada, tendrá 12 meses para actualizar la aplicación. Si no puede realizar la actualización en la fecha de retirada, Azure Cosmos DB seguirá atendiendo las solicitudes enviadas desde las versiones retiradas del SDK, por lo que las aplicaciones en ejecución seguirán funcionando. Aunque Azure Cosmos DB ya no hará correcciones de errores, ni agregará nuevas características ni proporcionará soporte técnico para las versiones del SDK retiradas.
Si tiene un plan de soporte técnico y requiere soporte técnico, póngase en contacto con nosotros al abrir una incidencia de soporte técnico.
¿Cómo puedo solicitar que se agreguen características a un SDK o conector?
No siempre se agregan de inmediato características nuevas a los SDK o conectores. Si no se admite una característica que le gustaría agregar, agregue comentarios a nuestro foro de la comunidad.
Pasos siguientes
Más información acerca de Azure Cosmos DB.
Más información sobre Spring Framework.
Más información sobre Spring Boot.
Más información sobre Spring Data.