Trabalhar com o Amazon DocumentDB no Toolkit - AWS Kit de ferramentas para VS Code
Acessando o Amazon DocumentDB a partir do kit de ferramentas AWSCriando um cluster baseado em instância.Copiando um endpoint de clusterAbrir no navegadorExpandindo um cluster já existenteInterromper um clusterReinicializar uma instânciaExcluir uma instânciaVisualização, adição e remoção de tagsModificar uma instância

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Trabalhar com o Amazon DocumentDB no Toolkit

Amazon DocumentDB (compatível com MongoDB) é um serviço de banco de dados confiável e gerenciado que pode ser usado para configurar, operar e escalar bancos de dados compatíveis com o MongoDB na nuvem.

Para obter informações detalhadas sobre o Amazon DocumentDB, informações básicas e tutoriais, consulte o Guia do desenvolvedor do Amazon DocumentDB.

As seções a seguir descrevem como trabalhar com objetos do Amazon DocumentDB por meio do AWS Toolkit for Visual Studio Code.

Acessando o Amazon DocumentDB a partir do kit de ferramentas AWS

Para acessar o Amazon DocumentDB com o AWS Toolkit, conclua o procedimento a seguir.

Acessando o Amazon DocumentDB no kit de ferramentas AWS

  1. No VS Code, abra AWS Toolkit for Visual Studio Code.

  2. No AWS Kit de ferramentas, expanda o Explorer.

  3. No Explorer, expanda o Amazon DocumentDB para exibir seus recursos existentes do Amazon DocumentDB.

Criando um cluster baseado em instância.

Para começar a trabalhar com o Amazon DocumentDB, crie um cluster concluindo o procedimento a seguir.

Criando um cluster baseado em instância

  1. Em AWS Toolkit for Visual Studio Code, abra o menu de contexto do Amazon DocumentDB (clique com o botão direito do mouse) e selecione Create Cluster para abrir a caixa de diálogo Create Amazon DocumentDB Cluster no VS Code.

  2. Em Tipo de cluster, escolha Cluster baseado em instância.

  3. Na tela Nome do cluster, especifique o nome do seu cluster.

  4. Na tela Selecionar versão do mecanismo, escolha sua versão preferida do mecanismo Amazon DocumentDB.

  5. Nas telas de nome de usuário e senha do administrador, especifique um nome de usuário e uma senha de administrador para proteger seu cluster.

  6. Na tela Especificar criptografia de armazenamento, escolha se deseja ou não criptografar seu cluster.

  7. Na tela Número de instâncias, configure seu número preferido de instâncias.

  8. Na tela Selecionar classe de instância, escolha sua classe de instância preferida e continue criando seu novo cluster.

    nota

    Vários minutos podem ser necessários para o cluster ser iniciado.

Copiando um endpoint de cluster

Para copiar o endpoint de cluster do Amazon DocumentDB, siga o procedimento a seguir.

Copiando um endpoint de cluster

  1. A partir de AWS Toolkit for Visual Studio Code, expanda o Amazon DocumentDB para exibir seus clusters do Amazon DocumentDB.

  2. Clique com o botão direito do mouse no cluster do qual você deseja copiar os detalhes da conexão e escolha Copiar endpoint para copiar as informações do endpoint do cluster para sua área de transferência.

  3. Seu endpoint de cluster agora pode ser colado em seus documentos.

Abrir no navegador

Abra seus clusters do Amazon DocumentDB no AWS console para obter mais recursos de gerenciamento de clusters. Para abrir o AWS console do seu cluster Amazon DocumentDB em seu navegador da web padrão, conclua o procedimento a seguir.

Abrindo seu cluster no AWS console

  1. A partir de AWS Toolkit for Visual Studio Code, expanda o Amazon DocumentDB para exibir seus clusters do Amazon DocumentDB.

  2. Clique com o botão direito do mouse no cluster que você deseja visualizar no AWS console e escolha Abrir no navegador.

  3. O AWS console se abre para o cluster Amazon DocumentDB em seu navegador da web padrão.

Expandindo um cluster já existente

Para escalar os clusters do Amazon DocumentDB adicionando instâncias, siga o procedimento a seguir.

Adicionar uma instância para expandir um cluster

  1. A partir de AWS Toolkit for Visual Studio Code, expanda o Amazon DocumentDB para exibir seus clusters do Amazon DocumentDB.

  2. Clique com o botão direito do mouse no cluster que você deseja expandir e escolha Adicionar uma instância para abrir a caixa de diálogo Adicionar uma instância no VS Code.

  3. Quando solicitado, insira um nome para sua nova instância no campo de texto e pressione a tecla Enter para continuar.

  4. Quando solicitado, selecione uma classe de instância na lista para continuar.

  5. O AWS Explorer exibe o status de criação e as atualizações quando a nova instância está pronta.

Interromper um cluster

Interrompa seu cluster Amazon DocumentDB concluindo o procedimento a seguir.

