O emulador do Azure Cosmos não é um serviço escalonável e não dará suporte a um grande número de contêineres.The Azure Cosmos Emulator is not a scalable service and will not support a large number of containers.

InstalaçãoInstallation

Você pode baixar e instalar o Emulador do Azure Cosmos no Centro de Download da Microsoft ou você pode executar o emulador no Docker CE for Windows.You can download and install the Azure Cosmos Emulator from the Microsoft Download Center or you can run the emulator on Docker for Windows.Para obter instruções sobre como usar o emulador no Docker for Windows, confira Em execução no Docker.For instructions on using the emulator on Docker for Windows, see Running on Docker.

Observação

Para instalar, configurar e executar o emulador do Azure Cosmos DB, você deve ter privilégios administrativos no computador.To install, configure, and run the Azure Cosmos Emulator, you must have administrative privileges on the computer.O emulador criará ou adicionará um certificado e também definirá as regras de firewall para executar seus serviços. Portanto, é necessário para o emulador ser capaz de executar essas operações.The emulator will create/add a certificate and also set the firewall rules in order to run its services; therefore it's necessary for the emulator to be able to execute such operations.

Iniciar o Data ExplorerStart Data Explorer

Quando o emulador do Azure Cosmos é iniciado, ele abre automaticamente o Data Explorer do Azure Cosmos no seu navegador.When the Azure Cosmos Emulator launches, it automatically opens the Azure Cosmos Data Explorer in your browser.O endereço é exibido como https://localhost:8081/_explorer/index.html.The address appears as https://localhost:8081/_explorer/index.html.Se você fechar o Explorer e quiser reabri-lo mais tarde, é possível abrir a URL no navegador ou iniciá-lo no Emulador do Azure Cosmos no Ícone de Bandeja do Windows, como mostrado abaixo.If you close the explorer and would like to reopen it later, you can either open the URL in your browser or launch it from the Azure Cosmos Emulator in the Windows Tray Icon as shown below.

Procurando atualizaçõesChecking for updates

O Data Explorer indica se há uma nova atualização disponível para download.Data Explorer indicates if there is a new update available for download.

Observação

Não há garantias de que os dados criados em uma versão do emulador do Azure Cosmos (consulte %LOCALAPPDATA%\CosmosDBEmulator ou configurações opcionais do caminho de dados) possam ser acessados em outras versões.Data created in one version of the Azure Cosmos Emulator (see %LOCALAPPDATA%\CosmosDBEmulator or data path optional settings) is not guaranteed to be accessible when using a different version.Se você precisar persistir seus dados por longo prazo, é recomendável armazená-los em uma conta do Azure Cosmos e não no Emulador do Azure Cosmos.If you need to persist your data for the long term, it is recommended that you store that data in an Azure Cosmos account, rather than in the Azure Cosmos Emulator.

Autenticar solicitaçõesAuthenticating requests

Assim como no Azure Cosmos DB na nuvem, cada solicitação feita no emulador do Azure Cosmos deve ser autenticada.As with Azure Cosmos DB in the cloud, every request that you make against the Azure Cosmos Emulator must be authenticated.O Emulador do Azure Cosmos dá suporte a uma única conta fixa e a uma chave de autenticação conhecida para autenticação de chave mestra.The Azure Cosmos Emulator supports a single fixed account and a well-known authentication key for master key authentication.Essa conta e a chave são as únicas credenciais permitidas para uso com o Emulador do Azure Cosmos.This account and key are the only credentials permitted for use with the Azure Cosmos Emulator.Eles são:They are:

Se você tiver iniciado o emulador com a opção /Key, use a chave gerada em vez de C2y6yDjf5/R+ob0N8A7Cgv30VRDJIWEHLM+4QDU5DE2nQ9nDuVTqobD4b8mGGyPMbIZnqyMsEcaGQy67XIw/Jw==.If you have started the emulator with the /Key option, then use the generated key instead of C2y6yDjf5/R+ob0N8A7Cgv30VRDJIWEHLM+4QDU5DE2nQ9nDuVTqobD4b8mGGyPMbIZnqyMsEcaGQy67XIw/Jw==.Para saber mais sobre a opção /Keym veja a referência da ferramenta da linha de comando.For more information about /Key option, see Command-line tool reference.

No local da instalação, você pode usar a linha de comando para iniciar e interromper o emulador, configurar opções e executar outras operações.From the installation location, you can use the command-line to start and stop the emulator, configure options, and perform other operations.

A chave de autorização de leitura do arquivo especificado.Read authorization key from the specified file.Use a opção de /GenKeyFile para gerar um keyfileUse the /GenKeyFile option to generate a keyfile

