Che cos'è l'emulatore di Azure Cosmos DB?
L'emulatore di Azure Cosmos DB fornisce un ambiente locale che emula il servizio Azure Cosmos DB progettato per scopi di sviluppo. Usando l'emulatore, è possibile sviluppare e testare l'applicazione in locale, senza creare una sottoscrizione di Azure o sostenere costi del servizio. Quando si è soddisfatti del funzionamento dell'applicazione con l'emulatore, è possibile passare all'uso di un account Azure Cosmos DB con un attrito minimo.
Importante
Non è consigliabile usare l'emulatore per i carichi di lavoro di produzione.
Differenze tra l'emulatore e il servizio cloud
L'emulatore fornisce un ambiente nell'area di lavoro per sviluppatori che non è in grado di simulare ogni aspetto del servizio Azure Cosmos DB. Ecco alcune differenze principali nelle funzionalità tra l'emulatore e il servizio cloud equivalente.
Importante
L'emulatore Linux attualmente ha un supporto limitato per i computer per sviluppatori in esecuzione su chip M1 e M2. Una soluzione alternativa temporanea consiste nell'installare una macchina virtuale Windows ed eseguire l'emulatore in tale piattaforma.
- Il riquadro Esplora dati dell'emulatore è supportato solo nell'API per NoSQL e nell'API per MongoDB.
- L'emulatore supporta solo la velocità effettiva con provisioning. L'emulatore non supporta la velocità effettiva serverless .
- L'emulatore usa una chiave nota all'avvio. Non è possibile rigenerare la chiave per l'emulatore in esecuzione. Per usare una chiave diversa, è necessario avviare l'emulatore con la chiave personalizzata specificata.
- L'emulatore non può essere replicato tra aree geografiche o più istanze. È supportata solo una singola istanza in esecuzione dell'emulatore. Non è possibile aumentare il numero di istanze dell'emulatore.
- L'emulatore supporta solo fino a 10 contenitori a dimensione fissa a 400 UR/s o 5 contenitori di dimensioni illimitate.
- L'emulatore supporta solo i livelli di coerenza sessione e assoluta . L'emulatore non è un servizio scalabile e non implementa effettivamente i livelli di coerenza. L'emulatore contrassegna solo il livello di coerenza configurato a scopo di test.
- L'emulatore vincoli l'identificatore univoco degli elementi a una dimensione di 254 caratteri.
- L'emulatore supporta un massimo di cinque
JOINistruzioni per ogni query.
Le funzionalità dell'emulatore potrebbero essere in ritardo al ritmo delle nuove funzionalità per il servizio cloud. Potrebbero esserci nuove funzionalità e modifiche nel servizio cloud con un piccolo ritardo prima che siano disponibili nell'emulatore.
Autenticazione
Ogni richiesta eseguita sull'emulatore deve essere autenticata usando una chiave su TLS/SSL. L'emulatore viene fornito con un singolo account configurato per l'uso di una chiave di autenticazione nota. Per impostazione predefinita, queste credenziali sono le uniche credenziali consentite per l'uso con l'emulatore:
| Valore | |
|---|---|
| Endpoint | localhost:8081 |
| Chiave | C2y6yDjf5/R+ob0N8A7Cgv30VRDJIWEHLM+4QDU5DE2nQ9nDuVTqobD4b8mGGyPMbIZnqyMsEcaGQy67XIw/Jw== |
| Stringa di connessione | AccountEndpoint=https://localhost:8081/;AccountKey=C2y6yDjf5/R+ob0N8A7Cgv30VRDJIWEHLM+4QDU5DE2nQ9nDuVTqobD4b8mGGyPMbIZnqyMsEcaGQy67XIw/Jw==; |
Suggerimento
Con l'emulatore windows (locale) puoi anche personalizzare la chiave usata dall'emulatore. Per altre informazioni, vedere Argomenti dell'emulatore di Windows.
Importare il certificato dell'emulatore
In alcuni casi, è possibile importare manualmente il certificato TLS/SS dal contenitore in esecuzione dell'emulatore nel computer host. Questo passaggio evita procedure non consigliate, ad esempio la disabilitazione della convalida TLS/SSL nell'SDK. Per altre informazioni, vedere Importare il certificato.