nota

Enquanto seu cluster estiver parado, a maioria dos recursos de gerenciamento de cluster não estará disponível.

Interrompendo o cluster do Amazon DocumentDB

  1. A partir de AWS Toolkit for Visual Studio Code, expanda o Amazon DocumentDB para exibir seus clusters do Amazon DocumentDB.

  2. Escolha o botão Parar Cluster localizado ao lado do cluster que você deseja interromper ou clique com o botão direito do mouse no cluster e escolha Parar Cluster.

  3. Quando solicitado, escolha Sim para interromper o cluster ou Cancelar para cancelar o processo de interrupção e deixar o cluster em execução.

  4. O AWS Explorer exibe o status do seu cluster e atualiza quando o cluster é interrompido.

Reinicializar uma instância

A reinicialização de uma instância é útil para solucionar problemas e fazer pequenas alterações sem afetar todo o cluster. Para reinicializar a instância do Amazon DocumentDB, siga o procedimento a seguir.

Reiniciando uma instância de cluster

  1. A partir de AWS Toolkit for Visual Studio Code, expanda o Amazon DocumentDB para exibir seus clusters do Amazon DocumentDB.

  2. Clique com o botão direito do mouse na instância do cluster que você deseja reinicializar e escolha Reinicializar instância.

  3. Quando solicitado, escolha Sim para reinicializar sua instância ou Cancelar para cancelar o processo de reinicialização e deixar sua instância parada.

  4. O AWS Explorer exibe o status do seu cluster e atualiza quando sua instância é reinicializada.

Excluir uma instância

O procedimento a seguir exclui uma instância de cluster do Amazon DocumentDB.

nota

Excluir uma instância não afeta os dados no cluster. Se você excluir a instância primária, uma das instâncias de réplica assume como instância gravável.

Excluir uma instância de cluster

  1. A partir de AWS Toolkit for Visual Studio Code, expanda o Amazon DocumentDB para exibir seus clusters do Amazon DocumentDB.

  2. Clique com o botão direito do mouse na instância do cluster que você deseja excluir e escolha Excluir para abrir a caixa de diálogo de delete-cluster-instance confirmação no VS Code.

  3. Siga o prompt de confirmação e pressione a tecla Enter para excluir sua instância de cluster.

  4. O AWS Explorer exibe o status da sua instância de cluster e atualiza quando sua instância é excluída.

Visualização, adição e remoção de tags

As tags são usadas para organizar e rastrear recursos em seu ambiente. Para visualizar ou editar tags associadas ao cluster do Amazon DocumentDB, siga um dos procedimentos a seguir.

Visualizar o status do cluster

  1. A partir de AWS Toolkit for Visual Studio Code, expanda o Amazon DocumentDB para exibir seus clusters do Amazon DocumentDB.

  2. Clique com o botão direito do mouse no cluster do qual você deseja visualizar as tags e escolha Tags para abrir as Tags para your cluster name.

  3. Suas tags são exibidas na janela de diálogo. Se nenhuma tag estiver associada ao seu cluster, a mensagem [Nenhuma tag atribuída] será exibida.

Adicionar tags a um cluster.

  1. A partir de AWS Toolkit for Visual Studio Code, expanda o Amazon DocumentDB para exibir seus clusters do Amazon DocumentDB.

  2. Clique com o botão direito do mouse no cluster ao qual você deseja adicionar tags e escolha Tags para abrir as Tags para your cluster name diálogo.

  3. Escolha a opção Adicionar tag para abrir a caixa de diálogo Adicionar tag no VS Code.

  4. Insira uma nova tag no campo de texto e pressione a tecla Enter para continuar.

  5. Insira um valor no campo de texto e pressione Enter para adicionar o key/value par ao seu cluster.

Remover tags de seu cluster

  1. A partir de AWS Toolkit for Visual Studio Code, expanda o Amazon DocumentDB para exibir seus clusters do Amazon DocumentDB.

  2. Clique com o botão direito do mouse no cluster do qual você deseja remover as tags e escolha Tags para abrir as Tags para your cluster name.

  3. Escolha a tag Remover para abrir a caixa de diálogo Remover uma tag do your cluster name no VS Code.

  4. Escolha a tag que você deseja remover da lista fornecida para remover a tag do seu cluster.

Modificar uma instância

Para modificar a classe de uma instância de cluster do Amazon DocumentDB, conclua o procedimento a seguir.

Modificar uma instância

  1. A partir de AWS Toolkit for Visual Studio Code, expanda o Amazon DocumentDB para exibir seus clusters do Amazon DocumentDB.

  2. Clique com o botão direito do mouse na instância do cluster que você deseja modificar e escolha Modificar classe para abrir a caixa de diálogo Selecionar classe de instância no VS Code.

  3. Escolha uma nova classe para sua instância na lista para atualizar a classe.

  4. O AWS Explorer exibe o status da sua instância de cluster e atualiza quando a classe da sua instância é atualizada.