Acessar o DynamoDB - Amazon DynamoDB

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.

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. Ela é executada no Windows, macOS ou Linux. Depois de fazer download da AWS CLI, siga estas etapas para instalá-la e configurá-la:

    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, JavaScript no navegador, .NET, Node.js, PHP, Python, Ruby, C++, Go, Android e iOS.

    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 obter mais informações, consulte Intervalos de endereços IP da AWS no Referência geral da AWS.

    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).