Wat is de Azure Cosmos DB-emulator?

De Azure Cosmos DB-emulator biedt een lokale omgeving waarmee de Azure Cosmos DB-service wordt geëmuleren die is ontworpen voor ontwikkelingsdoeleinden. Met behulp van de emulator kunt u uw toepassing lokaal ontwikkelen en testen zonder een Azure-abonnement te maken of servicekosten in rekening te brengen. Wanneer u tevreden bent over de werking van uw toepassing met de emulator, kunt u overstappen op het gebruik van een Azure Cosmos DB-account met minimale wrijving.

Belangrijk

We raden het gebruik van de emulator niet aan voor productieworkloads.

Verschillen tussen de emulator en cloudservice

De emulator biedt een omgeving in uw ontwikkelwerkruimte die niet elk aspect van de Azure Cosmos DB-service kan emuleren. Hier volgen enkele belangrijke verschillen in functionaliteit tussen de emulator en de equivalente cloudservice.

Belangrijk

De Linux-emulator biedt momenteel beperkte ondersteuning voor ontwikkelaarscomputers die worden uitgevoerd op M1- en M2-chips. Een tijdelijke tijdelijke oplossing is het installeren van een virtuele Windows-machine en het uitvoeren van de emulator op dat platform.

  • Het deelvenster Data Explorer van de emulator wordt alleen ondersteund in de API voor NoSQL en API voor MongoDB.
  • De emulator ondersteunt alleen ingerichte doorvoer. De emulator biedt geen ondersteuning voor serverloze doorvoer.
  • De emulator gebruikt een bekende sleutel wanneer deze wordt gestart. U kunt de sleutel voor de actieve emulator niet opnieuw genereren. Als u een andere sleutel wilt gebruiken, moet u de emulator starten met de opgegeven aangepaste sleutel.
  • De emulator kan niet worden gerepliceerd in geografische regio's of meerdere exemplaren. Er wordt slechts één actief exemplaar van de emulator ondersteund. De emulator kan niet worden uitgeschaald.
  • De emulator ondersteunt alleen maximaal 10 containers met een vaste grootte bij 400 RU/s of 5 containers met onbeperkte grootte.
  • De emulator ondersteunt alleen de consistentieniveaus Sessie en Sterk . De emulator is geen schaalbare service en implementeert niet daadwerkelijk de consistentieniveaus. De emulator markeert alleen het geconfigureerde consistentieniveau voor testdoeleinden.
  • De emulator beperkt de unieke id van items tot een grootte van 254 tekens.
  • De emulator ondersteunt maximaal vijf JOIN instructies per query.

De functies van de emulator kunnen achterblijven in het tempo van nieuwe functies voor de cloudservice. Er kunnen mogelijk nieuwe functies en wijzigingen in de cloudservice zijn die een kleine vertraging hebben voordat ze beschikbaar zijn in de emulator.

Verificatie

Elke aanvraag voor de emulator moet worden geverifieerd met behulp van een sleutel via TLS/SSL. De emulator wordt geleverd met één account dat is geconfigureerd voor het gebruik van een bekende verificatiesleutel. Deze referenties zijn standaard de enige referenties die zijn toegestaan voor gebruik met de emulator:

Weergegeven als
Eindpunt localhost:8081
Code C2y6yDjf5/R+ob0N8A7Cgv30VRDJIWEHLM+4QDU5DE2nQ9nDuVTqobD4b8mGGyPMbIZnqyMsEcaGQy67XIw/Jw==
Verbindingsreeks AccountEndpoint=https://localhost:8081/;AccountKey=C2y6yDjf5/R+ob0N8A7Cgv30VRDJIWEHLM+4QDU5DE2nQ9nDuVTqobD4b8mGGyPMbIZnqyMsEcaGQy67XIw/Jw==;

Tip

Met de Windows-emulator (lokaal) kunt u ook de sleutel aanpassen die door de emulator wordt gebruikt. Zie Argumenten voor Windows-emulator voor meer informatie.

Emulatorcertificaat importeren

In sommige gevallen kunt u het TLS/SS-certificaat handmatig importeren uit de container die wordt uitgevoerd in de emulator op uw hostcomputer. Deze stap voorkomt slechte procedures, zoals het uitschakelen van TLS/SSL-validatie in de SDK. Zie het importcertificaat voor meer informatie.

Volgende stap