Acessar o DynamoDB
Você pode acessar o Amazon DynamoDB usando o AWS Management Console, a AWS Command Line Interface (AWS CLI) ou a API do DynamoDB.
Tópicos
Usar o console
Você pode acessar o AWS Management Console para Amazon DynamoDB em https://console.aws.amazon.com/dynamodb/home
Aqui estão algumas das ações que você pode realizar no console do DynamoDB:
-
Gerenciar tabelas: crie, atualize e exclua tabelas. A calculadora de capacidade pode ajudar a estimar os requisitos de capacidade.
-
Interagir com dados: visualize, adicione, atualize e exclua itens das tabelas. Gerencie as configurações de vida útil (TTL).
-
Monitorar e analisar: visualize painéis, monitore e configure alarmes e analise métricas e alertas das tabelas do DynamoDB.
-
Otimizar e ampliar: gerencie índices secundários, fluxos, acionadores, capacidade reservada e outros recursos avançados para aprimorar o uso do DynamoDB.
O console do DynamoDB fornece uma interface abrangente para gerenciar os recursos do DynamoDB. Recomendamos que você acesse o console e interaja com ele para saber mais.
Uso do AWS CLI
Você pode usar a AWS Command Line Interface (AWS CLI) para controlar vários serviços da AWS via linha de comando e automatizá-los usando scripts. Use o AWS CLI para operações ad hoc, como a criação de uma tabela. Ela também pode ser usada para incorporar operações do Amazon DynamoDB em scripts utilitários.
Antes de usar a AWS CLI com o DynamoDB, você deve obter um ID de chave de acesso e uma chave de acesso secreta. Para ter mais informações, consulte Conceder acesso programático .
Para obter uma lista completa de todos os comandos disponíveis para o DynamoDB na AWS CLI, consulte a Referência de comandos da AWS CLI.
Tópicos
O AWS CLI está disponível em http://aws.amazon.com/cli
-
Siga as instruções de Instalação da AWS CLI e Configuração da AWS CLI.
O formato de linha de comando consiste em um nome de operação do DynamoDB seguido pelos parâmetros dessa operação. O AWS CLI suporta uma sintaxe abreviada para os valores de parâmetro, assim como JSON.
Por exemplo, o comando a seguir cria uma tabela chamada Music. A chave de partição é Artist, e a chave de classificação é SongTitle. (Para facilitar a leitura, comandos longos nesta seção são divididos em linhas separadas.)
aws dynamodb create-table \ --table-name Music \ --attribute-definitions \ AttributeName=Artist,AttributeType=S \ AttributeName=SongTitle,AttributeType=S \ --key-schema AttributeName=Artist,KeyType=HASH AttributeName=SongTitle,KeyType=RANGE \ --provisioned-throughput ReadCapacityUnits=1,WriteCapacityUnits=1 \ --table-class STANDARD
Os comandos a seguir adicionam novos itens à tabela. Esses exemplos usam uma combinação de sintaxe abreviada e JSON.
aws dynamodb put-item \ --table-name Music \ --item \ '{"Artist": {"S": "No One You Know"}, "SongTitle": {"S": "Call Me Today"}, "AlbumTitle": {"S": "Somewhat Famous"}}' \ --return-consumed-capacity TOTAL aws dynamodb put-item \ --table-name Music \ --item '{ "Artist": {"S": "Acme Band"}, "SongTitle": {"S": "Happy Day"}, "AlbumTitle": {"S": "Songs About Life"} }' \ --return-consumed-capacity TOTAL
Na linha de comando, pode ser difícil compor um JSON válido. No entanto, a AWS CLI pode ler arquivos JSON. Por exemplo, considere o seguinte trecho de código JSON, que é armazenado em um arquivo chamado key-conditions.json.
{ "Artist": { "AttributeValueList": [ { "S": "No One You Know" } ], "ComparisonOperator": "EQ" }, "SongTitle": { "AttributeValueList": [ { "S": "Call Me Today" } ], "ComparisonOperator": "EQ" } }
Agora você pode emitir uma solicitação Query
usando a AWS CLI. Neste exemplo, o conteúdo do arquivo key-conditions.json é usado para o parâmetro --key-conditions
.
aws dynamodb query --table-name Music --key-conditions file://key-conditions.json
A AWS CLI também pode interagir com o DynamoDB local (versão para download) executado no computador. Para ativar isso, adicione o parâmetro a seguir em cada comando:
--endpoint-url http://localhost:8000
O exemplo a seguir usa a AWS CLI para listar as tabelas em um banco de dados local.
aws dynamodb list-tables --endpoint-url http://localhost:8000
Se o DynamoDB estiver usando um número de porta diferente do padrão (8000), modifique o valor --endpoint-url
de acordo com a necessidade.
nota
A AWS CLI não pode usar o DynamoDB local (versão para download) como um endpoint padrão. Portanto, você deve especificar --endpoint-url
com cada comando.
Uso da API
Você pode usar o AWS Management Console e a AWS Command Line Interface para trabalhar de forma interativa com o Amazon DynamoDB. No entanto, para aproveitar ao máximo o DynamoDB, você pode escrever o código da aplicação usando os AWS SDKs.
Os SDKs da AWS oferecem amplo suporte para o DynamoDB em Java
Antes de usar os AWS SDKs com o DynamoDB, você deve obter um ID de chave de acesso da AWS e uma chave de acesso secreta. Para ter mais informações, consulte Configurar o DynamoDB (serviço da Web) .
Para obter uma visão geral de alto nível da programação de aplicações do DynamoDB com AWS SDKs, consulte Programação com o DynamoDB e os AWS SDKs.
Usar o NoSQL Workbench para DynamoDB
Também é possível acessar o DynamoDB baixando e usando o NoSQL Workbench para DynamoDB.
O NoSQL Workbench para Amazon DynamoDB é uma aplicação GUI multiplataforma do lado do cliente para operações e desenvolvimento de bancos de dados modernos. Ele está disponível para Windows, macOS e Linux. O NoSQL Workbench é uma ferramenta de desenvolvimento visual que fornece recursos de modelagem de dados, visualização de dados e desenvolvimento de consultas para ajudar você a projetar, criar, consultar e gerenciar tabelas do DynamoDB. O NoSQL Workbench agora inclui o DynamoDB local como parte opcional do processo de instalação, o que facilita a modelagem de dados no DynamoDB local. Para saber mais sobre o DynamoDB local e seus requisitos, consulte Configurar o DynamoDB local (versão para download) .
nota
No momento, o NoSQL Workbench para DynamoDB não comporta logins da AWS configurados com a autenticação de dois fatores (2FA).
- Modelagem de dados
-
Com o NoSQL Workbench para DynamoDB, você pode criar novos modelos de dados a partir de ou projetar modelos com base em modelos de dados existentes que satisfaçam os padrões de acesso a dados das suas aplicações. Pode também importar e exportar o modelo de dados designado no final do processo. Para ter mais informações, consulte Criar modelos de dados com o NoSQL Workbench.
- Visualização de dados
-
O visualizador de modelo de dados oferece uma tela na qual você pode mapear consultas e visualizar os padrões de acesso (facetas) do aplicativo sem precisar escrever código. Cada faceta corresponde a um padrão de acesso diferente no DynamoDB. Você pode gerar dados de amostra automaticamente para uso no modelo de dados. Para ter mais informações, consulte Visualizar padrões de acesso a dados.
- Criação de operação
-
O NoSQL Workbench oferece uma avançada interface gráfica do usuário para você desenvolver e testar consultas. Você pode usar o criador de operações para visualizar, explorar e consultar conjuntos de dados dinâmicos. Você também pode usar o criador de operações estruturadas para criar e executar operações de plano de dados. Ele oferece suporte para expressões de projeção e condição e permite que você gere código de exemplo em várias linguagens. Para ter mais informações, consulte Explorar conjuntos de dados e criar operações com o NoSQL Workbench.
Intervalos de endereços IP
A Amazon Web Services (AWS) publica seus intervalos de endereços IP atuais em formato JSON. Para visualizar os intervalos atuais, faça download do arquivo ip-ranges.json
Para encontrar os intervalos de endereços IP que podem ser usados para acessar os índices e as tabelas do DynamoDB, procure no arquivo ip-ranges.json a seguinte string: "service": "DYNAMODB"
.
nota
Os intervalos de endereços IP não se aplicam ao DynamoDB Streams ou ao DynamoDB Accelerator (DAX).