什麼是 Azure Cosmos DB 模擬器?

Azure Cosmos DB 模擬器提供一個本地環境,模擬專為開發目的設計的 Azure Cosmos DB 服務。 透過模擬器,你可以在本地開發和測試你的應用程式,無需建立 Azure 訂閱,也不會產生任何服務成本。 當你對應用程式與模擬器的運作感到滿意後,就可以無縫轉換到 Azure Cosmos DB 帳號,幾乎沒有阻力。

Important

我們不建議在生產工作負載中使用模擬器。

小提示

請造訪我們的新 範例畫廊 ,獲取最新打造新應用程式的範例

模擬器與雲端服務的差異

模擬器在你的開發者工作空間中提供一個無法模擬 Azure Cosmos DB 服務所有面向的環境。 以下是模擬器與同等雲端服務在功能上的幾個主要差異。

Important

Linux 模擬器目前不支援運行於 Apple Silicon 系列或 Microsoft ARM 晶片上的開發者機器。 一個臨時的解決方法是安裝 Windows 虛擬機,並在該平台上執行模擬器。

另外,你也可以使用新的Linux基礎的Azure Cosmos DB模擬器(預覽版)

  • 模擬器的 Data Explorer 面板僅支援於 API for NoSQL 和 API for MongoDB。
  • 模擬器僅支援 已配置的吞吐量。 模擬器不支援 無伺服器 吞吐量。
  • 模擬器啟動時使用一個知名的金鑰。 你無法重新生成執行中的模擬器的金鑰。 若要使用不同金鑰,必須 先設定自訂金鑰啟動模擬器。
  • 模擬器無法跨地理區域或跨多個實例複製。 只支援一個執行中的模擬器實例。 模擬器無法擴展。
  • 模擬器理想上支援最多 10 個固定大小容器,速度為 400 RU/s,或 5 個無限大小容器。 理論上你可以建立更多容器,但模擬器可能會讓效能下降。
  • 模擬器僅支援 SessionStrong 一致性等級。 模擬器本身不是一個可擴展的服務,實際上也沒有實作一致性等級。 模擬器只會標記設定的一致性等級以供測試。
  • 模擬器限制項目的唯一識別碼為 254 個字元。
  • 模擬器每個查詢最多支援五個 JOIN 語句。

模擬器的功能可能落後於雲端服務的新功能。 雲端服務可能會有新功能和變更,不過,由於這些變動在模擬器中生效前可能會有短暫的延遲。

Authentication

每個對模擬器的請求都必須透過 TLS/SSL 上的金鑰進行驗證。 模擬器附帶一個設定為使用知名驗證金鑰的帳號。 預設情況下,這些憑證是模擬器中唯一允許使用的憑證:

Value
端點 localhost:8081
鑰匙 C2y6yDjf5/R+ob0N8A7Cgv30VRDJIWEHLM+4QDU5DE2nQ9nDuVTqobD4b8mGGyPMbIZnqyMsEcaGQy67XIw/Jw==
連接字串 AccountEndpoint=https://localhost:8081/;AccountKey=C2y6yDjf5/R+ob0N8A7Cgv30VRDJIWEHLM+4QDU5DE2nQ9nDuVTqobD4b8mGGyPMbIZnqyMsEcaGQy67XIw/Jw==;

小提示

在 Windows(本地)模擬器中,你也可以自訂模擬器所使用的金鑰。 欲了解更多資訊,請參見 Windows 模擬器參數

匯入模擬器憑證

有時候,你可能會想手動將模擬器運行容器中的 TLS/SS 憑證匯入你的主機。 此步驟避免了像是關閉 SDK 中 TLS/SSL 驗證這類不良做法。 欲了解更多資訊,請參閱 進口證書

下一個步驟