Passer la navigation

Kit de développement logiciel (SDK) JavaScript Azure Cosmos DB 2.0 désormais généralement disponible

Publié le 24 septembre, 2018

Program Manager, Azure Cosmos DB

La version 2.0 du Kit de développement logiciel (SDK) JavaScript Azure Cosmos DB est désormais généralement disponible. Merci à tous ceux qui ont essayé la préversion et nous ont fait part de leurs commentaires.

Dans cette version, nous avons ajouté la prise en charge des écritures multirégions, un nouveau modèle objet de style « fluent » qui permet de se référer facilement aux ressources Azure Cosmos DB sans URL explicite, ainsi que la prise en charge de promesses et d’autres fonctionnalités JavaScript modernes. Elle est également écrite en TypeScript et prend en charge la dernière version, TypeScript 3.0.

npmInstall

Qu’est-ce qu’Azure Cosmos DB ?

Azure Cosmos DB est un service de base de données multimodèle globalement distribué. Il offre une distribution mondiale clé en main, garantit des latences à un chiffre en millisecondes au 99e centile, une mise à l’échelle élastique du débit et du stockage, ainsi que des contrats de niveau de service complets.

Nouveau modèle objet

Sur la base de vos commentaires, nous avons repensé le modèle objet afin de faciliter les interactions avec Cosmos DB ainsi que l’exécution d’opérations sur celui-ci.

Nous avons créé une classe CosmosClient de niveau supérieur pour remplacer DocumentDBClient, et avons divisé ses méthodes en classes Database, Container et Items modulaires. Cette nouvelle surface d’API active un modèle « builder » ou « fluent ». Par exemple, pour créer un élément, nous commençons par faire référence à sa base de données et à son conteneur, puis appelons items.create(). Cela évite le nécessité de générer une URL explicite pour référencer une ressource.

Grâce à ces modifications, vous pouvez créer une nouvelle base de données, un nouveau conteneur, et ajouter un élément en 10 lignes de code !

helloCosmos

De plus, Azure Cosmos DB prenant en charge plusieurs modèles d’API, nous avons introduit les concept de Conteneur et d’Élément dans le Kit de développement logiciel (SDK) afin de remplacer les concepts antérieurs de collection et de Document précédents. Ce qu’on appelait auparavant une « Collection » s’appelle désormais un « Conteneur ».

Prise en charge des promesses et des fonctionnalités JavaScript modernes

Nous avons ajouté la prise en charge complète des promesses afin que vous n’ayez plus à écrire du code personnalisé pour inclure le SDK dans un wrapper. Vous pouvez maintenant utiliser async/waiting en attendant les appels à Azure Cosmos DB directement à partir d’une fonction async.

Nous avons également ajouté une méthode de commodité, createIfNotExists (), pour les bases de données et les conteneurs, qui inclut dans un wrapper la logique pour lire la base de données, vérifier le code d’état, et créer celui-ci s’il n’existe pas.

Enfin, nous avons ajouté la prise en charge des itérateurs asynchrones, une fonctionnalité JavaScript moderne.

createAndAsyncIterator

Prise en charge des écritures multirégion

Avec les écritures multirégion Azure Cosmos DB, les développeurs peuvent créer des applications globalement distribuées, capables de lire et d’écrire des données dans n’importe quelle région Azure du monde. Pour utiliser le nouveau Kit de développement logiciel (SDK) avec des écritures multirégion, commencez avec des échantillons.

Modèle open source

Le Kit de développement logiciel (SDK) JavaScript Azure Cosmos DB est open source, et notre équipe prévoit de faire tout le développement en open source. À cette fin, nous journaliserons les problèmes, suivrons les commentaires et accepterons les PR dans GitHub.

Prise en main

Pour commencer avec le nouveau Kit de développement logiciel (SDK), accédez au dépôt GitHub et suivez le guide de démarrage rapide. Nous apprécierions beaucoup que vous nous fassiez part de vos commentaires ! Adressez un e-mail à askcosmosdb@microsoft.com ou consignez les problèmes rencontrés dans notre dépôt GitHub.

npmInstall

Tenez-vous informé des dernières actualités et fonctionnalités Azure #CosmosDB en nous suivant sur Twitter @AzureCosmosDB. Nous sommes vraiment impatients de voir ce que vous allez créer avec Azure Cosmos DB.