Gere uma nova chave de autorização e salve no arquivo especificado.Generate a new authorization key and save to the specified file.A chave gerada pode ser usada com as opções /Key ou /KeyFile.The generated key can be used with the /Key or /KeyFile options.

Se você tentar criar contêiner depois que a contagem de partição atual tiver sido excedida, o emulador lançará uma exceção de ServiceUnavailable, com a mensagem de erro a seguir.If you attempt to create a container after the current partition count has been exceeded, the emulator throws a ServiceUnavailable exception, with the following message.

Saia de todas as instâncias abertas clicando com o botão direito do mouse no ícone do Emulador do Azure Cosmos DB na bandeja do sistema e clicando em Sair.Exit all open instances by right-clicking the Azure Cosmos DB Emulator icon on the system tray, and then clicking Exit.Pode levar um minuto para que todas as instâncias saiam.It may take a minute for all instances to exit.

ou coloque o diretório PSModules no seu PSModulesPath e importe-o conforme mostrado no comando a seguir:or place the PSModules directory on your PSModulesPath and import it as shown in the following command:

Em execução no DockerRunning on Docker

O emulador do Azure Cosmos pode ser executado no Docker CE for Windows.The Azure Cosmos Emulator can be run on Docker for Windows.O emulador não funciona no Docker for Oracle Linux.The emulator does not work on Docker for Oracle Linux.

Fechar o shell interativo depois de o emulador ter sido iniciado desligará o contêiner do emulador.Closing the interactive shell once the emulator has been started will shut down the emulator's container.

Para abrir o Data Explorer, navegue até a URL a seguir no seu navegador.To open the Data Explorer, navigate to the following URL in your browser.O ponto de extremidade do emulador é fornecido na mensagem de resposta mostrada acima.The emulator endpoint is provided in the response message shown above.

Executar no Mac ou LinuxRunning on Mac or Linux

Atualmente, o emulador do Cosmos somente pode ser executado no Windows.Currently the Cosmos emulator can only be run on Windows.Os usuários do Mac ou do Linux podem executar o emulador em uma máquina virtual do Windows hospedada em um hipervisor, como o Parallels ou o VirtualBox.Users running Mac or Linux can run the emulator in a Windows virtual machine hosted a hypervisor such as Parallels or VirtualBox.Abaixo estão as etapas para habilitá-lo.Below are the steps to enable this.

Na VM do Windows, execute o comando a seguir e anote o endereço IPv4.Within the Windows VM run the command below and make note of the IPv4 address.

A próxima etapa, na VM do Windows, inicie o emulador do Cosmos na linha de comando usando as opções a seguir.The next step, from the within the Windows VM, launch the Cosmos emulator from the command line using the following options.

Microsoft.Azure.Cosmos.Emulator.exe /shutdown.Microsoft.Azure.Cosmos.Emulator.exe /shutdown.Confira a bandeja do sistema para ter certeza de que o programa foi desligado. Isso pode levar um minuto.Watch the system tray to make sure the program has shut down, it may take a minute.Você também pode simplesmente clicar em Sair na interface do usuário do emulador do Azure Cosmos.You can also just click Exit in the Azure Cosmos Emulator user interface.

Microsoft.Azure.Cosmos.Emulator.exe /startwprtraces

Microsoft.Azure.Cosmos.Emulator.exe

Reproduza o problema.Reproduce the problem.Se o Data Explorer não está funcionando, você só precisa aguardar que o navegador abra por alguns segundos para capturar o erro.If Data Explorer is not working, you only need to wait for the browser to open for a few seconds to catch the error.

Abra um tíquete de suporte no portal do Azure e inclua o arquivo .etl com as etapas de reprodução.Open a support ticket in the Azure portal and include the .etl file along with repro steps.

Desinstalar o emulador localUninstall the local emulator

Saia de todas as instâncias abertas do emulador local clicando com o botão direito do mouse no ícone do Emulador do Azure Cosmos na bandeja do sistema e clicando em Sair.Exit all open instances of the local emulator by right-clicking the Azure Cosmos Emulator icon on the system tray, and then clicking Exit.Pode levar um minuto para que todas as instâncias saiam.It may take a minute for all instances to exit.

Após a desinstalação do aplicativo, navegue até %LOCALAPPDATA%\CosmosDBEmulator e exclua a pasta.When the app is uninstalled, navigate to %LOCALAPPDATA%\CosmosDBEmulator and delete the folder.

Próximas etapasNext steps

Neste tutorial, você aprendeu como usar o emulador local para o desenvolvimento local gratuito.In this tutorial, you've learned how to use the local emulator for free local development.Agora, você pode seguir para o próximo tutorial e aprender a exportar certificados TLS/SSL do emulador.You can now proceed to the next tutorial and learn how to export emulator TLS/SSL certificates.