Usando a 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.

Download e configuração da AWS CLI

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:

1. Acesse o Guia do usuário do AWS Command Line Interface.

2. Siga as instruções de Instalação da AWS CLI e Configuração da AWS CLI.

Como usar a AWS CLI com o DynamoDB

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

Usar a AWS CLI com o DynamoDB local

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.