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:
Instale e configure a AWS CLI. Para obter mais informações, consulte Instalar ou atualizar para a versão mais recente da AWS CLI e Autenticação e credenciais de acesso.
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:
-
DynamoDB Local no Guia do desenvolvedor do Amazon DynamoDB
-
Como usar a AWS CLI com o DynamoDB Local no Guia do desenvolvedor do Amazon DynamoDB