Was ist der Azure Cosmos DB Emulator?

Der Azure Cosmos DB Emulator stellt eine lokale Umgebung bereit, in der der Azure Cosmos DB Dienst emuliert wird, der für Entwicklungszwecke entwickelt wurde. Mit dem Emulator können Sie Ihre Anwendung lokal entwickeln und testen, ohne ein Azure-Abonnement anlegen oder Dienstkosten entstehen zu lassen. Wenn Sie mit der Funktionsweise Ihrer Anwendung mit dem Emulator zufrieden sind, können Sie mit minimaler Reibung zu einem Azure Cosmos DB Konto wechseln.

Important

Es wird nicht empfohlen, den Emulator für Produktionsworkloads zu verwenden.

Tip

Besuchen Sie unsere neue Beispielgalerie für die neuesten Beispiele zum Erstellen neuer Apps

Unterschiede zwischen dem Emulator und dem Clouddienst

Der Emulator stellt eine Umgebung in Ihrem Entwicklerarbeitsbereich bereit, die nicht in der Lage ist, jeden Aspekt des Azure Cosmos DB-Diensts zu emulieren. Hier sind einige wichtige Unterschiede bei der Funktionalität zwischen dem Emulator und dem entsprechenden Clouddienst.

Important

Der Linux-Emulator unterstützt derzeit keine Entwicklercomputer, die auf Apple Silicon-Serie oder Microsoft ARM-Chips ausgeführt werden. Eine temporäre Problemumgehung besteht darin, einen Windows virtuellen Computer zu installieren und den Emulator auf dieser Plattform auszuführen.

Alternativ können Sie den neuen Linux-basierten Azure Cosmos DB Emulator (Vorschau) verwenden.

  • Der Bereich Data Explorer des Emulators wird nur in der API für NoSQL und API für MongoDB unterstützt.
  • Der Emulator unterstützt nur den bereitgestellten Durchsatz. Der Emulator unterstützt keinen serverlosen Durchsatz.
  • Der Emulator verwendet beim Starten einen bekannten Schlüssel. Sie können den Schlüssel für den ausgeführten Emulator nicht neu generieren. Um einen anderen Schlüssel zu verwenden, müssen Sie den Emulator mit dem angegebenen benutzerdefinierten Schlüssel starten.
  • Der Emulator kann nicht über geografische Regionen oder mehrere Instanzen repliziert werden. Es wird nur eine einzelne ausgeführte Instanz des Emulators unterstützt. Der Emulator kann nicht verkleinert werden.
  • Der Emulator unterstützt idealerweise bis zu 10 Container mit fester Größe bei 400 RU/s oder 5 containern mit unbegrenzter Größe. Theoretisch können Sie weitere Container erstellen, aber sie könnten mit dem Emulator Leistungsbeeinträchtigungen erleben.
  • Der Emulator unterstützt nur die Sitzungs- und Starkekonsistenzstufen. Der Emulator ist kein skalierbarer Dienst und implementiert nicht tatsächlich die Konsistenzstufen. Der Emulator kennzeichnet nur die konfigurierte Konsistenzstufe zu Testzwecken.
  • Der Emulator beschränkt den eindeutigen Bezeichner von Elementen auf eine Größe von 254 Zeichen.
  • Der Emulator unterstützt maximal fünf JOIN Anweisungen pro Abfrage.

Die Features des Emulators liegen möglicherweise hinter dem Tempo neuer Features für den Clouddienst. Möglicherweise gibt es neue Features und Änderungen im Clouddienst, die eine kleine Verzögerung aufweisen, bevor sie im Emulator verfügbar sind.

Authentifizierung

Jede Anforderung für den Emulator muss mithilfe eines Schlüssels über TLS/SSL authentifiziert werden. Der Emulator wird mit einem einzigen Konto ausgeliefert, das für die Verwendung eines bekannten Authentifizierungsschlüssels konfiguriert ist. Standardmäßig sind diese Anmeldeinformationen die einzigen Anmeldeinformationen, die für die Verwendung mit dem Emulator zulässig sind:

Value
Endpunkt localhost:8081
Schlüssel C2y6yDjf5/R+ob0N8A7Cgv30VRDJIWEHLM+4QDU5DE2nQ9nDuVTqobD4b8mGGyPMbIZnqyMsEcaGQy67XIw/Jw==
Verbindungszeichenfolge AccountEndpoint=https://localhost:8081/;AccountKey=C2y6yDjf5/R+ob0N8A7Cgv30VRDJIWEHLM+4QDU5DE2nQ9nDuVTqobD4b8mGGyPMbIZnqyMsEcaGQy67XIw/Jw==;

Tip

Mit dem Windows(lokalen) Emulator können Sie auch den vom Emulator verwendeten Schlüssel anpassen. Weitere Informationen finden Sie unter Windows Emulatorargumente.

Importieren des Emulatorzertifikats

In einigen Fällen möchten Sie das TLS/SS-Zertifikat möglicherweise manuell aus dem ausgeführten Container des Emulators in Ihren Hostcomputer importieren. In diesem Schritt werden schlechte Methoden wie das Deaktivieren der TLS/SSL-Validierung im SDK vermieden. Weitere Informationen finden Sie unter Importzertifikat.

Nächster Schritt