Co je emulátor služby Azure Cosmos DB?

Emulátor služby Azure Cosmos DB poskytuje místní prostředí, které emuluje službu Azure Cosmos DB určenou pro účely vývoje. Pomocí emulátoru můžete vyvíjet a testovat aplikaci místně bez vytvoření předplatného Azure nebo bez jakýchkoli nákladů na služby. Až budete spokojeni s tím, jak vaše aplikace pracuje s emulátorem, můžete přejít na účet služby Azure Cosmos DB s minimálním třením.

Důležité

Nedoporučujeme používat emulátor pro produkční úlohy.

Rozdíly mezi emulátorem a cloudovou službou

Emulátor poskytuje prostředí ve vašem pracovním prostoru pro vývojáře, které nedokáže emulovat všechny aspekty služby Azure Cosmos DB. Tady je několik klíčových rozdílů ve funkcích mezi emulátorem a ekvivalentní cloudovou službou.

Důležité

Emulátor Linuxu má v současné době omezenou podporu pro počítače vývojářů běžící na čipech M1 a M2. Dočasným alternativním řešením je nainstalovat virtuální počítač s Windows a spustit emulátor na této platformě.

  • Podokno Průzkumník dat emulátoru se podporuje jenom v rozhraní API for NoSQL a API pro MongoDB.
  • Emulátor podporuje pouze zřízenou propustnost. Emulátor nepodporuje propustnost bez serveru.
  • Emulátor používá při spuštění dobře známý klíč. Klíč pro spuštěný emulátor nejde znovu vygenerovat. Pokud chcete použít jiný klíč, musíte spustit emulátor se zadaným vlastním klíčem.
  • Emulátor se nedá replikovat napříč geografickými oblastmi ani několika instancemi. Podporuje se pouze jedna spuštěná instance emulátoru. Emulátor nejde škálovat na více instancí.
  • Emulátor podporuje maximálně 10 kontejnerů s pevnou velikostí na 400 RU/s nebo 5 kontejnerů s neomezenou velikostí.
  • Emulátor podporuje pouze úrovně relace a silné konzistence. Emulátor není škálovatelná služba a ve skutečnosti neimplementuje úrovně konzistence. Emulátor označí nakonfigurovanou úroveň konzistence pouze pro účely testování.
  • Emulátor omezují jedinečný identifikátor položek na velikost 254 znaků.
  • Emulátor podporuje maximálně pět JOIN příkazů na dotaz.

Funkce emulátoru můžou zpožďovat tempo nových funkcí cloudové služby. V cloudové službě můžou být potenciálně nové funkce a změny, které mají malé zpoždění, než budou dostupné v emulátoru.

Authentication

Každý požadavek provedený proti emulátoru musí být ověřený pomocí klíče přes protokol TLS/SSL. Emulátor se dodává s jedním účtem nakonfigurovaným tak, aby používal dobře známý ověřovací klíč. Ve výchozím nastavení jsou tyto přihlašovací údaje jedinými přihlašovacími údaji povolenými pro použití s emulátorem:

Hodnota
Endpoint localhost:8081
Klíč C2y6yDjf5/R+ob0N8A7Cgv30VRDJIWEHLM+4QDU5DE2nQ9nDuVTqobD4b8mGGyPMbIZnqyMsEcaGQy67XIw/Jw==
Připojovací řetězec AccountEndpoint=https://localhost:8081/;AccountKey=C2y6yDjf5/R+ob0N8A7Cgv30VRDJIWEHLM+4QDU5DE2nQ9nDuVTqobD4b8mGGyPMbIZnqyMsEcaGQy67XIw/Jw==;

Tip

Pomocí emulátoru systému Windows (místní) můžete také přizpůsobit klíč používaný emulátorem. Další informace naleznete v tématu Argumenty emulátoru systému Windows.

Import certifikátu emulátoru

V některých případech můžete chtít ručně importovat certifikát TLS/SS z kontejneru spuštěného emulátoru do hostitelského počítače. Tento krok se vyhne špatným postupům, jako je zakázání ověřování TLS/SSL v sadě SDK. Další informace najdete v tématu import certifikátu.

Další krok