Omitir navegación

El SDK 2.0 de JavaScript de Azure Cosmos DB ahora está disponible de forma general

Publicado el 24 septiembre, 2018

Program Manager, Azure Cosmos DB

La versión 2.0 del SDK de JavaScript de Azure Cosmos DB ahora está disponible de forma general. Gracias a todos los que probaron la versión preliminar y nos enviaron sus comentarios.

En esta versión, agregamos soporte para escrituras de diversas regiones, un nuevo modelo de objeto con estilo “fluido” (para facilitar las referencias a recursos de Azure Cosmos DB sin una URL explícita) y soporte para promesas y otras características modernas de JavaScript. Además, está escrita en TypeScript y es compatible con la última versión 3.0 de TypeScript.

npmInstall

¿Qué es Azure Cosmos DB?

Azure Cosmos DB es un servicio de base de datos multimodelo de distribución global. Ofrece distribución global inmediata, garantiza latencias de menos de 10 milisegundos en el percentil 99, escalado elástico de rendimiento y almacenamiento, y contratos de nivel de servicio integrales.

Nuevo modelo de objetos

En función de sus comentarios, volvimos a diseñar el modelo de objetos para facilitar la interacción con operaciones en Cosmos DB y su realización.

Creamos una nueva clase de primer nivel de CosmosClient para reemplazar DocumentDBClient y dividir sus métodos en las clases modulares Base de datos, Contenedor y Elemento. Esta nueva superficie de API habilita un patrón de “generador” o “fluido”. Por ejemplo, para crear un elemento, primero hacemos referencia a su base de datos o contenedor, y llamamos a items.create(). De esta forma, se evita la necesidad de crear una URL explícita para hacer referencia a un recurso.

Como resultado, puede crear una nueva base de datos o contenedor, y agregar un elemento en solo 10 líneas de código.

helloCosmos

Además, debido a que Azure Cosmos DB es compatible con distintos modelos de API, hemos agregado el concepto de Contenedor y Elemento en el SDK para reemplazar los conceptos antiguos de Colección y Documento. Lo que se conocía previamente como una “Colección” ahora se llama “Contenedor”.

Soporte para promesas y características modernas de JavaScript

Agregamos soporte completo para promesas de modo que usted no tenga que escribir código personalizado para encapsular el SDK. Ahora puede usar async/await al esperar las llamadas a Azure Cosmos DB directamente desde la función async.

También agregamos un método de conveniencia createIfNotExists() para bases de datos y contenedores, que encapsula la lógica para leer la base de datos, comprobar el código de estado y crearlo si no existe.

Finalmente, agregamos soporte para iteradores asincrónicos, una característica moderna de JavaScript.

createAndAsyncIterator

Compatibilidad con escrituras de varias regiones

Con las escrituras de varias regiones de Azure Cosmos DB, los desarrolladores pueden crear aplicaciones distribuidas de forma global que pueden leer y escribir datos en cualquier región de Azure del mundo. Para usar el nuevo SDK con escrituras de varias regiones, comience con ejemplos.

Modelo de código abierto

El SDK de JavaScript de Azure Cosmos DB es código abierto, y nuestro equipo tiene planificado realizar todo el desarrollo de esta forma. Con ese objetivo, registraremos los problemas, haremos seguimiento de los comentarios y aceptaremos solicitudes de incorporación de cambios en GitHub.

Introducción

Para empezar a usar el nuevo SDK, vaya al repositorio de GitHub y siga el inicio rápido. Nos encantaría conocer su opinión. Envíe un correo electrónico a askcosmosdb@microsoft.com o registre los problemas en nuestro repositorio de GitHub.

npmInstall

Para mantenerse al día respecto a las novedades y características más recientes de Azure #CosmosDB, síganos en Twitter @AzureCosmosDB. Realmente nos interesa conocer qué compiló con Azure Cosmos DB.