Windows(로컬) 에뮬레이터에 대한 명령줄 및 PowerShell 참조

적용 대상: NoSQL MongoDB Cassandra Gremlin 테이블

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 cmdlet을 사용하여 에뮬레이터 관리

에뮬레이터는 서비스를 시작, 중지, 제거, 검색하고 상태를 검색할 수 있는 PowerShell 모듈과 함께 제공 됩니다. 다음 cmdlet을 실행하여 PowerShell 모듈을 사용합니다.

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

또는 다음 명령에 표시된 대로 디렉터리를 PSModulePath 배치 PSModules 하고 가져옵니다.

$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

에뮬레이터를 중지합니다. 기본적으로 이 명령은 에뮬레이터가 완전히 종료될 때까지 기다립니다. 에뮬레이터가 종료되는 즉시 cmdlet이 반환되도록 하려면 -NoWait 옵션을 사용합니다.

구문

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 SDK(소프트웨어 개발 키트)를 사용하여 지원됨) 또는 에뮬레이터를 사용하여 5개의 무제한 컨테이너를 만들 수 있습니다. PartitionCount 값을 수정하여 최대 250개의 고정 크기 컨테이너 또는 50개의 무제한 컨테이너 또는 고정 크기 컨테이너 250개를 초과하지 않는 두 컨테이너의 조합을 만들 수 있습니다(무제한 컨테이너 1개 = 고정 크기 컨테이너 5개). 그러나 200개 이상의 고정 크기 컨테이너를 사용하여 실행되도록 에뮬레이터를 설정하지 않는 것이 좋습니다. 디스크 IO 작업에 추가되는 오버헤드로 인해 엔드포인트 API를 사용할 때 예측할 수 없는 시간 제한이 발생합니다.

현재 파티션 수를 초과한 후 컨테이너를 만들려고 하면 에뮬레이터는 다음 메시지와 함께 ServiceUnavailable 예외를 throw합니다.

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. 시스템 트레이에서 에뮬레이터 아이콘을 마우스 오른쪽 단추로 클릭한 다음 끝내기를 클릭하여 열려 있는 모든 인스턴스를 종료합니다. 모든 인스턴스가 종료되는 데 1분 정도 걸릴 수 있습니다.

4. 최신 버전의 에뮬레이터를 설치합니다.

5. 250 이하의 값을 설정하여 PartitionCount 플래그로 에뮬레이터를 시작합니다. 예: C:\Program Files\emulator> Microsoft.Azure.Cosmos.Emulator.exe /PartitionCount=100

다음 단계

• Azure Cosmos DB 에뮬레이터에 대해 자세히 알아보기
• 에뮬레이터의 릴리스 정보 검토