Notes de publication pour l’émulateur (local) Windows Azure Cosmos DB

L’émulateur Azure Cosmos DB est mis à jour à une cadence régulière avec des notes de publication fournies dans cet article.

Versions prises en charge

Seule la version la plus récente de l’émulateur Azure Cosmos DB est activement prise en charge.

Version la plus récente 2.14.16

Date de publication : 24 janvier 2024

  • Cette version corrige un problème où l’émulateur était lié à loopback au lieu de public interface même après avoir passé l’option de ligne de commande /AllowNetworkAccess.

Versions précédentes

Avertissement

Les versions précédentes de l’émulateur ne sont pas prises en charge par le groupe de produits.

2.14.12 (20 mars 2023)

  • Cette version corrige un problème affectant les types d’API de point de terminaison Gremlin et Table. Avant ce correctif, une application cliente échoue avec un code d’état 500 lors de la tentative de connexion au point de terminaison de l’émulateur public.

2.14.11 (27 janvier 2023)

  • Cette version met à jour les services en arrière-plan de l’émulateur Azure Cosmos DB au niveau des dernières fonctionnalités en ligne d’Azure Cosmos DB.

2.14.9(7 juillet 2022)

  • Cette version met à jour les services en arrière-plan de l’émulateur Azure Cosmos DB au niveau des dernières fonctionnalités en ligne d’Azure Cosmos DB.

2.14.8

  • Cette version met à jour les services en arrière-plan de l’émulateur Azure Cosmos DB au niveau des dernières fonctionnalités en ligne d’Azure Cosmos DB.

2.14.7 (9 mai 2022)

  • Cette version met à jour les services en arrière-plan de l’émulateur Azure Cosmos DB au niveau des dernières fonctionnalités en ligne d’Azure Cosmos DB. En plus de cette mise à jour, quelques problèmes ont été résolus dans cette version :
    • Mise à jour de l’Explorateur de données vers le contenu le plus récent et correction d’un lien rompu pour l’exemple de documentation de démarrage rapide.
    • Ajout d’une option pour configurer l’API pour MongoDB et configurer la version pour l’émulateur de base de données Linux Azure Cosmos DB en définissant la variable d’environnement : AZURE_COSMOS_EMULATOR_ENABLE_MONGODB_ENDPOINT dans le paramètre de conteneur Docker. Les valeurs admises sont : 3.2, 3.6, 4.0 et 4.2

2.14.6 (7 mars 2022)

  • Cette version met à jour les services en arrière-plan de l’émulateur Azure Cosmos DB au niveau des dernières fonctionnalités en ligne d’Azure Cosmos DB. En plus de cette mise à jour, quelques problèmes ont été résolus dans cette version :
    • Résolution d’un problème lié à une utilisation du processeur élevée quand l’émulateur est en cours d’exécution.
    • Ajoutez l’option PowerShell pour définir l’API pour Mongo DB et la version : -MongoApiVersion. Les valeurs admises sont : 3.2, 3.6 et 4.0

2.14.5 (18 janvier 2022)

  • Cette version met à jour les services en arrière-plan de l’émulateur Azure Cosmos DB au niveau des dernières fonctionnalités en ligne d’Azure Cosmos DB. Elle présente une autre mise à jour importante : la réduction du nombre de services exécutés en arrière-plan, qui sont démarrés selon les besoins.

2.14.4 (25 octobre 2021)

  • Cette version met à jour les services en arrière-plan de l’émulateur Azure Cosmos DB au niveau des dernières fonctionnalités en ligne d’Azure Cosmos DB.

2.14.3 (8 septembre 2021)

  • Cette version met à jour les services en arrière-plan de l’émulateur Azure Cosmos DB au niveau des dernières fonctionnalités en ligne d’Azure Cosmos DB. Elle résout également les problèmes liés aux données de performances collectées et réinitialise l’image de base pour l’image Docker de l’émulateur Linux Azure Cosmos DB.

