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.

Important

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

Tip

Bezoek onze nieuwe voorbeeldengalerie voor de nieuwste voorbeelden voor het bouwen van nieuwe apps

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.

Important

De Linux-emulator biedt momenteel geen ondersteuning voor ontwikkelaarsmachines die worden uitgevoerd op Apple silicon series of Microsoft ARM-chips. Een tijdelijke tijdelijke oplossing is het installeren van een Windows virtuele machine en het uitvoeren van de emulator op dat platform.

U kunt ook de nieuwe Linux-gebaseerde Azure Cosmos DB emulator (preview) gebruiken.

  • 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 idealiter maximaal 10 containers met vaste grootte bij 400 RU/s of 5 containers met onbeperkte grootte. Theoretisch kunt u meer containers maken, maar u kunt prestatievermindering ervaren met de emulator.
  • 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.

Authentication

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:

Value
Eindpunt localhost:8081
Sleutel C2y6yDjf5/R+ob0N8A7Cgv30VRDJIWEHLM+4QDU5DE2nQ9nDuVTqobD4b8mGGyPMbIZnqyMsEcaGQy67XIw/Jw==
Verbindingsstring AccountEndpoint=https://localhost:8081/;AccountKey=C2y6yDjf5/R+ob0N8A7Cgv30VRDJIWEHLM+4QDU5DE2nQ9nDuVTqobD4b8mGGyPMbIZnqyMsEcaGQy67XIw/Jw==;

Tip

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

Emulatorcertificaat importeren

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

Volgende stap