Windows (yerel) öykünücüsü için komut satırı ve PowerShell başvurusu

ŞUNLAR IÇIN GEÇERLIDIR: NoSQL MongoDB Cassandra Gremlin Masa

Azure Cosmos DB öykünücüsü, yerel geliştirme amacıyla Azure Cosmos DB hizmetine öykünen yerel bir ortam sağlar. Öykünücüyü yükledikten sonra, komut satırı ve PowerShell komutları ile öykünücüyü denetleyebilirsiniz. Bu makalede, öykünücüyü başlatmak ve durdurmak, seçenekleri yapılandırmak ve diğer işlemleri gerçekleştirmek için komut satırı ve PowerShell komutlarının nasıl kullanılacağı açıklanmaktadır. Komutları yükleme konumundan çalıştırmanız gerekir.

Öykünücüyü komut satırı söz dizimi ile yönetme

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

Parametre listesini görüntülemek için komut istemine yazın Microsoft.Azure.Cosmos.Emulator.exe /? .

Öykünücüyü PowerShell cmdlet'leriyle yönetme

Öykünücü, hizmetin durumunu başlatmak, durdurmak, kaldırmak ve almak için bir PowerShell modülüyle birlikte gelir. PowerShell modülünü kullanmak için aşağıdaki cmdlet'i çalıştırın:

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

Veya dizininize PSModulePath yerleştirin PSModules ve aşağıdaki komutta gösterildiği gibi içeri aktarın:

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

Öykünücüyü PowerShell'den denetlemeye yönelik komutların özeti aşağıdadır:

Get-CosmosDbEmulatorStatus

Öykünücünün durumunu alır. Şu ServiceControllerStatus değerlerden birini döndürür:

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

Hatayla karşılaşılırsa hiçbir değer döndürülür.

Sözdizimi

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

Parametreler

Örnekler

• Klasörüne yüklenmiş bir öykünücünün D:\SomeFolder\AzureCosmosDBEmulator durumunu alın.

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

Start-CosmosDbEmulator

Öykünücüyü yerel bilgisayarda başlatır. Varsayılan olarak komut, öykünücünün istekleri kabul etmeye hazır olmasını bekler. -NoWait Cmdlet'in öykünücüyü başlattığı anda geri dönmesini istiyorsanız seçeneğini kullanın. NoSQL bağlantı noktası, doğrudan bağlantı noktası ve MongoDB bağlantı noktası numaraları gibi seçenekleri belirtmek için parametresini Start-CosmosDbEmulator kullanın.

Sözdizimi

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>]

Parametreler

Örnekler

• Öykünücüyü başlatın ve istekleri kabul etmeye hazır olana kadar bekleyin.

  Start-CosmosDbEmulator
  

• Her bölümlenmiş koleksiyon için ayrılmış 5 bölümle öykünücüyü başlatın. Toplam bölüm sayısı varsayılan değere ayarlanır: 25. Bu nedenle, oluşturulabilecek bölümlenmiş koleksiyonların toplam sayısıdır 5 = 25 partitions / 5 partitions/collection. Bölümlenmiş koleksiyonların her biri konumunda 50 GB = 5 partitions * 10 GB / partitoneşlenir.

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

• Öykünücüyü alternatif bağlantı noktası numaralarıyla başlatır.

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

Stop-CosmosDbEmulator

Öykünücüyü durdurur. Varsayılan olarak bu komut, öykünücünün tamamen kapanmasını bekler. Cmdlet’in öykünücü kapanmaya başladığı anda geri dönmesini istiyorsanız -NoWait seçeneğini kullanın.

Sözdizimi

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

Parametreler

Örnekler

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

Uninstall-CosmosDbEmulator

Öykünücüyü kaldırır ve isteğe bağlı olarak tüm içeriğini $env:LOCALAPPDATA\CosmosDbEmulatorkaldırır. Cmdlet, öykünücüyü kaldırmadan önce öykünücünün tamamen durdurulduğundan emin olur.

Sözdizimi

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

Parametreler

Örnekler

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

Varsayılan kapsayıcı sayısını değiştirme

Varsayılan olarak, öykünücüyü kullanarak en fazla 25 sabit boyutlu kapsayıcı (yalnızca Azure Cosmos DB yazılım geliştirme setleri (SDK) kullanılarak desteklenir) veya 5 sınırsız kapsayıcı oluşturabilirsiniz. PartitionCount değerini değiştirerek, 250'ye kadar sabit boyutlu kapsayıcı veya 50 sınırsız kapsayıcı ya da 250 sabit boyutlu kapsayıcıyı (bir sınırsız kapsayıcı = 5 sabit boyutlu kapsayıcı) aşmayan ikisinin herhangi bir bileşimini oluşturabilirsiniz. Ancak öykünücüyü 200'den fazla sabit boyutlu kapsayıcıyla çalışacak şekilde ayarlamanızı önermiyoruz. Disk GÇ işlemlerine eklediği ek yük nedeniyle uç nokta API'leri kullanılırken tahmin edilemeyen zaman aşımlarına neden olur.

Geçerli bölüm sayısı aşıldıktan sonra bir kapsayıcı oluşturmaya çalışırsanız öykünücü aşağıdaki iletiyle bir ServiceUnavailable özel durumu oluşturur.

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

Öykünücüde kullanılabilen kapsayıcı sayısını değiştirmek için aşağıdaki adımları çalıştırın:

1. Sistem tepsisinde öykünücü simgesine sağ tıklayıp Verileri Sıfırla... seçeneğine tıklayarak tüm yerel öykünücü verilerini silin.

2. Bu klasördeki %LOCALAPPDATA%\CosmosDBEmulatortüm öykünücü verilerini silin.

3. Sistem tepsisinde öykünücü simgesine sağ tıklayıp Çıkış'a tıklayarak tüm açık örneklerden çıkın. Tüm örneklerin çıkması bir dakika sürebilir.

4. Öykünücünün en son sürümünü yükleyin.

5. Bir değer <= 250 ayarlayarak PartitionCount bayrağıyla öykünücüyü başlatın. Örneğin: C:\Program Files\emulator> Microsoft.Azure.Cosmos.Emulator.exe /PartitionCount=100.

Sonraki adımlar

• Azure Cosmos DB öykünücüsü hakkında daha fazla bilgi edinin
• Öykünücünün sürüm notlarını gözden geçirin