Use o Amazon DynamoDB com o AWS CLI - AWS Command Line Interface
Pré-requisitosCriação e uso de tabelas do DynamoDBUso do DynamoDB LocalRecursos

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

Use o Amazon DynamoDB com o AWS CLI

Introdução ao Amazon DynamoDB

O AWS Command Line Interface (AWS CLI) fornece suporte para todos os serviços de AWS banco de dados, incluindo o Amazon DynamoDB. Você pode usar o AWS CLI para operações improvisadas, como criar uma tabela. Ela também pode ser usada para incorporar operações do DynamoDB em scripts utilitários.

Para obter mais informações sobre como usar o AWS CLI com o DynamoDB, dynamodb consulte na AWS CLI Referência de comandos.

Para listar os AWS CLI comandos do DynamoDB, use o comando a seguir.

$ aws dynamodb help

Pré-requisitos

Para executar os comandos dynamodb, você precisa:

Criação e uso de tabelas do DynamoDB

O formato da linha de comando consiste em um nome de comando do DynamoDB, seguido pelos parâmetros desse comando. O AWS CLI suporta a CLI sintaxe abreviada para os valores dos parâmetros e completa. JSON

O exemplo a seguir cria uma tabela chamada MusicCollection. 

$ aws dynamodb create-table \
    --table-name MusicCollection \
    --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

Adicione novas linhas à tabela com comandos semelhantes aos mostrados no exemplo a seguir. Esses exemplos usam uma combinação de sintaxe abreviada e. JSON

$ aws dynamodb put-item \
    --table-name MusicCollection \
    --item '{
        "Artist": {"S": "No One You Know"},
        "SongTitle": {"S": "Call Me Today"} ,
        "AlbumTitle": {"S": "Somewhat Famous"} 
      }' \
    --return-consumed-capacity TOTAL
{
    "ConsumedCapacity": {
        "CapacityUnits": 1.0,
        "TableName": "MusicCollection"
    }
}
$ aws dynamodb put-item \
    --table-name MusicCollection \
    --item '{ 
        "Artist": {"S": "Acme Band"}, 
        "SongTitle": {"S": "Happy Day"} , 
        "AlbumTitle": {"S": "Songs About Life"} 
      }' \
    --return-consumed-capacity TOTAL
{
    "ConsumedCapacity": {
        "CapacityUnits": 1.0,
        "TableName": "MusicCollection"
    }
}

Pode ser difícil compor um comando válido JSON em uma única linha de comando. Para facilitar isso, eles AWS CLI podem ler JSON arquivos. Por exemplo, considere o seguinte JSON trecho, que é armazenado em um arquivo chamado. expression-attributes.json

{
  ":v1": {"S": "No One You Know"},
  ":v2": {"S": "Call Me Today"}
}

Você pode usar esse arquivo para emitir uma solicitação query usando a AWS CLI. No exemplo a seguir, o conteúdo do arquivo expression-attributes.json é usado como o valor para o parâmetro --expression-attribute-values.

$ aws dynamodb query --table-name MusicCollection \
    --key-condition-expression "Artist = :v1 AND SongTitle = :v2" \
    --expression-attribute-values file://expression-attributes.json
{
    "Count": 1,
    "Items": [
        {
            "AlbumTitle": {
                "S": "Somewhat Famous"
            },
            "SongTitle": {
                "S": "Call Me Today"
            },
            "Artist": {
                "S": "No One You Know"
            }
        }
    ],
    "ScannedCount": 1,
    "ConsumedCapacity": null
}

Uso do DynamoDB Local

Além do DynamoDB, você pode usar o AWS CLI com o DynamoDB Local. O DynamoDB Local é um banco de dados e servidor pequeno no lado do cliente que copia o serviço do DynamoDB. O DynamoDB Local permite que você escreva aplicativos que usam o DynamoDB, sem manipular tabelas ou dados no serviço web do API DynamoDB. Em vez disso, todas as API ações são redirecionadas para um banco de dados local. Isso economiza a taxa de transferência provisionada, o armazenamento de dados e as taxas de transferência de dados.

Para obter mais informações sobre o DynamoDB Local e como usá-lo com AWS CLI o, consulte as seguintes seções do Amazon DynamoDB Developer Guide:

Recursos

AWS CLI referência:

Referência do serviço: