Vad är Azure Cosmos DB-emulatorn?

  • Artikel

Azure Cosmos DB-emulatorn tillhandahåller en lokal miljö som emulerar Azure Cosmos DB-tjänsten som är utformad för utveckling. Med emulatorn kan du utveckla och testa ditt program lokalt, utan att skapa en Azure-prenumeration eller medföra några tjänstkostnader. När du är nöjd med hur programmet fungerar med emulatorn kan du övergå till att använda ett Azure Cosmos DB-konto med minimal friktion.

Viktigt!

Vi rekommenderar inte att emulatorn används för produktionsarbetsbelastningar.

Skillnader mellan emulatorn och molntjänsten

Emulatorn tillhandahåller en miljö på utvecklararbetsytan som inte kan emulera alla aspekter av Azure Cosmos DB-tjänsten. Här följer några viktiga skillnader i funktioner mellan emulatorn och motsvarande molntjänst.

Viktigt!

Linux-emulatorn har för närvarande begränsat stöd för utvecklardatorer som körs på M1- och M2-chips. En tillfällig lösning är att installera en virtuell Windows-dator och köra emulatorn på den plattformen.

  • Emulatorns datautforskarens fönster stöds endast i API:et för NoSQL och API för MongoDB.
  • Emulatorn stöder endast etablerat dataflöde. Emulatorn stöder inte serverlöst dataflöde.
  • Emulatorn använder en välkänd nyckel när den startas. Du kan inte återskapa nyckeln för den emulator som körs. Om du vill använda en annan nyckel måste du starta emulatorn med den anpassade nyckeln angiven.
  • Emulatorn kan inte replikeras mellan geografiska regioner eller flera instanser. Endast en enda instans av emulatorn som körs stöds. Det går inte att skala ut emulatorn.
  • Emulatorn stöder endast upp till 10 containrar med fast storlek på 400 RU/s eller 5 containrar med obegränsad storlek.
  • Emulatorn stöder endast nivåerna Session och Stark konsekvens. Emulatorn är inte en skalbar tjänst och implementerar inte konsekvensnivåerna. Emulatorn flaggar bara den konfigurerade konsekvensnivån i testsyfte.
  • Emulatorn begränsar den unika identifieraren för objekt till en storlek på 254 tecken.
  • Emulatorn stöder högst fem JOIN instruktioner per fråga.

Emulatorns funktioner kan ligga efter takten i de nya funktionerna för molntjänsten. Det kan finnas nya funktioner och ändringar i molntjänsten som har en liten fördröjning innan de är tillgängliga i emulatorn.

Autentisering

Varje begäran som görs mot emulatorn måste autentiseras med hjälp av en nyckel över TLS/SSL. Emulatorn levereras med ett enda konto som är konfigurerat för att använda en välkänd autentiseringsnyckel. Som standard är dessa autentiseringsuppgifter de enda autentiseringsuppgifter som tillåts för användning med emulatorn:

Värde
Slutpunkt localhost:8081
Tangent C2y6yDjf5/R+ob0N8A7Cgv30VRDJIWEHLM+4QDU5DE2nQ9nDuVTqobD4b8mGGyPMbIZnqyMsEcaGQy67XIw/Jw==
Anslutningssträng AccountEndpoint=https://localhost:8081/;AccountKey=C2y6yDjf5/R+ob0N8A7Cgv30VRDJIWEHLM+4QDU5DE2nQ9nDuVTqobD4b8mGGyPMbIZnqyMsEcaGQy67XIw/Jw==;

Dricks

Med Windows-emulatorn (lokal) kan du även anpassa nyckeln som används av emulatorn. Mer information finns i Argument för Windows-emulatorn.

Importera emulatorcertifikat

I vissa fall kanske du vill importera TLS/SS-certifikatet manuellt från emulatorns container som körs till värddatorn. Det här steget undviker dåliga metoder som att inaktivera TLS/SSL-validering i SDK. Mer information finns i importera certifikat.

Gå vidare

Kom igång med Azure Cosmos DB-emulatorn för utveckling