Apa itu emulator Azure Cosmos DB?

  • Artikel

Emulator Azure Cosmos DB menyediakan lingkungan lokal yang meniru layanan Azure Cosmos DB yang dirancang untuk tujuan pengembangan. Dengan menggunakan emulator, Anda dapat mengembangkan dan menguji aplikasi Anda secara lokal, tanpa membuat langganan Azure atau menimbulkan biaya layanan apa pun. Ketika Anda puas dengan cara kerja aplikasi Anda dengan emulator, Anda dapat beralih menggunakan akun Azure Cosmos DB dengan gesekan minimal.

Penting

Kami tidak merekomendasikan penggunaan emulator untuk beban kerja produksi.

Perbedaan antara emulator dan layanan cloud

Emulator menyediakan lingkungan di ruang kerja pengembang Anda yang tidak mampu menimulasi setiap aspek layanan Azure Cosmos DB. Berikut adalah beberapa perbedaan utama dalam fungsionalitas antara emulator dan layanan cloud yang setara.

Penting

Emulator Linux saat ini memiliki dukungan terbatas untuk mesin pengembang yang berjalan pada chip M1 dan M2. Solusi sementara adalah menginstal komputer virtual Windows dan menjalankan emulator di platform tersebut.

  • Panel Data Explorer emulator hanya didukung di API untuk NoSQL dan API untuk MongoDB.
  • Emulator hanya mendukung throughput yang disediakan. Emulator tidak mendukung throughput tanpa server.
  • Emulator menggunakan kunci terkenal saat dimulai. Anda tidak dapat meregenerasi kunci untuk emulator yang sedang berjalan. Untuk menggunakan kunci yang berbeda, Anda harus memulai emulator dengan kunci kustom yang ditentukan.
  • Emulator tidak dapat direplikasi di seluruh wilayah geografis atau beberapa instans. Hanya satu instans emulator yang berjalan yang didukung. Emulator tidak dapat diskalakan.
  • Emulator hanya mendukung hingga 10 kontainer ukuran tetap pada 400 RU/dtk atau 5 kontainer berukuran tidak terbatas.
  • Emulator hanya mendukung tingkat konsistensi Sesi dan Kuat . Emulator bukan layanan yang dapat diskalakan dan tidak benar-benar mengimplementasikan tingkat konsistensi. Emulator hanya menandai tingkat konsistensi yang dikonfigurasi untuk tujuan pengujian.
  • Emulator membatasi pengidentifikasi unik item hingga ukuran 254 karakter.
  • Emulator mendukung maksimum lima JOIN pernyataan per kueri.

Fitur emulator mungkin tertinggal dari laju fitur baru untuk layanan cloud. Berpotensi ada fitur dan perubahan baru dalam layanan cloud yang memiliki penundaan kecil sebelum tersedia di emulator.

Autentikasi

Setiap permintaan yang dibuat terhadap emulator harus diautentikasi menggunakan kunci melalui TLS/SSL. Emulator dikirim dengan satu akun yang dikonfigurasi untuk menggunakan kunci autentikasi terkenal. Secara default, kredensial ini adalah satu-satunya kredensial yang diizinkan untuk digunakan dengan emulator:

Nilai
Endpoint localhost:8081
Kunci C2y6yDjf5/R+ob0N8A7Cgv30VRDJIWEHLM+4QDU5DE2nQ9nDuVTqobD4b8mGGyPMbIZnqyMsEcaGQy67XIw/Jw==
String koneksi AccountEndpoint=https://localhost:8081/;AccountKey=C2y6yDjf5/R+ob0N8A7Cgv30VRDJIWEHLM+4QDU5DE2nQ9nDuVTqobD4b8mGGyPMbIZnqyMsEcaGQy67XIw/Jw==;

Tip

Dengan emulator Windows (lokal), Anda juga dapat menyesuaikan kunci yang digunakan oleh emulator. Untuk informasi selengkapnya, lihat Argumen emulator Windows.

Mengimpor sertifikat emulator

Dalam beberapa kasus, Anda mungkin ingin mengimpor sertifikat TLS/SS secara manual dari kontainer emulator yang sedang berjalan ke komputer host Anda. Langkah ini menghindari praktik buruk seperti menonaktifkan validasi TLS/SSL di SDK. Untuk informasi selengkapnya, lihat mengimpor sertifikat.

Langkah selanjutnya

Mulai menggunakan emulator Azure Cosmos DB untuk pengembangan