سطر الأوامر ومرجع PowerShell لمحاكي Windows (المحلي)

ينطبق على: NoSQL MongoDB كاساندرا العفريت جدول

يوفر محاكي Azure Cosmos DB بيئة محلية تحاكي خدمة Azure Cosmos DB لأغراض التطوير المحلي. بعد تثبيت المحاكي، يمكنك التحكم في المحاكي باستخدام سطر الأوامر وأوامر PowerShell. توضح هذه المقالة كيفية استخدام أوامر سطر الأوامر وPowerShell لبدء تشغيل وإيقاف المحاكي وتكوين الخيارات وتنفيذ عمليات أخرى. يجب تشغيل الأوامر من موقع التثبيت.

إدارة المحاكي باستخدام صيغة سطر الأوامر

Microsoft.Azure.Cosmos.Emulator.exe 
    [/Shutdown] [/DataPath] [/Port] [/MongoPort] 
    [/DirectPorts] [/Key] [/EnableRateLimiting] 
    [/DisableRateLimiting] [/NoUI] [/NoExplorer] 
    [/EnableMongoDbEndpoint] 
    [/?]

لعرض قائمة المعلمات، اكتب Microsoft.Azure.Cosmos.Emulator.exe /? في موجه الأوامر.

إدارة المحاكي باستخدام PowerShell cmdlets

يأتي المحاكي مع وحدة PowerShell لبدء وإيقاف وإلغاء واسترداد حالة الخدمة. تشغيل cmdlet التالي لاستخدام وحدة PowerShell:

Import-Module "$env:ProgramFiles\Azure Cosmos DB Emulator\PSModules\Microsoft.Azure.CosmosDB.Emulator"

أو ضع PSModules الدليل على واستيراده PSModulePath كما هو موضح في الأمر التالي:

$env:PSModulePath += ";$env:ProgramFiles\Azure Cosmos DB Emulator\PSModules"
Import-Module Microsoft.Azure.CosmosDB.Emulator

فيما يلي ملخص للأوامر للتحكم في المحاكي من PowerShell:

Get-CosmosDbEmulatorStatus

الحصول على حالة المحاكي. إرجاع إحدى هذه ServiceControllerStatus القيم:

• ServiceControllerStatus.StartPending
• ServiceControllerStatus.Running
• ServiceControllerStatus.Stopped

إذا تمت مصادفة خطأ، فلن يتم إرجاع أي قيمة.

بناء الجملة

Get-CosmosDbEmulatorStatus 
    [[-AlternativeInstallLocation] <String>] 
    [<CommonParameters>]

المعلمات

الأمثلة

• احصل على حالة محاكي مثبت في D:\SomeFolder\AzureCosmosDBEmulator المجلد.

  @parameters = {
      AlternativeInstallLocation = "D:\SomeFolder\AzureCosmosDBEmulator"
  }
  Get-CosmosDbEmulatorStatus @parameters
  

Start-CosmosDbEmulator

بدء تشغيل المحاكي على الكمبيوتر المحلي. بشكل افتراضي، ينتظر الأمر حتى يكون المحاكي جاهزاً لقبول الطلبات. -NoWait استخدم الخيار ، إذا كنت ترغب في أن يعود cmdlet بمجرد بدء تشغيل المحاكي. استخدم معلمات Start-CosmosDbEmulator لتحديد خيارات، مثل منفذ NoSQL والمنفذ المباشر وأرقام منفذ MongoDB.

بناء الجملة

Start-CosmosDbEmulator [-AllowNetworkAccess]
    [-AlternativeInstallLocation <String>] [-CassandraPort <UInt16>]
    [-ComputePort <UInt16>] [-Consistency <String>] [-Credential
    <PSCredential>] [-DataPath <String>] [-DefaultPartitionCount
    <UInt16>] [-DirectPort <UInt16[]>] [-EnableMongoDb]
    [-EnableCassandra] [-EnableGremlin] [-EnableTable]
    [-EnableSqlCompute] [-EnablePreview]
    [-FailOnSslCertificateNameMismatch] [-GremlinPort <UInt16>]
    [-TablePort <UInt16>] [-SqlComputePort <UInt16>] [-Key <String>]
    [-MongoPort <UInt16>] [-MongoApiVersion <String>] [-NoFirewall]
    [-NoTelemetry] [-NoUI] [-NoWait] [-PartitionCount <UInt16>] [-Port
    <UInt16>] [-SimulateRateLimiting] [-Timeout <UInt32>] [-Trace]
    [<CommonParameters>]

المعلمات

الأمثلة

• ابدأ تشغيل المحاكي وانتظر حتى يكون جاهزا لقبول الطلبات.

  Start-CosmosDbEmulator
  

