Utilizzo di Amazon DynamoDB nella AWS CLI

AWS Command Line Interface (AWS CLI) fornisce supporto per tutti i servizi di database AWS, tra cui Amazon DynamoDB. Puoi utilizzare la AWS CLI per operazioni ad hoc, quali la creazione di tabelle. È possibile utilizzarla anche per incorporare operazioni DynamoDB all’interno di script di utilità.

Per ulteriori informazioni sull’utilizzo della AWS CLI con DynamoDB, consulta dynamodb in AWS CLI Command Reference.

Per elencare i comandi della AWS CLI per DynamoDB, utilizza il comando seguente.

$ aws dynamodb help

Prerequisiti

Per eseguire i comandi dynamodb, è necessario:

Creazione e utilizzo di tabelle DynamoDB

Il formato a riga di comando consiste in un nome di comando DynamoDB seguito dai parametri per tale comando. L'AWS CLI supporta la sintassi abbreviata della CLI per i valori dei parametri, oltre a JSON completo.

L'esempio seguente crea una tabella denominata 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

Puoi aggiungere nuove righe alla tabella con comandi simili a quelli mostrati nell'esempio seguente. In questi esempi viene utilizzata una combinazione di sintassi abbreviata 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"
    }
}

Può essere difficile comporre un JSON valido in un comando su una sola riga. Per semplificare l'operazione, l'AWS CLI può leggere i file JSON. Considera ad esempio il seguente frammento JSON, che viene memorizzato in un file denominato expression-attributes.json.

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

Puoi utilizzare questo file per inviare una richiesta query con l'AWS CLI. Nell'esempio seguente, il contenuto del file expression-attributes.json viene utilizzato come valore del parametro --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
}

Utilizzo di DynamoDB locale

Oltre che con DynamoDB, puoi utilizzare la AWS CLI con DynamoDB locale. DynamoDB locale è un piccolo database e server lato client che imita il servizio DynamoDB. DynamoDB locale consente di scrivere applicazioni che utilizzano l’API DynamoDB senza effettivamente manipolare tabelle o dati nel servizio web DynamoDB. Tutte le operazioni API vengono invece reinstradate a un database locale. In questo modo è possibile salvare il throughput assegnato, lo storage dei dati e le tariffe per il trasferimento dei dati.

Per ulteriori informazioni su DynamoDB locale e su come utilizzarlo con la AWS CLI, consulta le seguenti sezioni della Guida per sviluppatori di Amazon DynamoDB:

Risorse

Riferimento alla AWS CLI:

Riferimento al servizio: