View a markdown version of this page

Trabalhar com o Amazon DocumentDB no Toolkit - AWS Toolkit for VS Code
Acessando o Amazon DocumentDB a partir do AWS Kit de ferramentasCriando 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

O Amazon DocumentDB (com compatibilidade com o MongoDB) é um serviço de banco de dados rápido, confiável e totalmente gerenciado que simplifica a configuração, a operação e a escalabilidade de bancos de dados na nuvem. MongoDB-compatible

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 AWS Kit de ferramentas

Para acessar o Amazon DocumentDB com o AWS kit de ferramentas, conclua o procedimento a seguir.

Acessando o Amazon DocumentDB no AWS Kit de ferramentas

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

  2. No AWS Toolkit, 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 do AWS Toolkit for Visual Studio Code, expanda o Amazon DocumentDB para exibir seus clusters do Amazon DocumentDB.

  2. Right-click o cluster do qual você deseja copiar os detalhes da conexão e, em seguida, 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 em seu cluster Amazon DocumentDB em seu navegador padrão, conclua o procedimento a seguir.

Abrindo seu cluster no AWS Console

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

  2. Right-click o cluster que você deseja visualizar no AWS console e, em seguida, escolha Abrir no navegador.

  3. O AWS console é aberto para o cluster Amazon DocumentDB em seu navegador 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 do AWS Toolkit for Visual Studio Code, expanda o Amazon DocumentDB para exibir seus clusters do Amazon DocumentDB.

  2. Right-click o 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 do 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 do AWS Toolkit for Visual Studio Code, expanda o Amazon DocumentDB para exibir seus clusters do Amazon DocumentDB.

  2. Right-click a instância do cluster que você deseja reinicializar e, em seguida, escolha Reiniciar 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 do AWS Toolkit for Visual Studio Code, expanda o Amazon DocumentDB para exibir seus clusters do Amazon DocumentDB.

  2. Right-click a instância do cluster que você deseja excluir e escolha Excluir para abrir a caixa de diálogo de confirmação delete-cluster-instance 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 do AWS Toolkit for Visual Studio Code, expanda o Amazon DocumentDB para exibir seus clusters do Amazon DocumentDB.

  2. Right-click o cluster para o qual você deseja visualizar as tags e, em seguida, escolha Tags... para abrir as tags para a your cluster name caixa de diálogo.

  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 do AWS Toolkit for Visual Studio Code, expanda o Amazon DocumentDB para exibir seus clusters do Amazon DocumentDB.

  2. Right-click o cluster ao qual você deseja adicionar tags e, em seguida, escolha Tags... para abrir as tags para a your cluster name caixa de 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 do AWS Toolkit for Visual Studio Code, expanda o Amazon DocumentDB para exibir seus clusters do Amazon DocumentDB.

  2. Right-click o cluster do qual você deseja remover as tags e, em seguida, escolha Tags... para abrir as tags para a your cluster name caixa de diálogo.

  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 do AWS Toolkit for Visual Studio Code, expanda o Amazon DocumentDB para exibir seus clusters do Amazon DocumentDB.

  2. Right-click a instância do cluster que você deseja modificar e, em seguida, 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.