• ابدأ تشغيل المحاكي ب 5 أقسام محجوزة لكل مجموعة مقسمة. يتم تعيين العدد الإجمالي للأقسام إلى الافتراضي: 25. ومن ثم، فإن العدد الإجمالي للمجموعات المقسمة التي يمكن إنشاؤها هو 5 = 25 partitions / 5 partitions/collection. يتم تحديد كل مجموعة مقسمة عند 50 GB = 5 partitions * 10 GB / partiton.

  @parameters = {
      DefaultPartitionCount = 5
  }
  Start-CosmosDbEmulator @parameters
  

• بدء تشغيل المحاكي مع أرقام المنافذ البديلة.

  @parameters = {
      Port = 443 
      MongoPort = 27017 
      DirectPort = 20001,20002,20003,20004
  }
  Start-CosmosDbEmulator @parameters
  

Stop-CosmosDbEmulator

إيقاف المحاكي. بشكل افتراضي، ينتظر هذا الأمر حتى يتم إيقاف تشغيل المحاكي بالكامل. استخدم الخيار -NoWait، إذا كنت ترغب في إرجاع cmdlet بمجرد أن يبدأ المحاكي بإيقاف التشغيل.

بناء الجملة

Stop-CosmosDbEmulator 
    [[-AlternativeInstallLocation] <String>]
    [-NoWait] [[-Timeout] <UInt32>] [-Trace] 
    [<CommonParameters>]

المعلمات

الأمثلة

@parameters = {
    NoWait = $true
}
Stop-CosmosDbEmulator @parameters

Uninstall-CosmosDbEmulator

إلغاء تثبيت المحاكي وإزالة المحتويات الكاملة ل $env:LOCALAPPDATA\CosmosDbEmulatorاختياريا. يضمن cmdlet إيقاف المحاكي قبل إلغاء تثبيته.

بناء الجملة

Uninstall-CosmosDbEmulator 
    [-RemoveData] 
    [<CommonParameters>]

المعلمات

الأمثلة

@parameters = {
    RemoveData = $false
}
Uninstall-CosmosDbEmulator @parameters

تغيير عدد الحاويات الافتراضية

بشكل افتراضي، يمكنك إنشاء ما يصل إلى 25 حاوية ذات حجم ثابت (مدعومة فقط باستخدام مجموعات تطوير برامج Azure Cosmos DB (SDKs))، أو 5 حاويات غير محدودة باستخدام المحاكي. من خلال تعديل قيمة PartitionCount ، يمكنك إنشاء ما يصل إلى 250 حاوية ذات حجم ثابت أو 50 حاوية غير محدودة، أو أي مجموعة من الاثنين لا تتجاوز 250 حاوية ذات حجم ثابت (حيث حاوية واحدة غير محدودة = 5 حاويات ذات حجم ثابت). ومع ذلك، لا نوصي بإعداد المحاكي للتشغيل مع أكثر من 200 حاوية ذات حجم ثابت. وبسبب الحمل الزائد عن الحد الذي يضيفه إلى عمليات IO للقرص، ما يؤدي إلى مهلات غير متوقعة عند استخدام واجهات برمجة تطبيقات نقطة النهاية.

إذا حاولت إنشاء حاوية بعد تجاوز عدد الأقسام الحالي، يطرح المحاكي استثناء ServiceUnavailable، مع الرسالة التالية.

Sorry, we are currently experiencing high demand in this region, and cannot fulfill your request at this time. We work continuously to bring more and more capacity online, and encourage you to try again.
ActivityId: 12345678-1234-1234-1234-123456789abc

لتغيير عدد الحاويات المتوفرة في المحاكي، قم بتشغيل الخطوات التالية:

1. احذف جميع بيانات المحاكي المحلي بالنقر بزر الماوس الأيمن فوق أيقونة المحاكي في علبة النظام، ثم النقر فوق إعادة تعيين البيانات....

2. احذف جميع بيانات المحاكي في هذا المجلد %LOCALAPPDATA%\CosmosDBEmulator.

3. قم بإنهاء جميع المثيلات المفتوحة بالنقر بزر الماوس الأيمن فوق أيقونة المحاكي في علبة النظام، ثم النقر فوق إنهاء. قد يستغرق إنهاء جميع المثيلات دقيقة.

4. تثبيت أحدث إصدار من المحاكي.

5. شغّل المحاكي مع علامة PartitionCount من خلال تعيين قيمة <= 250. على سبيل المثال: C:\Program Files\emulator> Microsoft.Azure.Cosmos.Emulator.exe /PartitionCount=100.

الخطوات التالية

• تعرف على المزيد حول محاكي Azure Cosmos DB
• مراجعة ملاحظات إصدار المحاكي