2.14.2 (12 août 2021)

  • Cette version met à jour le contenu de l’Explorateur de données local au niveau de la dernière version de Microsoft Azure et réinitialise la base de l’image Docker de l’émulateur Linux Azure Cosmos DB.

2.14.1 (18 juin 2021)

  • Cette version améliore le temps de démarrage de l’émulateur tout en réduisant l’empreinte de ses données sur le disque. Activez cette nouvelle optimisation à l’aide de l’argument /EnablePreview.

2.14.0 (15 juin 2021)

  • Cette version met à jour le contenu de l’Explorateur de données local au niveau de la dernière version de Microsoft Azure. Elle corrige également un problème qui survenait en cas d’importation de plusieurs éléments de document à l’aide de la fonctionnalité de chargement de fichiers JSON.

2.11.13 (21 avril 2021)

  • Cette version met à jour le contenu de l’Explorateur de données local au niveau de la dernière version de Microsoft Azure et ajoute une nouvelle configuration de point de terminaison MongoDB, 4.0.

2.11.11 (22 février 2021)

  • Cette version met à jour le contenu de l’Explorateur de données local au niveau de la dernière version de Microsoft Azure.

2.11.10 (5 janvier 2021)

  • Cette version met à jour le contenu de l’Explorateur de données local au niveau de la dernière version de Microsoft Azure. Elle ajoute également une nouvelle option publique, /ExportPemCert, qui permet à l’utilisateur de l’émulateur d’exporter directement le certificat de l’émulateur public sous forme de fichier .PEM.

2.11.9 (3 décembre 2020)

  • Cette version met à jour les services en arrière-plan de l’émulateur Azure Cosmos DB au niveau des dernières fonctionnalités en ligne d’Azure Cosmos DB. Elle résout également quelques problèmes liés à la fonctionnalité d’émulateur Azure Cosmos DB :
    • Résolution d’un problème lié au fait que les demandes de charge utile de document volumineux échouent lors de l’utilisation du mode direct et des applications clientes Java.
    • Résolution d’un problème de connectivité avec le point de terminaison MongoDB version 3.6 quand il est ciblé par des applications .NET.

2.11.8 (6 novembre 2020)

  • Cette version comprend une mise à jour de l’Explorateur de données de l’émulateur Azure Cosmos DB et corrige un problème qui survenait lorsque les clients Transport layer security (TLS) 1.3 essayaient d’ouvrir l’Explorateur de données.

2.11.6 (6 octobre 2020)

  • Cette version résout un problème lié à l’accès concurrentiel lors de la création de plusieurs conteneurs en même temps. Ce problème peut laisser l’émulateur dans un état endommagé. Les demandes d’API adressées ultérieurement au point de terminaison de l’émulateur échouent avec des erreurs de type service non disponible. La solution de contournement consiste à arrêter l’émulateur, à réinitialiser ses données locales et à le redémarrer.

2.11.5 (23 août 2020)

  • Cette version ajoute deux nouvelles options de démarrage de l’émulateur Azure Cosmos DB :
    • /EnablePreview - Active les fonctionnalités d’évaluation de l’émulateur Azure Cosmos DB. Il s’agit des fonctionnalités de préversion qui sont encore en cours de développement et disponibles via l’intégration continue et l’exemple d’écriture.
    • /EnableAadAuthentication – permet à l’émulateur d’accepter des jetons d’ID Microsoft Entra personnalisés comme alternative aux clés principales d’Azure Cosmos DB. Cette fonctionnalité est toujours en cours de développement ; les affectations de rôles spécifiques et les autres paramètres liés aux autorisations ne sont pas pris en charge actuellement.

2.11.2 (7 juillet 2020)

  • Cette version modifie la façon dont l’émulateur Azure Cosmos DB collecte les traces. Windows Performance Runtime (WPR) constitue désormais les outils par défaut pour capturer les traces basées sur les journaux de suivi des événements lors de la dépréciation de la capture basée sur logman. Avec le dernier correctif de sécurité Windows, LOGMAN cessait de fonctionner comme prévu lorsqu’il était exécuté par le biais de l’émulateur Azure Cosmos DB.

