SDK de Java de Azure Cosmos DB v4 para la API para NoSQL: notas de la versión y recursos

SE APLICA A: NoSQL

SDK de Java de Azure Cosmos DB v4 para NoSQL combina una API asincrónica y una API de sincronización en un solo artefacto de Maven. El SDK v4 ofrece rendimiento mejorado, nuevas características de API y compatibilidad asincrónica basada en Project Reactor y la biblioteca Netty. Los usuarios pueden esperar un rendimiento mejorado con la versión 4 del SDK de Java de Azure Cosmos DB en comparación con la versión 2 del SDK de Java asincrónico de Azure Cosmos DB y la versión 2 del SDK de Java sincrónico de Azure Cosmos DB.

Importante

Estas son las notas de la versión solo para la versión 4 del SDK de Java para Azure Cosmos DB. Si en la actualidad usa una versión anterior a la v4, vea la guía Migración a la versión 4 del SDK de Java de Azure Cosmos DB a fin de obtener ayuda para actualizar a v4.

Estos son tres pasos para empezar a trabajar rápidamente.

  1. Instale el runtime de Java mínimo admitido, JDK 8 para poder usar el SDK.
  2. Consulte la Guía de inicio rápido para la versión 4 del SDK de Java de Azure Cosmos DB, en la que se proporciona acceso al artefacto de Maven y se describen solicitudes básicas de Azure Cosmos DB.
  3. Lea las sugerencias de rendimiento y las guías de solución de problemas de la versión 4 del SDK de Java de Azure Cosmos DB para optimizar el SDK de la aplicación.

Los talleres y laboratorios de Azure Cosmos DB son otro fantástico recurso para aprender a usar la versión 4 del SDK de Java de Azure Cosmos DB.

Contenido útil

Contenido Vínculo
Notas de la versión Notas de la versión del SDK de Java v4
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 Java para administrar los datos de Azure Cosmos DB for NoSQL
Repositorio de GitHub con código de inicio rápido
Procedimientos recomendados Procedimientos recomendados para el SDK de Java v4
Ejemplos de código básicos Azure Cosmos DB: ejemplos de Java para la API para NoSQL
Repositorio de GitHub con código de ejemplo
Aplicación de consola con fuente de cambios Fuente de cambios: ejemplo de SDK de Java v4
Repositorio de GitHub con código de ejemplo
Ejemplo de aplicación web Compilación de una aplicación web con el SDK de Java v4
Repositorio de GitHub con código de ejemplo
Consejos de rendimiento Sugerencias de rendimiento para la versión 4 del SDK de Java
Solución de problemas Solución de problemas de la versión 4 del SDK de Java
Migración a v4 desde un SDK anterior Migración a la versión 4 del SDK de Java
Tiempo de ejecución mínimo admitido JDK 8
Talleres y laboratorios de Azure Cosmos DB Página principal de talleres de Azure Cosmos DB

Importante

  • La actualización 4.13.0 actualiza las versiones principales reactor-core y reactor-netty a la serie de versiones 2020.0.4 (Europium).

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.

Se recomienda encarecidamente usar la versión 4.64.0 y posteriores.

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

Para más información sobre Azure Cosmos DB, consulte la página del servicio Microsoft Azure Cosmos DB.