2.11.1 (10 juin 2020)

  • Cette version corrige deux bogues liés à l’Explorateur de données de l’émulateur Azure Cosmos DB :
    • L’Explorateur de données ne parvenait pas à se connecter au point de terminaison de l’émulateur Azure Cosmos DB lorsqu’il était hébergé dans certaines versions de navigateurs web. Les utilisateurs de l’émulateur ne pouvaient pas toujours créer une base de données ou un conteneur sur la page web.
    • Les utilisateurs de l’émulateur ne pouvaient pas créer un élément à partir d’un fichier JSON à l’aide de l’action de chargement de l’Explorateur de données.

2.11.0

  • Cette version introduit la prise en charge du débit provisionné par la mise à l’échelle automatique. Parmi les fonctionnalités ajoutées figure la possibilité de définir un niveau personnalisé du débit maximal approvisionné dans les unités de requête (RU/s), la possibilité d’activer la mise à l’échelle automatique sur les bases de données et conteneurs existants et la prise en charge de l’API au moyen du kit SDK Azure Cosmos DB.
  • Correction d’un problème lors de l’interrogation d’un grand nombre de documents (plus de 1 Go), où l’émulateur échoue avec le code d’état d’erreur interne 500.

2.9.2

  • Cette version corrige un bogue pendant l’activation de la prise en charge du point de terminaison MongoDb version 3.2. Il ajoute également la prise en charge de la génération de messages de trace à des fins de résolution des problèmes à l’aide de l’enregistreur de performances Windows (WPR) au lieu de logman.

2.9.1

  • Cette version corrige deux problèmes dans la prise en charge de l’API de requête, et restaure la compatibilité avec les anciens systèmes d’exploitation tels que Windows Server 2012.

2.9.0

  • Cette version ajoute une option permettant de définir la cohérence avec un préfixe cohérent et d’augmenter les limites maximales pour les utilisateurs et les autorisations.

2.7.2

  • Cette version ajoute la prise en charge de la version 3.6 du serveur MongoDB à l’émulateur Azure Cosmos DB. Pour démarrer un point de terminaison MongoDB qui cible la version 3.6 du service, démarrez l’émulateur à partir d’une ligne de commande d’administrateur avec l’option « /EnableMongoDBEndpoint=3.6 ».

2.7.0

  • Cette version corrige une régression de l’émulateur Azure Cosmos DB qui empêchait les utilisateurs d’exécuter des requêtes SQL associées. Ce problème se produisait chez les utilisateurs de l’émulateur qui avaient configuré le point de terminaison de l’API pour NoSQL et utilisaient des applications clientes .NET Core ou x86 .NET.

2.4.6

  • Cette version offre une parité avec les fonctionnalités du service Azure Cosmos DB à compter de juillet 2019, avec les exceptions indiquées. Elle résout aussi plusieurs bogues liés à l’arrêt de l’émulateur quand il est appelé via la ligne de commande, et les remplacements d’adresses IP internes pour les clients SDK utilisant une connectivité en mode direct.

2.4.3

  • Le service MongoDB n’est plus démarré par défaut. Par défaut, l’émulateur active le point de terminaison SQL. L’utilisateur doit démarrer le point de terminaison manuellement à l’aide de l’option de ligne de commande /EnableMongoDbEndpoint de l’émulateur. C’est maintenant similaire aux autres points de terminaison de service, tels que Gremlin, Cassandra et Table.
  • Correction d’un bogue dans l’émulateur lors du démarrage avec « /AllowNetworkAccess », où les points de terminaison Gremlin, Cassandra et Table ne géraient pas correctement les requêtes des clients externes.
  • Ajoutez des ports de connexion directe aux paramètres de règles de pare-feu.

2.4.0

  • Correction d’un problème avec l’émulateur, qui ne parvenait pas à démarrer lorsque des applications de surveillance réseau, comme le client Pulse, sont présentes sur l’ordinateur hôte.

Étapes suivantes